PHP Academy · Leçon

Contrôleurs et actions

Créer des contrôleurs avec artisan et gérer les requêtes dans des méthodes d’action.

Contrôleurs et actions est une leçon PHP Academy gratuite sur CoddyKit. Ceci est la leçon 3 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage PHP Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours PHP Academy comprend 4 leçons au total.

Qu’est-ce qu’un contrôleur ?

Un contrôleur regroupe la logique associée au traitement des requêtes. Au lieu d’utiliser des fermetures dans les fichiers de routes, vous déléguez ce traitement aux méthodes de contrôleur (actions).

Générer un contrôleur

Utilisez Artisan pour créer la structure de base d’un contrôleur.

$ php artisan make:controller UserController
$ php artisan make:controller PostController --resource

Contrôleur de base

Un contrôleur étend Controller et possède des méthodes publiques pour chaque action de route.

<?php
namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Models\User;

class UserController extends Controller
{
    public function index(): \Illuminate\View\View
    {
        $users = User::all();
        return view("users.index", compact("users"));
    }
}

Accéder à la requête

Indiquez Illuminate\Http\Request dans la signature de type de la méthode d’action — Laravel l’injecte automatiquement.

<?php
public function store(Request $request): \Illuminate\Http\RedirectResponse
{
    $name  = $request->input("name");
    $email = $request->input("email");
    User::create(["name" => $name, "email" => $email]);
    return redirect()->route("users.index");
}

Validation de formulaire

Utilisez $request->validate() pour valider les données saisies. En cas d’échec, Laravel redirige automatiquement vers la page précédente avec les erreurs.

<?php
public function store(Request $request): \Illuminate\Http\RedirectResponse
{
    $validated = $request->validate([
        "name"  => "required|string|max:255",
        "email" => "required|email|unique:users",
    ]);
    User::create($validated);
    return redirect()->route("users.index");
}

Méthodes d’un contrôleur de ressources

Un contrôleur de ressources possède 7 méthodes conventionnelles : index, create, store, show, edit, update, destroy.

Contrôleurs à action unique

Les contrôleurs invocables possèdent une seule méthode __invoke() — ils sont idéaux pour les actions qui font exactement une seule chose.

<?php
class SendWelcomeEmail extends Controller
{
    public function __invoke(User $user): void
    {
        Mail::to($user)->send(new WelcomeMail($user));
    }
}
// Route:
Route::post("/users/{user}/welcome", SendWelcomeEmail::class);

Intergiciel des contrôleurs

Appliquez un intergiciel à des actions spécifiques en utilisant la méthode middleware() dans le constructeur.

<?php
public function __construct()
{
    $this->middleware("auth")->except(["index", "show"]);
}

Injection de dépendances

Indiquez les services dans la signature de type des paramètres de la méthode d’action — Laravel les résout à partir du conteneur de services.

<?php
public function store(Request $request, Mailer $mailer): JsonResponse
{
    // $mailer is auto-injected
}

Retourner des réponses

Les contrôleurs peuvent retourner : des vues, des redirections, des réponses JSON et des téléchargements de fichiers.

<?php
return view("users.show", compact("user"));
return redirect()->back()->with("status", "Saved!");
return response()->json($user);
return response()->download(storage_path("report.pdf"));

Espace de noms des contrôleurs

Par défaut, tous les contrôleurs se trouvent dans App\Http\Controllers. Les sous-répertoires créent des sous-espaces de noms : App\Http\Controllers\Admin\UserController.

Garder des contrôleurs concis

Les contrôleurs doivent déléguer la logique métier aux classes de service ou aux actions. Visez des contrôleurs qui se limitent à : valider les données saisies, appeler un service et retourner une réponse.

Résumé

Générez des contrôleurs avec Artisan. Indiquez Request et les services dans les signatures de type pour permettre l’injection automatique. Utilisez validate() pour valider les données saisies. Gardez des contrôleurs concis — déléguez le traitement aux services.

Vérification rapide

Quelle commande Artisan génère un contrôleur de ressources ?

Questions Fréquemment Posées

La leçon « Contrôleurs et actions » est-elle gratuite ?

Oui — le texte complet de « Contrôleurs et actions » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours PHP Academy, passe à CoddyKit PRO. Le cours PHP Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Contrôleurs et actions » ?

Créer des contrôleurs avec artisan et gérer les requêtes dans des méthodes d’action. Tu pratiques PHP Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer PHP Academy ?

Aucune expérience préalable n'est requise. PHP Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 3 sur 4.

Combien de temps prend la leçon « Contrôleurs et actions » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon PHP Academy ?

Oui. Chaque leçon PHP Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

← Retour à PHP Academy