Routes et contrôleurs Laravel 🛣️

Le rôle des routes

Les routes sont le point d'entrée de toute requête HTTP dans Laravel. Elles définissent :

• L'URL (/users, /posts/1)
• La méthode HTTP (GET, POST, PUT, DELETE)
• Le contrôleur et la méthode à appeler

💡 Les routes sont comme un standard téléphonique : elles reçoivent les appels (requêtes) et les dirigent vers le bon service (contrôleur).

Les fichiers de routes

Laravel organise les routes dans 4 fichiers sous routes/ :

⚠️ Pour une API, on utilise TOUJOURS routes/api.php. Les routes y sont automatiquement préfixées par /api et appliquent le middleware api.

Syntaxe des routes

Route simple avec closure

// routes/api.php
Route::get('/ping', function () {
    return response()->json(['message' => 'pong']);
});

Route avec contrôleur (recommandé ✅)

Route::get('/users', [UserController::class, 'index']);
Route::post('/users', [UserController::class, 'store']);
Route::get('/users/{id}', [UserController::class, 'show']);
Route::put('/users/{id}', [UserController::class, 'update']);
Route::delete('/users/{id}', [UserController::class, 'destroy']);

Paramètres dynamiques

Route::get('/users/{id}', [UserController::class, 'show']);
Route::get('/users/{id}/posts/{postId}', [UserController::class, 'showPost']);

Contraintes de validation

Route::get('/users/{id}', [UserController::class, 'show'])->where('id', '[0-9]+');

Les contrôleurs 🎯

Un contrôleur regroupe la logique métier liée à une ressource.

Création

php artisan make:controller UserController

Structure RESTful standard

class UserController extends Controller
{
    public function index()
    {
        // 👇 Retourne tous les utilisateurs en JSON
        return response()->json(User::all());
    }

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

    public function store(Request $request)
    {
        $user = User::create($request->validate([
            'name' => 'required|string',
            'email' => 'required|email|unique:users',
        ]));
        return response()->json($user, 201);
    }
}

Le cycle complet d'une requête API 🔄

1. 🌐 Requête — Le client envoie GET /api/users
2. 🛣️ Route — Laravel trouve Route::get('/users', [UserController::class, 'index'])
3. 🎯 Contrôleur — Laravel appelle UserController::index()
4. 🗄️ Eloquent — User::all() génère SELECT * FROM users
5. 📦 JSON — response()->json($users) convertit en JSON
6. 📨 Réponse — Laravel renvoie la réponse HTTP 200
7. ✅ Client — Le frontend reçoit les données

Client                 Laravel                 BDD
  │                      │                      │
  │── GET /api/users ───→│                      │
  │                      │── SELECT * FROM ────→│
  │                      │←────── résultats ────│
  │←──── JSON 200 ──────│                      │
  │                      │                      │

Bonnes pratiques ✅

1. Toujours utiliser des contrôleurs pour les routes qui font plus qu'un simple retour
2. Nommer les routes pour faciliter les liens : Route::get(...)->name('users.index')
3. Grouper les routes par préfixe : Route::prefix('admin')->group(...)
4. Valider les données dans le contrôleur avec $request->validate()
5. Retourner les bons codes HTTP : 200 (OK), 201 (créé), 404 (non trouvé), 422 (validation), 500 (erreur)
6. Utiliser findOrFail() plutôt que find() pour éviter les erreurs silencieuses

Pièges fréquents 🚨

Exercices pour toi 🎯

1. Pratique : Ajoute une route GET /api/posts qui pointe vers PostController@index. Crée le contrôleur avec Artisan.
2. REST : Écris les 5 routes REST pour une ressource products.
3. Validation : Ajoute une validation dans store() : name requis (string, max:255), price requis (numeric, min:0).
4. Paramètre : Crée une route GET /api/users/{id}/posts qui retourne les posts d'un utilisateur.
5. Défi : Ouvre le simulateur ci-dessous. Clique sur chaque étape du cycle requête → réponse pour visualiser le flux complet.