Organiser grâce aux contrôleurs

1. Déplacer le code des fonctions de rappel des routes

Les routes créées dans les chapitres précédents sont surchargées de code pour traiter les actions dans leurs fonctions de rappel. L’objectif est de les libérer de ce code pour obtenir un fichier de routes propre qui fait simplement le lien entre les URI de l’application et les actions à effectuer pour chacun de ces URI.

Le fichier des routes routes/web.php est ainsi allégé, et devient un index des différents URI avec leurs actions associées.

Exemple de fichier de routes sans fonction de rappel

Route::get('videos', [VideoController::class, 'index']); 
 
Route::get('videos/creer', [VideoController::class, 'create']); 
 
Route::post('videos/creer', [VideoController::class, 'store']); ...

1. Créer un contrôleur CRUD avec Artisan

Comme pour de nombreux autres éléments, Artisan, outil en ligne de commande fourni avec Laravel, permet de rapidement créer un fichier contenant la structure de base d’un contrôleur. Dans le cas où le contrôleur sera associé à un modèle de notre base de données, il est possible de le spécifier dès la création du contrôleur afin d’avoir les méthodes associées à la gestion du modèle en plus de la structure du contrôleur.

Créer un modèle puis son contrôleur associé

sail artisan make:model Product --migration 
 
sail artisan make:controller ProductController -model=Product  

Les contrôleurs sont créés dans le dossier app/Http/Controllers.

Contrôleur généré via Artisan App\Http\Controllers\ProductController

<?php 
 
namespace App\Http\Controllers; 
 
use App\Models\Product; 
use Illuminate\Http\Request; 
 
class ProductController extends Controller 
{ 
 
    /** 
     * Display a listing of the resource. 
     */ 
    public function index() 
    { 
 
        // 
 
    } 
 
    /** 
     * Show the form for creating a new resource. 
     */ 
    public function create() 
    { 
 
        // 
 
    } 
 
    /** 
     * Store a newly created resource in storage. 
     */ 
    public function store(Request $request) 
    { 
 
        // ...

1. Fonctionnement

Il est possible, grâce aux fonctions assistantes et au système de façades fourni par Laravel, d’accéder à de nombreux éléments dans les contrôleurs comme la requête de l’utilisateur, le cache, les sessions, etc.

Il est également possible d’injecter les dépendances directement dans les méthodes des contrôleurs, simplement en donnant l’indication d’un type connu par Laravel à un paramètre de la méthode représentant l’action.

Par exemple, pour récupérer une instance de la classe Illuminate\Http\Request, on peut passer à une méthode un premier paramètre $request préfixé par son type.

Affichage de l’URL dans une méthode de contrôleur

<?php 
 
namespace App\Http\Controllers; 
 
use Illuminate\Http\Request; 
 
class HomeController extends Controller 
{ 
 
    public function index(Request $request) 
    { 
 
        return 'URL de la page: ' . $request->url(); 
 
    } 
 
}  

2. Ordre des arguments

Comme indiqué précédemment, les paramètres des routes sont passés en arguments aux méthodes des contrôleurs.

Si une méthode d’un contrôleur attend à la fois un paramètre en provenance d’une route et utilise une dépendance (à la classe Illuminate\Http\Request par exemple), dans ce cas il faut d’abord indiquer à la méthode les dépendances et ensuite les paramètres de route.

L’exemple ci-dessous montre l’action qui met à jour un produit dans une base de données en fonction de son identifiant $product passé...