Come Creare un’API REST con Laravel in Meno di 30 Minuti

Le API REST sono fondamentali nel mondo moderno delle applicazioni web e mobile. In questo tutorial, ti guiderò passo dopo passo su come creare un’API REST con Laravel, uno dei framework PHP più potenti e popolari, in meno di 30 minuti, dall’installazione al testing finale.

---

1. Installazione di Laravel

Prima di tutto, dobbiamo installare Laravel. Se non lo hai già fatto, ecco come procedere:

1. Apri il terminale.
2. Assicurati di avere Composer installato. Se non ce l’hai, scaricalo qui.
3. Una volta installato Composer, esegui il seguente comando per creare un nuovo progetto Laravel:

composer create-project --prefer-dist laravel/laravel api-tutorial

4. Dopo che il progetto è stato creato, entra nella cartella del progetto:

cd api-tutorial

5. Avvia il server di sviluppo con:

php artisan serve

---

2. Creazione del Modello e della Migrazione

Ora che Laravel è installato, creiamo il nostro primo modello e la relativa migrazione. Questo ci permetterà di interagire con il database.

1. Crea un modello per una risorsa chiamata Post con il comando:

php artisan make:model Post -m

Il parametro -m crea automaticamente anche una migrazione.

2. Apri il file di migrazione appena creato in database/migrations/xxxx_xx_xx_create_posts_table.php e modifica lo schema della tabella:

Schema::create('posts', function (Blueprint $table) {
    $table->id();
    $table->string('title');
    $table->text('content');
    $table->timestamps();
});

3. Esegui la migrazione per creare la tabella posts nel database:

php artisan migrate

---

3. Creazione del Controller API

Ora creiamo un controller per gestire le richieste API.

1. Genera il controller API con il comando:

php artisan make:controller Api/PostController --resource

Questo comando crea un controller con le operazioni CRUD già pronte.

2. Nel file routes/api.php, aggiungi la route per la risorsa Post:

Route::apiResource('posts', App\Http\Controllers\Api\PostController::class);

---

4. Implementazione delle Funzionalità CRUD

Nel controller PostController, possiamo ora implementare le funzioni per creare, leggere, aggiornare e cancellare i post.

1. Apri il file app/Http/Controllers/Api/PostController.php e modifica le funzioni così:

use App\Models\Post;
use Illuminate\Http\Request;
class PostController extends Controller
{
    public function index()
    {
        return Post::all();
    }
    public function store(Request $request)
    {
        $post = Post::create($request->all());
        return response()->json($post, 201);
    }
    public function show($id)
    {
        return Post::findOrFail($id);
    }
    public function update(Request $request, $id)
    {
        $post = Post::findOrFail($id);
        $post->update($request->all());
        return response()->json($post, 200);
    }
    public function destroy($id)
    {
        Post::destroy($id);
        return response()->json(null, 204);
    }
}

2. Non dimenticare di aggiungere fillable al modello Post per permettere l’assegnazione di massa:

protected $fillable = ['title', 'content'];

---

5. Testing dell’API

Per testare l’API, puoi usare uno strumento come Postman o inviare richieste via cURL.

Esempi di chiamate API:

GET: Ottieni tutti i post

GET http://localhost:8000/api/posts

POST: Crea un nuovo post

POST http://localhost:8000/api/posts
Content-Type: application/json
{
    "title": "Titolo di esempio",
    "content": "Contenuto di esempio"
}

PUT: Aggiorna un post esistente

PUT http://localhost:8000/api/posts/1
Content-Type: application/json
{
    "title": "Titolo aggiornato",
    "content": "Contenuto aggiornato"
}

DELETE: Elimina un post

DELETE http://localhost:8000/api/posts/1

---

Conclusione

In meno di 30 minuti, abbiamo creato un’API REST funzionante utilizzando Laravel. Hai visto come è semplice implementare tutte le operazioni CRUD e testare le chiamate API. Laravel rende tutto estremamente intuitivo e ti permette di concentrarti sulle funzionalità del tuo progetto.

Hai domande o vuoi aggiungere qualche funzionalità extra? Lascia un commento qui sotto!