0Pricing
PHP Academy · Lezione

Route API e controller di risorse

Registrare route RESTful e generare controller di risorse con Artisan.

Route API e controller di risorse è una lezione PHP Academy gratuita su CoddyKit. Questa è la lezione 1 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento PHP Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso PHP Academy include 4 lezioni in totale.

Route API in Laravel

Definisca le route API in routes/api.php. Queste route ricevono automaticamente il prefisso /api e utilizzano il gruppo di middleware api (senza stato: nessuna sessione o cookie).

Route API di base

Restituisca JSON da una closure.

<?php
Route::get("/users/{id}", function (int $id) {
    $user = User::findOrFail($id);
    return response()->json($user);
});

Route per risorse API

Route::apiResource() registra 5 route RESTful (saltando create e edit, che visualizzano i moduli).

<?php
// routes/api.php
use App\Http\Controllers\Api\UserController;

Route::apiResource("users", UserController::class);
// GET /api/users           → index
// POST /api/users          → store
// GET /api/users/{user}    → show
// PUT /api/users/{user}    → update
// DELETE /api/users/{user} → destroy

Generazione di un controller API

Utilizzi il flag --api per generare un controller senza i metodi create e edit.

$ php artisan make:controller Api/UserController --api --model=User

Esempio di controller API

Un controller API restituisce risposte JSON.

<?php
namespace App\Http\Controllers\Api;

class UserController extends Controller
{
    public function index(): JsonResponse
    {
        return response()->json(User::paginate(15));
    }

    public function show(User $user): JsonResponse
    {
        return response()->json($user);
    }

    public function store(StoreUserRequest $request): JsonResponse
    {
        $user = User::create($request->validated());
        return response()->json($user, 201);
    }

    public function destroy(User $user): JsonResponse
    {
        $user->delete();
        return response()->json(null, 204);
    }
}

Codici di stato HTTP

Restituisca codici di stato appropriati: 200 (OK), 201 (Creato), 204 (Nessun contenuto), 400 (Richiesta non valida), 401 (Non autorizzato), 403 (Vietato), 404 (Non trovato), 422 (Entità non elaborabile).

Convalida con Form Request

Utilizzi le Form Request per definire regole di convalida chiare e riutilizzabili.

$ php artisan make:request StoreUserRequest

Esempio di StoreUserRequest

Definisca le regole e l'autorizzazione nella classe della richiesta.

<?php
class StoreUserRequest extends FormRequest
{
    public function authorize(): bool { return true; }
    public function rules(): array {
        return [
            "name"  => "required|string|max:255",
            "email" => "required|email|unique:users",
        ];
    }
}

Route API raggruppate

Raggruppi le route API con prefisso e namespace.

<?php
Route::prefix("v1")->middleware("auth:sanctum")->group(function () {
    Route::apiResource("posts", PostController::class);
    Route::apiResource("users", UserController::class);
});

except() e only()

Escluda o limiti route specifiche dalla registrazione di una risorsa.

<?php
Route::apiResource("users", UserController::class)->only(["index", "show"]);
Route::apiResource("posts", PostController::class)->except(["destroy"]);

Risorse annidate

Registri route di risorse annidate per i modelli correlati.

<?php
Route::apiResource("users.posts", UserPostController::class);
// GET /api/users/{user}/posts/{post}

Riepilogo

Utilizzi Route::apiResource() per le route API RESTful in routes/api.php. Generi i controller con --api. Restituisca JSON con codici di stato HTTP appropriati. Esegua la convalida con le Form Request.

Verifica rapida

Quante route registra apiResource()?

Domande Frequenti

La lezione «Route API e controller di risorse» è gratuita?

Sì — il testo completo di «Route API e controller di risorse» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso PHP Academy, passa a CoddyKit PRO. Il corso PHP Academy include 4 lezioni in totale.

Cosa imparerò in «Route API e controller di risorse»?

Registrare route RESTful e generare controller di risorse con Artisan. Eserciti PHP Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare PHP Academy?

Non è richiesta alcuna esperienza precedente. PHP Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 1 di 4.

Quanto tempo richiede la lezione «Route API e controller di risorse»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione PHP Academy?

Sì. Ogni lezione PHP Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

  1. Route API e controller di risorse
  2. Risorse API e risposte JSON
  3. Autenticazione con Laravel Sanctum
  4. Limitazione della frequenza e versionamento delle API
← Torna a PHP Academy