Module 1Découvrir le framework PHP Laravel
Chapitre 1 sur 17
Frameworks PHP, Composer, architecture MVC, atouts et versions de Laravel, rappels de PHP objet moderne.
Objectifs
Avec ce chapitre, tu sauras…
Leçon 1
Au module M107, tu as écrit des pages PHP « à la main » : un fichier par page, une connexion PDO copiée partout, des requêtes SQL au milieu du HTML. Ça marche pour un petit site. Pour une vraie application, ce code devient vite difficile à faire évoluer, à sécuriser et à partager dans une équipe.
La différence avec une bibliothèque (module M109) : avec une bibliothèque, ton code appelle la bibliothèque quand il en a besoin. Avec un framework, le framework appelle ton code au bon moment : il reçoit la requête, choisit la route, puis exécute ton contrôleur. C'est l'inversion de contrôle.
Tableau: Pourquoi utiliser un framework ?
| Raison | Ce que ça change concrètement |
|---|---|
| rapidité | pas besoin de réécrire l'authentification, la pagination ou la validation : quelques lignes suffisent |
| organisation | chaque chose a sa place (modèles, vues, contrôleurs, routes) ; un nouveau développeur s'y retrouve tout de suite |
| maintenabilité | le code est découpé et testable ; une évolution touche un seul endroit |
| sécurité | les protections contre l'injection SQL, le XSS et le CSRF (module M108) sont actives par défaut |
| communauté | documentation, tutoriels, paquets prêts à l'emploi, réponses aux questions courantes |
| Framework | Points forts | ORM / gabarits |
|---|---|---|
| Laravel (2011, Taylor Otwell) | le plus populaire ; syntaxe expressive ; écosystème très riche ; excellente documentation | Eloquent / Blade |
| Symfony (2005, SensioLabs) | robuste, modulaire, très utilisé en entreprise ; ses composants sont réutilisés par d'autres projets, dont Laravel et Drupal | Doctrine / Twig |
| Laminas (ex-Zend Framework) | orienté objet strict, adapté aux grandes applications d'entreprise ; plus difficile à prendre en main | Laminas\Db / PHP |
| Yii (« Yes, It Is! ») | rapide à installer ; générateur de code Gii | ActiveRecord / PHP |
Leçon 2
| Commande | Effet |
|---|---|
composer create-project laravel/laravel kitab | crée un nouveau projet à partir du squelette Laravel |
composer require carbon/carbon | ajoute une bibliothèque au projet (et à composer.json) |
composer require --dev pestphp/pest | ajoute une bibliothèque utile seulement en développement |
composer install | installe les versions exactes notées dans composer.lock (après un git clone) |
Leçon 3
| Rôle MVC | Dans Laravel | Dossier |
|---|---|---|
| Modèle | classes Eloquent (Livre, Categorie) | app/Models |
| Vue | gabarits Blade (.blade.php) | resources/views |
| Contrôleur | classes contrôleurs (LivreController) | app/Http/Controllers |
Leçon 4
| Atout | Ce que Laravel fournit |
|---|---|
| sécurité | requêtes préparées (contre l'injection SQL), échappement automatique dans Blade (contre le XSS), protection CSRF, hachage des mots de passe, chiffrement des cookies |
| ORM Eloquent | une classe par table, des relations ($livre->auteurs) en une ligne |
| Blade | un moteur de gabarits simple, avec layouts et composants |
| Artisan | une interface en ligne de commande qui génère le code (make:model, make:controller) et gère l'application |
| migrations |
Leçon 5
| Notion | Exemple | Où Laravel l'utilise |
|---|---|---|
| déclarations de types | function show(string $slug): View | partout : paramètres, retours |
méthode statique :: | Livre::find(1), Route::get(…) | modèles, façades |
| fonction anonyme (closure) | function () { return 'ok'; } | routes, middlewares, requêtes |
Leçon 6
Vidéo · À regarder
EN30 Days to Learn Laravel - Complete 8 Hour Course
Laracasts (Jeffrey Way) · YouTube
Vidéo · À regarder
EN30 Days to Learn Laravel - Complete 8 Hour Course
Laracasts (Jeffrey Way) · YouTube
1Avec un framework, qui appelle le code de l'application ?
2Dans MVC, la partie qui dialogue avec la base de données est…
3Composer installe les dépendances dans le dossier…
4Le fichier qui note les versions exactes installées est…
5La contrainte ^13.0 accepte la version…
6Le moteur de gabarits de Laravel s'appelle…
7Laravel 13 exige au minimum…
8Route::get() est un appel à…
L'essentiel du chapitre
composer.json = souhaits, composer.lock = versions exactes, vendor/ non versionné) ; Packagist est le dépôt public.use, ::class, promotion des propriétés, types, closures et fn, ?->, arguments nommés, interfaces, traits, enums, attributs ; une façade donne un accès statique à un service.| CodeIgniter | très léger, simple, peu de configuration | Query Builder / PHP |
| CakePHP | conventions fortes, génération de code (scaffolding) | ORM CakePHP / PHP |
composer update | met à jour les bibliothèques dans les limites de composer.json |
composer dump-autoload | régénère l'autoloader |
| (aiguillage) | routes | routes/web.php |
| la structure de la base décrite en PHP et versionnée dans Git |
| authentification | des kits de démarrage officiels (inscription, connexion, mot de passe oublié, double authentification) |
| tests | PHPUnit et Pest intégrés, avec des outils pour simuler des requêtes |
| services | e-mails, files d'attente (queues), tâches planifiées, notifications, stockage de fichiers, cache, traduction |
| écosystème | Herd (environnement local), Livewire et Inertia (interfaces dynamiques), Sanctum (API), Socialite (connexion avec Google, GitHub…), Laravel Cloud et Forge (hébergement) |
| communauté | documentation de référence, Laracasts (vidéos), des milliers de paquets |
| Version | PHP | Sortie | Sécurité jusqu'au |
|---|---|---|---|
| 10 | 8.1 – 8.3 | février 2023 | février 2025 (terminé) |
| 11 | 8.2 – 8.4 | mars 2024 | mars 2026 (terminé) |
| 12 | 8.2 – 8.5 | février 2025 | 24 février 2027 |
| 13 | 8.3 – 8.5 | 17 mars 2026 | 17 mars 2028 |
fn ($l) => $l->prix |
| collections, requêtes |
opérateur nullsafe ?-> | $request->user()?->name | quand une valeur peut être null |
| arguments nommés | trustProxies(at: '*') | configuration dans bootstrap/app.php |
| interface | class UserController implements HasMiddleware | contrats du framework |
| trait | use HasFactory, Notifiable; dans un modèle | ajouter des méthodes à une classe |
| énumération (PHP 8.1) | enum Statut: string { case Payee = 'payee'; } | casts, validation, routes |
| attribut (PHP 8.0) | #[Middleware('auth')] | configuration déclarative (Laravel 13) |
Pour chacun des trois projets, propose un framework PHP et justifie avec deux critères : (1) une petite API de 5 routes pour un club sportif, hébergée sur un serveur modeste ; (2) le site de vente en ligne Kitab, avec une équipe de quatre stagiaires formés à PHP ; (3) le système d'information d'une banque, avec une équipe de 40 développeurs et des exigences d'architecture strictes.
Les critères de choix d'un framework PHP
Tableau: Les principaux frameworks PHP
Le résumé écrit « Symphony » : le nom est Symfony. Il présente aussi Laravel avec l'outil Mix pour compiler le CSS et le JavaScript : depuis Laravel 9.19 (2022), c'est Vite qui remplit ce rôle. Enfin, le chiffre de « plus de 15 000 paquets » sur Packalyst est ancien ; retiens simplement que l'écosystème Laravel compte des milliers de paquets.
Un framework moderne n'est pas un seul gros fichier : Laravel est un assemblage de plusieurs dizaines de bibliothèques (dont de nombreux composants Symfony). Il faut un outil pour les télécharger, gérer leurs versions et les charger automatiquement.
Composer est le gestionnaire de dépendances de PHP. Dans le fichier composer.json, tu déclares les bibliothèques dont ton projet a besoin. Composer les télécharge dans le dossier vendor/ et génère un autoloader : tes classes et celles des bibliothèques se chargent automatiquement, sans require. Packagist (packagist.org) est le dépôt public où Composer trouve les paquets. C'est l'équivalent de npm pour JavaScript (module M105).
MVC (Modèle – Vue – Contrôleur) est un patron d'architecture qui sépare le code en trois rôles, rangés dans des fichiers distincts :
Le trajet d'une requête : le contrôleur reçoit la requête de l'utilisateur ; il demande au modèle d'effectuer des actions (lire des informations dans la base) et de lui renvoyer le résultat ; il transmet ce résultat à la vue ; il renvoie enfin à l'utilisateur la page HTML générée par la vue.
@startuml
actor Navigateur
participant "Route\n(routes/web.php)" as R
participant "Contrôleur\nLivreController" as C
participant "Modèle\nLivre" as M
database "Base de\ndonnées" as DB
participant "Vue\nlivres/show.blade.php" as V
Navigateur -> R : GET /livres/le-petit-prince
R -> C : show($livre)
C -> M : Livre::where('slug', …)->first()
M -> DB : SELECT * FROM livres WHERE slug = ?
DB --> M : une ligne
M --> C : objet Livre
C -> V : view('livres.show', ['livre' => $livre])
V --> C : HTML
C --> Navigateur : réponse HTTP 200 (page HTML)
@endumlDans Laravel, il y a une étape avant le contrôleur : la route. C'est elle qui associe une URL et une méthode HTTP au bon contrôleur (chapitre 3). Entre les deux, des middlewares peuvent filtrer la requête (chapitre 4).
Laravel se présente comme « le framework PHP pour les artisans du web ». C'est aujourd'hui le framework PHP le plus utilisé.
Laravel utilise toutes les possibilités récentes de PHP. Si une ligne de code Laravel te semble mystérieuse, c'est presque toujours l'une des notions ci-dessous.
<?php
namespace App\Http\Controllers; // le « dossier logique » de la classe
use App\Models\Livre; // importe la classe Livre
use Illuminate\Http\Request;
class LivreController extends Controller
{
public function index(Request $request)
{
$nom = Livre::class; // "App\Models\Livre" : le nom complet de la classe
return $nom;
}
}L'espace de noms (namespace) suit le dossier : App\Models\Livre est dans app/Models/Livre.php. C'est la norme PSR-4, que l'autoloader de Composer utilise pour trouver les fichiers.
<?php
class Panier
{
// Équivaut à déclarer deux propriétés privées et à les remplir dans le constructeur
public function __construct(
private array $lignes = [],
private float $remise = 0.0,
) {}
public function total(): float
{
$somme = array_sum(array_map(fn (array $l) => $l['prix'] * $l['qte'], $this->lignes));
return round($somme * (1 - $this->remise), 2);
}
}
$p = new Panier([['prix' => 120.0, 'qte' => 2], ['prix' => 45.5, 'qte' => 1]], 0.1);
echo $p->total(); // 256.95Présentation de Laravel et installation d'un premier projet (Laravel 11, même structure que Laravel 13).
Écris en PHP 8.3 (sans Laravel) un fichier panier.php qui contient : une énumération Langue (arabe, français, anglais) avec une méthode libelle() ; une classe Livre dont le constructeur utilise la promotion des propriétés (isbn, titre, prix, langue) ; une classe Panier avec les méthodes ajouter(Livre $livre, int $qte = 1), retirer(string $isbn) et total(): float. Teste-le avec php panier.php.
Pour chaque élément de Kitab, indique s'il relève du modèle, de la vue, du contrôleur ou de la route : (1) le fichier qui affiche la fiche d'un livre en HTML ; (2) la règle « une commande payée ne peut plus être modifiée » ; (3) l'association de l'URL /panier à une action ; (4) la récupération des livres d'une catégorie puis leur transmission à la page ; (5) la requête qui calcule le stock total d'un livre ; (6) la boucle qui affiche les livres dans une grille.
Explique chaque ligne : (1) use App\Models\Livre; (2) public function __construct(private float $taux = 0.2) {} (3) $total = $lignes->sum(fn ($l) => $l->prix * $l->qte); (4) $nom = $request->user()?->name; (5) return Statut::from('payee'); (6) class Livre extends Model { use HasFactory; }
Dans composer.json, la contrainte "laravel/framework": "^13.0" signifie « 13.0 ou plus, mais moins que 14.0 ». C'est le principe du versionnage sémantique (semver) : MAJEURE.MINEURE.CORRECTIF. Une version majeure peut casser la compatibilité ; une version mineure ou un correctif, non.
Ce qu'il faut savoir avant d'utiliser un framework PHP
Les versions de Laravel
Laravel publie une version majeure par an (au premier trimestre). Chaque version reçoit des corrections de bugs pendant 18 mois et des corrections de sécurité pendant 2 ans.
Laravel 11 a apporté la plus grosse simplification récente : une structure de projet allégée, la configuration centralisée dans bootstrap/app.php et SQLite par défaut. Laravel 12 a apporté de nouveaux kits de démarrage (React, Vue, Livewire). Laravel 13 ajoute surtout des attributs PHP pour configurer le code (#[Middleware], #[Fillable]), un SDK officiel pour l'IA et des ressources JSON:API.
<?php
enum Statut: string
{
case EnAttente = 'en_attente';
case Payee = 'payee';
case Expediee = 'expediee';
public function libelle(): string
{
return match ($this) {
Statut::EnAttente => 'En attente de paiement',
Statut::Payee => 'Payée',
Statut::Expediee => 'Expédiée',
};
}
}
trait Horodatage
{
public function creeLe(): string
{
return date('d/m/Y');
}
}
class Commande
{
use Horodatage; // Commande reçoit la méthode creeLe()
public function __construct(public Statut $statut = Statut::EnAttente) {}
}
$c = new Commande();
echo $c->statut->libelle(); // En attente de paiement
echo Statut::from('payee')->libelle(); // PayéeL'autoloading, les espaces de noms et les premières classes : les rappels de PHP objet de la section 5 en pratique.