Etape 2 : Routes pour lister, afficher et créer des notes

Le rôle crucial du routage dans une application Laravel

Maintenant que notre modèle Note et la structure de la table notes sont en place grâce à la migration, l'étape suivante consiste à définir comment les utilisateurs pourront interagir avec notre application. C'est ici qu intervient le système de routage de Laravel. Les routes sont essentiellement des points d'entrée dans votre application. Elles définissent les URLs que les utilisateurs peuvent visiter et spécifient quelle logique (généralement une méthode dans un contrôleur) doit être exécutée lorsque cette URL est sollicitée.

Dans Laravel, la majorité des routes pour votre application web sont définies dans le fichier routes/web.php. Chaque route est associée à une méthode HTTP (comme GET, POST, PUT, DELETE, etc.) et à une URI (la partie de l'URL après le nom de domaine). Pour notre mini-gestionnaire de notes, nous aurons besoin de routes pour permettre de lister toutes les notes, d'afficher une note spécifique et de créer une nouvelle note (ce qui impliquera une route pour afficher le formulaire et une autre pour traiter sa soumission).

Comprendre le routage est fondamental car il connecte les requêtes des utilisateurs aux fonctionnalités de votre application. Laravel offre un système de routage flexible et expressif qui rend cette tâche à la fois simple et puissante. Nous allons maintenant définir les routes nécessaires pour notre projet, en anticipant les méthodes de contrôleur que nous créerons à l'étape suivante.

Route pour lister l'ensemble des notes

La première fonctionnalité que nous souhaitons implémenter est l'affichage de toutes les notes. Pour cela, nous avons besoin d'une route qui, lorsqu'un utilisateur accède à une certaine URL (par exemple, /notes), exécute une action pour récupérer toutes les notes et les afficher. Cette action sera généralement une requête de type GET.

Ouvrons le fichier routes/web.php. Par défaut, il contient une route d'exemple. Nous allons ajouter notre première route pour les notes. Pour l'instant, nous allons définir la logique directement dans une fonction de rappel (closure) pour simplifier, mais plus tard, nous lierons ces routes à des méthodes de contrôleurs.

use Illuminate\Support\Facades\Route;

// Route existante (page d'accueil)
Route::get('/', function () {
    return view('welcome');
});

// Notre nouvelle route pour lister les notes
Route::get('/notes', function () {
    // Logique pour récupérer et afficher toutes les notes (sera déplacée dans un contrôleur)
    return '<h1>Liste de toutes les notes</h1>'; // Placeholder temporaire
});

Dans cet exemple, Route::get('/notes', ...); définit une nouvelle route qui répond aux requêtes HTTP GET sur l'URI /notes. La fonction anonyme passée en second argument est ce qui sera exécuté. Pour le moment, elle retourne simplement une chaîne de caractères HTML. Plus tard, cette fonction sera remplacée par un appel à une méthode de notre NoteController, par exemple [NoteController::class, 'index'].

Route pour afficher une note spécifique (avec paramètre)

Ensuite, nous avons besoin d'une route pour afficher les détails d'une note unique. Cette route devra accepter un identifiant (ID) de la note comme partie de l'URL, par exemple /notes/1 pour afficher la note avec l'ID 1. C'est ce qu'on appelle un paramètre de route.

Nous définissons cela en utilisant des accolades dans l'URI de la route. Ajoutons cette route dans routes/web.php :

// ... (routes précédentes)

// Route pour afficher une note spécifique
Route::get('/notes/{id}', function ($id) {
    // Logique pour récupérer et afficher la note avec l'ID $id
    return '<h1>Détail de la note N° ' . $id . '</h1>'; // Placeholder temporaire
});

Ici, {id} est un segment dynamique de l'URI. La valeur capturée dans ce segment sera automatiquement injectée comme argument ($id) dans notre fonction de rappel. Nous utiliserons cet $id pour interroger la base de données et récupérer la note correspondante. Il est possible d'ajouter des contraintes sur les paramètres de route (par exemple, s'assurer que id est un nombre) en utilisant la méthode where sur la définition de la route, comme ->where('id', '[0-9]+').

L'ordre de définition des routes est important. Si vous aviez une route /notes/creer définie APRES /notes/{id}, Laravel interpréterait 'creer' comme un ID. Il est donc préférable de définir les routes spécifiques (comme /notes/creer) avant les routes génériques avec des paramètres (comme /notes/{id}).

Routes pour la création d'une nouvelle note

La création d'une nouvelle note implique généralement deux interactions et donc deux routes :

• Une route pour afficher le formulaire de création (requête GET).
• Une route pour traiter les données soumises par ce formulaire (requête POST).

Commençons par la route pour afficher le formulaire. Nous la placerons avant la route /notes/{id} pour éviter les conflits d'interprétation :

// ... (route pour la page d'accueil)

// Route pour afficher le formulaire de création de note
Route::get('/notes/creer', function () {
    // Logique pour afficher le formulaire
    return '<h1>Formulaire de création d’une nouvelle note</h1>'; // Placeholder
});

// Route pour lister les notes
Route::get('/notes', function () {
    return '<h1>Liste de toutes les notes</h1>';
});

// Route pour afficher une note spécifique
Route::get('/notes/{id}', function ($id) {
    return '<h1>Détail de la note N° ' . $id . '</h1>';
})->where('id', '[0-9]+'); // Ajout d'une contrainte pour que l'ID soit numérique

Ensuite, nous avons besoin d'une route pour gérer la soumission du formulaire. Cette route répondra à une requête POST, généralement sur la même URI que celle utilisée pour lister les ressources (/notes dans ce cas, suivant les conventions RESTful) ou une URI dédiée comme /notes/sauvegarder.

// ... (autres routes)

// Route pour traiter la soumission du formulaire de création (POST)
Route::post('/notes', function () {
    // Logique pour valider les données et sauvegarder la nouvelle note
    // Redirection après succès
    return '<h2>Note créée avec succès (simulation)</h2>'; // Placeholder
});

Cette route Route::post('/notes', ...); sera appelée lorsque le formulaire de création sera soumis. La fonction associée recevra les données du formulaire, les validera, puis créera une nouvelle note en base de données. Pour le moment, nous utilisons des retours simples, mais à terme, ces routes appelleront les méthodes create (pour le formulaire GET) et store (pour la soumission POST) de notre NoteController.

Nommer les routes pour une meilleure maintenabilité

Il est fortement recommandé de nommer vos routes. Les routes nommées permettent de générer facilement des URLs ou des redirections vers des routes spécifiques sans avoir à coder en dur les URIs. Si l'URI d'une route change, vous n'aurez qu'à mettre à jour sa définition, et toutes les générations d'URL utilisant son nom seront automatiquement mises à jour.

On nomme une route en utilisant la méthode name() après sa définition. Voici comment nous pourrions nommer nos routes :

use Illuminate\Support\Facades\Route;

Route::get('/', function () {
    return view('welcome');
});

// Groupe de routes pour les notes, qui seront bientôt gérées par NoteController
// Route::get('/notes', [NoteController::class, 'index'])->name('notes.index');
// Route::get('/notes/creer', [NoteController::class, 'create'])->name('notes.create');
// Route::post('/notes', [NoteController::class, 'store'])->name('notes.store');
// Route::get('/notes/{id}', [NoteController::class, 'show'])->name('notes.show')->where('id', '[0-9]+');

// Pour l'instant, avec les closures :
Route::get('/notes', function () { return '<h1>Liste de toutes les notes</h1>'; })->name('notes.index');
Route::get('/notes/creer', function () { return '<h1>Formulaire de création</h1>'; })->name('notes.create');
Route::post('/notes', function () { return '<h2>Note créée (simulation)</h2>'; })->name('notes.store');
Route::get('/notes/{note}', function ($note) { return '<h1>Détail de la note N° ' . $note . '</h1>'; })->name('notes.show')->where('note', '[0-9]+');

// Note: J'ai changé {id} en {note} pour la route show pour une meilleure sémantique,
// Laravel peut faire du "Route Model Binding" si le nom du paramètre correspond au modèle.

Les noms suivent souvent la convention resource.action (par exemple, notes.index, notes.create, notes.store, notes.show). Plus tard, nous pourrons générer une URL pour la liste des notes en utilisant route('notes.index') dans nos vues Blade ou contrôleurs. C'est beaucoup plus robuste que d'utiliser url('/notes').

A ce stade, nous avons défini les points d'entrée URL pour les fonctionnalités principales de notre gestionnaire de notes. La prochaine étape sera de créer le contrôleur qui contiendra la logique métier pour ces routes.