maurice chavelli

Découvrez le framework PHP

LARAVEL
vous pratiquez PHP et vous savez créer des sites ? vous avez l’impression de réécrire souvent
les mêmes choses ? vous vous posez des questions sur la meilleure façon de traiter une tâche
particulière, comme créer des formulaires ou envoyer des e-mails ? vous aimeriez disposer d’une
boîte à outils toute prête pour tout le code laborieux ? alors vous avez besoin d’un framework
PHP et laravel constitue actuellement ce qui se fait de mieux en la matière !
maurice chavelli

Qu’allez-vous apprendre ? À propos de l’auteur

Découvrez le framework PHP

LARAVEL
Les bases de Laravel Maurice Chavelli a commencé l’informatique
• Présentation générale sur un Sinclair ZX en 1981. Développeur .NET et
• Installation et organisation
administrateur réseau, il devient rapidement un
acteur très présent sur le Web. Il ouvre en 2013
• Routage et façades

LARAVEL
un blog sur le framework PHP Laravel. Créateur
• Les réponses de plusieurs sites web, il découvre Bootstrap
• Les contrôleurs lors de sa sortie en 2011 et l’adopte rapidement
• Les entrées en pressentant tout son potentiel !
• La validation
• Configuration et session

Découvrez le framework PHP

• L’injection de dépendances L’esprit d’OpenClassrooms
Les bases de données Des cours ouverts, riches et vivants, conçus
pour tous les niveaux et accessibles à tous
• Migrations et modèles
gratuitement sur notre plate-forme d’e-
• Les ressources éducation : www.openclassrooms.com.
• Ressources pour les utilisateurs et erreurs Vous y vivrez une véritable expérience
• L’authentification communautaire de l’apprentissage,
• Les relations 1:n et n:n permettant à chacun d’apprendre avec
• Les commandes et les assistants le soutien et l’aide des autres étudiants
• Query Builder sur les forums. Vous profiterez des cours
disponibles partout, tout le temps : sur le
Plus loin avec Laravel Web, en PDF, en eBook, en vidéo…
• Environnement et déploiement
• Des vues propres, avec ou sans le conteneur
de dépendances
• La localisation
• Ajax
• Les tests unitaires
• Événements et autorisations
ISBN : 978-2-212-14398-0
Code éditeur : G14398

29,90 E

Couverture : Studio Eyrolles © éditions Eyrolles

G14398_Laravel.indd 1 08/08/2016 10:15

 maurice chavelli
Découvrez le framework PHP

LARAVEL
vous pratiquez PHP et vous savez créer des sites ? vous avez l’impression de réécrire souvent
les mêmes choses ? vous vous posez des questions sur la meilleure façon de traiter une tâche
particulière, comme créer des formulaires ou envoyer des e-mails ? vous aimeriez disposer d’une
boîte à outils toute prête pour tout le code laborieux ? alors vous avez besoin d’un framework
PHP et laravel constitue actuellement ce qui se fait de mieux en la matière !
maurice chavelli

Qu’allez-vous apprendre ? À propos de l’auteur

Découvrez le framework PHP

LARAVEL
Les bases de Laravel Maurice Chavelli a commencé l’informatique
• Présentation générale sur un Sinclair ZX en 1981. Développeur .NET et
• Installation et organisation
administrateur réseau, il devient rapidement un
acteur très présent sur le Web. Il ouvre en 2013
• Routage et façades

LARAVEL
un blog sur le framework PHP Laravel. Créateur
• Les réponses de plusieurs sites web, il découvre Bootstrap
• Les contrôleurs lors de sa sortie en 2011 et l’adopte rapidement
• Les entrées en pressentant tout son potentiel !
• La validation
• Configuration et session

Découvrez le framework PHP

• L’injection de dépendances L’esprit d’OpenClassrooms
Les bases de données Des cours ouverts, riches et vivants, conçus
pour tous les niveaux et accessibles à tous
• Migrations et modèles
gratuitement sur notre plate-forme d’e-
• Les ressources éducation : www.openclassrooms.com.
• Ressources pour les utilisateurs et erreurs Vous y vivrez une véritable expérience
• L’authentification communautaire de l’apprentissage,
• Les relations 1:n et n:n permettant à chacun d’apprendre avec
• Les commandes et les assistants le soutien et l’aide des autres étudiants
• Query Builder sur les forums. Vous profiterez des cours
disponibles partout, tout le temps : sur le
Plus loin avec Laravel Web, en PDF, en eBook, en vidéo…
• Environnement et déploiement
• Des vues propres, avec ou sans le conteneur
de dépendances
• La localisation
• Ajax
• Les tests unitaires
• Événements et autorisations

G14398_Laravel.indd 1 08/08/2016 10:15

 Découvrez le framework php

laravel

G14398_Laravel_PDT.indd 1 08/08/2016 10:06

 DANS LA MÊME COLLECTION

R. De Visscher. – Découvrez le langage Swift.

N°14397, 2016, 128 pages.
M. Lorant. – Développez votre site web avec le framework Django.
N°21626, 2015, 285 pages.
E. Lalitte. – Apprenez le fonctionnement des réseaux TCP/IP.
N°21623, 2015, 300 pages.
M. Nebra, M. Schaller. – Programmez avec le langage C++.
N°21622, 2015, 674 pages.

SUR LE MÊME THÈME

R. Goetter. – CSS 3 Flexbox.

N°14363, 2016, 152 pages.
W. McKinney. – Analyse de données en Python.
N°14109, 2015, 488 pages.
E. Biernat, M. Lutz. – Data science : fondamentaux et études de cas.
N°14243, 2015, 312 pages.
B. Philibert. – Bootstrap 3 : le framework 100 % web design.
N°14132, 2015, 318 pages.
C. Camin. – Développer avec Symfony2.
N°14131, 2015, 474 pages.
S. Pittion, B. Siebman. – Applications mobiles avec Cordova et PhoneGap.
N°14052, 2015, 184 pages.
C. Delannoy. – Le guide complet du langage C.
N°14012, 2014, 844 pages.

Retrouvez nos bundles (livres papier + e-book) et livres numériques sur

http://izibook.eyrolles.com

EY_DecLangFMW_NvxGris.indd III 05/08/2016 10:08:30

 Maurice Chavelli

Découvrez le framework php

laravel

G14398_Laravel_PDT.indd 3 08/08/2016 10:06

 ÉDITIONS EYROLLES
61, bd Saint-Germain
75240 Paris Cedex 05
www.editions-eyrolles.com

En application de la loi du 11 mars 1957, il est interdit de reproduire intégralement ou partiellement le

présent ouvrage, sur quelque support que ce soit, sans l’autorisation de l’Éditeur ou du Centre Français
d’exploitation du droit de copie, 20, rue des Grands Augustins, 75006 Paris.

© Groupe Eyrolles, 2016. ISBN Eyrolles : 978-2-212-14398-0

© OpenClassrooms, 2016

EY_DecLangFMW_cmjn.indd IV 04/08/2016 11:25:41

 Avant-propos
Vous pratiquez PHP et vous savez créer des sites ? Vous avez l’impression de réé-
crire souvent les mêmes choses ? Vous vous posez des questions sur la meilleure
façon de traiter une tâche particulière comme créer des formulaires ou envoyer
des courriels ? Vous aimeriez disposer d’une boîte à outils toute prête pour tout
le code laborieux ? Vous devez choisir une solution logicielle pour développer un
site dynamique ?
Alors vous avez besoin d’un framework PHP. Et Laravel constitue actuellement ce qui
se fait de mieux en la matière.
Laravel colle aux plus récentes avancées de PHP et surtout à son approche objet.
Découvrir ce framework et plonger dans son code c’est prendre un cours de program-
mation et d’esthétique. C’est aussi disposer d’une boîte à outils simple et performante
pour construire des applications web sans se soucier de l’intendance habituelle.
Laravel est un framework encore jeune qui connaît un succès très rapide, surtout aux
États-Unis où il est devenu le plus populaire. La documentation existant actuellement
étant essentiellement en langue anglaise, le présent ouvrage a pour objectif de présen-
ter ce framework très prometteur au public français. Il s’adresse principalement aux
développeurs et chefs de projets.
Cet ouvrage a été conçu en trois parties progressives qu’il convient de lire dans l’ordre.
• La première partie, particulièrement détaillée, est destinée à vous habituer au
framework et à sa philosophie. Elle vous présente les notions essentielles.
• La deuxième partie est axée sur les bases de données, qui constituent la clé des appli-
cations dynamiques. Les autres notions seront évidemment développées et complétées
au cours de cette partie qui vous demandera plus d’attention et d’expérimentation.
• La troisième partie consolide vos connaissances et détaille quelques spécificités
comme la manière d’obtenir des vues épurées, l’utilisation d’Ajax et la localisation. Elle
présente la façon de déployer une application Laravel selon le serveur de ­destination.
Découvrez le langage PHP Laravel

Le code est plus fourni et moins détaillé ; il vous faudra l’analyser et le mettre en
pratique pour mettre à profit cet apprentissage.

Cet ouvrage nécessite d’avoir des connaissances correctes en PHP, HTML, CSS et
JavaScript. Si vous avez des lacunes dans un de ces domaines, vous pouvez facilement
! les combler avec les nombreux cours à disposition sur le site OpenClassrooms (www.
openclassrooms.com) et avec les nombreux ouvrages sur le sujet des éditions Eyrolles
(www.editions-eyrolles.com) !

VI
 Table des matières
Première partie – Les bases de Laravel 1
1 Présentation générale 3
Un framework ?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Approche personnelle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
(Re)découvrir PHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Définition et intérêt du framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Pourquoi Laravel ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Constitution de Laravel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Le meilleur de PHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Définitions de MVC et POO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
MVC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
POO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2 Installation et organisation 9
Composer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Présentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Fonctionnement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Créer une application Laravel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Prérequis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Installation avec Composer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Installation avec Laravel Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Autorisations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
URL propres. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Découvrez le langage PHP Laravel

L’organisation de Laravel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Dossier app . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Autres dossiers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Fichiers à la racine. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Accessibilité . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Environnement et messages d’erreur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Le composant Html . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

3 Routage et façades 21
Les requêtes HTTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Petit rappel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
.htaccess et index.php. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Le cycle de la requête. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Plusieurs routes et paramètres de route. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Erreur d’exécution et contrainte de route. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Une route nommée . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Les façades. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

4 Les réponses 31
Construire une réponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Codes des réponses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Vues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
La vue paramétrée. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
URL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Route . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Vue. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Simplifier la syntaxe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Les redirections. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

5 Les contrôleurs 39
L’utilité des contrôleurs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Rôle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Constitution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Liaison avec les routes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Route nommée. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
L’utilisation d’un contrôleur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

6 Les entrées 45
Scénario et routes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

VIII
 Table des matières

Le middleware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Le formulaire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Le contrôleur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
La protection CSRF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

7 La validation 53
Scénario et routes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Les vues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Vue de contact. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Vue de confirmation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Vue du courriel pour l’administrateur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
La requête de formulaire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Le contrôleur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Envoyer un courriel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

8 Configuration et session 65
La configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Les sessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
La requête de formulaire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Les routes et le contrôleur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Les vues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

9 L’injection de dépendances 75
Le problème et sa solution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Problème. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Solution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
La gestion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Deuxième partie – Les bases de données 83

10 Migrations et modèles 85
Les migrations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Configuration de la base . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Artisan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Installer la migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Créer la migration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Utiliser la migration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

IX
Découvrez le langage PHP Laravel

Eloquent, un ORM très performant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Validation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Routes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Contrôleur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Vues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Fonctionnement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
L’organisation du code. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Première version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Deuxième version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Troisième version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

11 Les ressources 101

Les données. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Une ressource. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Création. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Routes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Contrôleur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
La validation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Création d’un utilisateur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Modification d’un utilisateur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

12 Ressources pour les utilisateurs et erreurs 111

Le gestionnaire de données (repository). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
getPaginate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
getById . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
show. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
edit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
update. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
store. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
destroy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Les vues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Vue index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Vue show. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Vue edit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Vue create. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Une réflexion sur le code. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Gestionnaire de base. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Modèle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Contrôleur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Les erreurs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

13 L’authentification 133
La commande Artisan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

X
 Table des matières

Les tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
password_reset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Les middlewares. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Authenticate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
RedirectIfAuthenticated . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Routes et contrôleurs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Routes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Contrôleurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
AuthController . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
PasswordController . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Les vues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
L’enregistrement d’un utilisateur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Validation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Contrôleur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Vue auth.register. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Connexion et déconnexion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Connexion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Vue auth.login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Déconnexion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
L’oubli du mot de passe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

14 La relation 1:n 161
Les données. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Migrations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Population. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
La relation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Les modèles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Contrôleur et routes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
Contrôleur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
Routes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Le gestionnaire des articles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
Les middlewares. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
La validation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
Le fonctionnement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
Liste des articles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
Ajout d’un article . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Suppression d’un article. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Les vues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Vue pour afficher les articles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
Vue pour créer un article. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

XI
Découvrez le langage PHP Laravel

15 La relation n:n 183
Les données. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
Migrations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
Population. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
Les modèles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
La validation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
La gestion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
Contrôleur et routes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
Repositories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Le fonctionnement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Liste des articles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Nouvel article. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
Suppression d’un article. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Recherche par mot-clé. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Les vues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Liste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
Vue de création d’un article. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

16 Les commandes et les assistants 205

Améliorer une commande . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
Laravel Schema Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Création des tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Création des champs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
Création des relations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
Exportation des fichiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

17 Query Builder 223

Les données. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Migration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Population. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Les sélections. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
Liste de tous les éditeurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
Tableau des valeurs d’une colonne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Ligne particulière. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Colonne isolée . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
Lignes distinctes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
Plusieurs conditions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Encadrer des valeurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
Prendre des valeurs dans un tableau . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Ordonner et grouper. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Les jointures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Trouver les titres des livres pour un éditeur dont on connaît l’identifiant. . . . . . . . . 234
Trouver les livres d’un auteur dont on connaît le nom . . . . . . . . . . . . . . . . . . . . . 235

XII
 Table des matières

Trouver les auteurs pour un éditeur dont on connaît l’identifiant. . . . . . . . . . . . . . 236

Attention aux requêtes imbriquées . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238

Troisième partie – Plus loin avec Laravel 239

18 Environnement et déploiement 241
L’environnement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
Le déploiement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
Besoins de Laravel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
Solution royale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Solution intermédiaire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Solution laborieuse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
Mode maintenance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

19 Des vues propres 249

Les macros. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Problème. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Définition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Fournisseur de services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Les templates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257

20 Des vues propres avec le conteneur de dépendances 259

La nouvelle vue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
L’organisation du code. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
Les constructeurs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
FormBuilder et HtmlBuilder. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
PanelBuilder. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Fournisseur de services et façade. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267

21 La localisation 269
Le principe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Façade Lang et classe Translator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Fichiers de langue. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Fonctionnement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Le middleware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Les dates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Route et contrôleur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
La réalisation de la localisation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Les vues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

XIII
Découvrez le langage PHP Laravel

Les noms des contrôles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282

En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283

22 Ajax 285
Les vues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
Vue login. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
JavaScript. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Le traitement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
Contrôleur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
Middleware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296

23 Les tests unitaires 297

L’intendance des tests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
PHPUnit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
Intendance de Laravel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
Environnement de test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
Construire un test en trois étapes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
Assertions et appel de routes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
Assertions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
Appel de routes et test de réponse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
Les vues et les contrôleurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
Vues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
Contrôleurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
Isoler les tests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
Simuler une classe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
Tester une application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309

24 Événements et autorisations 311

Les événements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
Événements du framework. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
Fournisseur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
Créer un observateur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
Créer un événement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
Les autorisations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
Sécurité. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
Différentes autorisations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
En résumé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324

Index 325

XIV
 Première partie

Les bases de Laravel

Dans cette première partie, je vous propose de découvrir les bases de Laravel : où le
trouver, comment l’installer, quelle configuration est nécessaire pour le faire fonction-
ner… Je vous présente aussi son organisation et sa philosophie : comment les requêtes
sont aiguillées par des routes et dirigées vers des contrôleurs pour être traitées, et
comment retourner ensuite une réponse appropriée.
Par ailleurs, vu qu’il est rare qu’une application web n’utilise pas de formulaire, je vous
montre la manière d’en créer un, de valider les entrées saisies et de traiter les informa-
tions envoyées. La configuration de Laravel étant aussi une application avec ses propres
nécessités et contraintes, nous verrons comment elle fonctionne.
Le protocole HTTP est performant mais il permet seulement des requêtes ponctuelles
sans persistance. Or, lorsqu’on crée un site, on souhaite permettre aux utilisateurs de
se connecter et d’avoir un environnement et des informations personnalisés. Il est donc
nécessaire de gérer des sessions, et Laravel est bien équipé pour le faire.
Pour terminer cette partie, la notion d’injection de dépendance, qui est intensivement
utilisée dans Laravel, sera présentée avec un exemple pratique d’application.
1 Présentation
générale
Dans ce premier chapitre, je vais évoquer PHP, son historique et sa situation actuelle.
J’expliquerai aussi l’intérêt d’utiliser un framework pour ce langage et surtout pourquoi
j’ai choisi Laravel. J’évoquerai enfin le patron MVC et la programmation orientée objet
(POO).

Un framework ?

Approche personnelle

PHP est un langage populaire et accessible. Il est facile à installer et présent chez tous
les hébergeurs. C’est un langage riche et plutôt facile à aborder, surtout pour quelqu’un
qui a déjà des bases en programmation. On peut réaliser rapidement une application
web fonctionnelle grâce à lui. Toutefois, le revers de cette simplicité est que, bien sou-
vent, le code créé est confus, complexe et sans aucune cohérence. Il faut reconnaître
que PHP n’encourage pas à organiser son code et rien n’oblige à le faire.
Lorsqu’on crée des applications PHP, on finit par avoir des codes personnels réutili-
sables pour les fonctionnalités récurrentes, par exemple pour gérer des pages de façon
dynamique. Une fois qu’on a créé une fonction ou une classe pour réaliser une tâche il
est naturel d’aller la chercher lorsque la même situation se présente. Puisque c’est une
bibliothèque personnelle et qu’on est seul maître à bord, il faut évidemment la mettre
à jour lorsque c’est nécessaire et c’est parfois fastidieux.
En général, on a aussi une hiérarchie de dossiers à laquelle on est habitué et on
la reproduit quand on commence le développement d’une nouvelle application.
On se rend compte parfois que cette habitude a des effets pervers, parce que la
hiérarchie qu’on met ainsi en place de façon systématique n’est pas forcément la
plus adaptée.
Première partie – Les bases de Laravel

En résumé, l’approche personnelle est plutôt du bricolage à la hauteur de ses compé-

tences et de sa disponibilité.

(Re)découvrir PHP

Lorsque j’ai découvert PHP à la fin des années 1990, il en était à la version 3. C’était
essentiellement un langage de script, en général mélangé au HTML, qui permettait de
réaliser du templating, des accès aux données et du traitement. La version 4 en 2000
a apporté plus de stabilité et une ébauche de l’approche objet. Cependant, il a fallu
attendre la version 5 en 2004 pour disposer d’un langage de programmation à la hauteur
du standard existant pour les autres langages.
Cette évolution incite à perdre les mauvaises habitudes si on en avait. Un site comme
http://www.phptherightway.com offre de bonnes pistes pour mettre en place de bonnes
pratiques. Donc, si vous êtes un bidouilleur de code PHP, je vous conseille cette saine
lecture qui devrait vous offrir un nouvel éclairage sur ce langage et, surtout, vous auto-
riser à vous lancer de façon correcte dans le code de Laravel.

Définition et intérêt du framework

D’après Wikipédia, un framework informatique est un « ensemble cohérent de compo-

sants logiciels structurels, qui sert à créer les fondations ainsi que les grandes lignes
de tout ou d’une partie d’un logiciel » ; autrement dit, c’est une base cohérente avec
des briques toutes prêtes à disposition. Il existe des frameworks pour tous les langages
de programmation et en particulier pour PHP. En faire la liste serait laborieux tant il
en existe !
L’utilité d’un framework est d’éviter de passer du temps à développer ce qui a déjà été
fait par d’autres, souvent plus compétents, et qui a en plus été utilisé et validé par de
nombreux utilisateurs. On peut imaginer un framework comme un ensemble d’outils à
disposition. Par exemple, si je dois programmer du routage pour mon site, je prends un
composant déjà tout prêt et qui a fait ses preuves et je l’utilise : gain de temps, fiabilité,
mise à jour si nécessaire…
Il serait vraiment dommage de se passer d’un framework alors que le fait d’en utiliser
un présente pratiquement uniquement des avantages.

Pourquoi Laravel ?

Constitution de Laravel

Laravel, créé par Taylor Otwel, initie une nouvelle façon de concevoir un framework en
utilisant ce qui existe de mieux pour chaque fonctionnalité. Par exemple, toute applica-
tion web a besoin d’un système qui gère les requêtes HTTP. Plutôt que de réinventer
quelque chose, le concepteur de Laravel a tout simplement utilisé celui de Symfony
en l’étendant pour créer un système de routage efficace. De la même manière, l’envoi

4
 Chapitre 1. Présentation générale

des courriels se fait avec la bibliothèque SwiftMailer. En quelque sorte, Otwel a fait
son marché parmi toutes les bibliothèques disponibles. Nous verrons dans cet ouvrage
comment cela est réalisé. Néanmoins, Laravel n’est pas seulement le regroupement de
bibliothèques existantes ; c’est aussi un ensemble de nombreux composants originaux
et surtout une orchestration de tout cela.
Vous allez trouver dans Laravel :
• un système de routage perfectionné (RESTFul et ressources) ;
• un créateur de requêtes SQL et un ORM performants ;
• un moteur de templates efficace ;
• un système d’authentification pour les connexions ;
• un système de validation ;
• un système de pagination ;
• un système de migration pour les bases de données ;
• un système d’envoi de courriels ;
• un système de cache ;
• un système d’événements ;
• un système d’autorisations ;
• une gestion des sessions…
• et bien d’autres choses encore que nous allons découvrir ensemble.
Il est probable que certains éléments de cette liste ne vous évoquent pas grand-chose,
mais ce n’est pas important pour le moment ; tout cela deviendra plus clair au fil des
chapitres.

Le meilleur de PHP

Plonger dans le code de Laravel, c’est recevoir un cours de programmation tant le style
est clair et élégant et le code merveilleusement organisé. La version actuelle de Laravel
est la 5.2 et nécessite au minimum la version 5.5.9 de PHP. Pour aborder de façon
efficace ce framework, il est souhaitable de se familiariser avec les notions suivantes.
• Les espaces de noms : c’est une façon de bien ranger le code pour éviter des conflits
de nommage. Laravel utilise cette possibilité de façon intensive. Tous les composants
sont rangés dans des espaces de noms distincts, de même que l’application créée.
• Les fonctions anonymes : ce sont des fonctions sans nom (souvent appelées clo-
sures) qui améliorent le code. Les utilisateurs de JavaScript y sont habitués, ceux
de PHP un peu moins parce qu’elles y sont plus récentes. Laravel les utilise aussi de
façon systématique.
• Les méthodes magiques  : ce sont des méthodes qui n’ont pas été explicitement
décrites dans une classe, mais qui peuvent être appelées et résolues.
• Les interfaces  : une interface est un contrat de constitution des classes. En pro-
grammation objet, c’est le sommet de la hiérarchie. Tous les composants de Laravel

5
Première partie – Les bases de Laravel

sont fondés sur des interfaces. La version 5 a même vu apparaître un lot de contrats
pour étendre de façon sereine le framework.
• Les traits : c’est une façon d’ajouter des propriétés et méthodes à une classe sans
passer par l’héritage, ce qui aide à passer outre certaines limitations de l’héritage
simple proposé par défaut par PHP.

Un framework n’est pas fait pour remplacer la connaissance d’un langage, mais pour
! assister celui (ou celle) qui connaît déjà bien ce langage. Si vous avez des lacunes, il vaut
mieux les combler pour profiter pleinement de Laravel.

Documentation

Quand on s’intéresse à un framework, il ne suffit pas qu’il soit riche et performant ;

il faut aussi que la documentation soit à la hauteur. C’est le cas pour Laravel. Vous
trouverez la documentation sur le site officiel https://laravel.com/, mais il existe de plus
en plus d’autres sources, dont voici les principales :
• https://laravel.fr/ : site d’entraide francophone avec un forum actif ;
• http://laravel.io/ : le forum officiel ;
• http://laravel.sillo.org/ : mon blog créé début 2013 et toujours actif, qui constitue une
initiation progressive complémentaire du présent ouvrage ;
• http://cheats.jesse-obrien.ca/ : une page bien pratique qui résume toutes les commandes ;
• http://www.laravel-tricks.com/ : un autre site d’astuces ;
• http://packalyst.com/ : le rassemblement de tous les packages pour ajouter des fonc-
tionnalités à Laravel ;
• https://laracasts.com/ : de nombreux tutoriels vidéo en anglais, dont un certain nombre
en accès gratuit, notamment une série complète pour Laravel 5 : https://laracasts.com/
series/laravel-5-fundamentals.
Il existe aussi de bon livres, mais ils sont tous en anglais.

Définitions de MVC et POO

MVC

On peut difficilement parler d’un framework sans évoquer le patron Modèle-Vue-

Contrôleur. Pour certains, il s’agit de la clé de voûte de toute application rigoureuse ;
pour d’autres, c’est une contrainte qui empêche d’organiser judicieusement son code.
De quoi s’agit-il ? Voici un petit schéma pour y voir clair.

6
 Chapitre 1. Présentation générale

Le modèle MVC

C’est un modèle d’organisation du code.

• Le modèle est chargé de gérer les données.
• La vue est chargée de la mise en forme pour l’utilisateur.
• Le contrôleur est chargé de gérer l’ensemble.
En général, on résume en disant que le modèle gère la base de données, la vue produit
les pages HTML et le contrôleur fait tout le reste. Plus précisément, détaillons cette
organisation dans Laravel.
• Le modèle correspond à une table d’une base de données. C’est une classe qui étend
la classe Model, qui gère simplement et efficacement les manipulations de données
et l’établissement automatisé de relations entre tables.
• Le contrôleur se décline en deux catégories : contrôleur classique et contrôleur de
ressource (je détaillerai évidemment tout cela dans cet ouvrage).
• La vue est soit un simple fichier avec du code HTML, soit un fichier utilisant le sys-
tème de templates Blade de Laravel.
Laravel propose ce modèle mais ne l’impose pas. Nous verrons d’ailleurs qu’il est parfois
judicieux de s’en éloigner, parce qu’il y a plusieurs choses qu’on n’arrive pas à caser
dans ce modèle. Par exemple, si je dois envoyer des emails, où vais-je placer mon code ?
En général, ce qui se produit est l’inflation des contrôleurs auxquels on demande des
rôles pour lesquels ils ne sont pas faits.

POO

Laravel est fondamentalement orienté objet. La POO est un design pattern qui s’éloigne
radicalement de la programmation procédurale. Avec la POO, tout le code est placé
dans des classes qui découlent d’interfaces établissant des contrats de fonctionnement.
Avec la POO, on manipule des objets.
Avec la POO, la responsabilité du fonctionnement est répartie dans des classes alors que
dans l’approche procédurale tout est mélangé. Le fait de répartir la responsabilité évite
la duplication du code qui est le lot presque forcé de la programmation procédurale.
Laravel pousse au maximum cette répartition en utilisant l’injection de dépendances.
L’utilisation de classes bien identifiées dont chacune a un rôle précis, le pilotage par
des interfaces claires et l’injection de dépendances, tout cela crée un code élégant,
efficace, lisible, facile à maintenir et à tester. C’est ce que Laravel propose. Alors, vous

7
Première partie – Les bases de Laravel

pouvez évidemment greffer là-dessus votre code approximatif, mais vous pouvez aussi
vous inspirer des sources du framework pour améliorer votre style de programmation.

L’injection de dépendances est destinée à éviter de rendre les classes dépendantes et

à privilégier une liaison dynamique plutôt que statique. Le résultat est un code plus
lisible, plus facile à maintenir et à tester. Nous verrons ce mécanisme à l’œuvre dans
Laravel.

En résumé

• Un framework fait gagner du temps et donne l’assurance de disposer de composants

bien codés et fiables.
• Laravel est un framework novateur, complet, qui utilise les possibilités les plus
récentes de PHP et qui est impeccablement codé et organisé.
• La documentation de Laravel est complète, précise et de plus en plus de tutoriels et
exemples apparaissent sur la toile.
• Laravel adopte le patron MVC, mais ne l’impose pas. Il est totalement orienté objet.

8
2 Installation
et organisation
Dans ce chapitre, nous allons faire connaissance avec le gestionnaire de dépendances
Composer, présenter la création d’une application Laravel et expliquer comment le code
est organisé dans cette application.

Avertissement
Pour utiliser Laravel et suivre ce chapitre et l’ensemble de l’ouvrage, vous aurez besoin d’un serveur
équipé de PHP avec au minimum la version 5.5.9 et aussi de MySQL. Il existe plusieurs applications
« tout-en-un » faciles à installer : wampserver (http://www.wampserver.com/), xampp (https://
www.apachefriends.org/fr/index.html), easyphp (http://www.easyphp.org/)… Personnellement,
j’utilise wamp, qui répond sans problème à toutes mes attentes et permet de basculer entre les
versions de PHP et de MySQL en un simple clic.
Une solution toute prête, Homestead (https://laravel.com/docs/5.0/homestead), est facile à
mettre en œuvre sous Linux, mais beaucoup moins conviviale avec Windows. Pour ce dernier, il
existe une autre possibilité bien pensée : Laragon (https://laragon.org/).
Quelle que soit l’application que vous utilisez, vérifiez que vous avez la bonne version de PHP
(minimum 5.5.9). En outre, les extensions PDO, Tokenizer, OpenSSL et Mbstring de PHP
doivent être activées.

Composer
Présentation

Je vous ai dit que Laravel utilise des composants d’autres sources. Plutôt que de les
incorporer directement, il utilise un gestionnaire de dépendances : Composer. D’ailleurs,
les composants de Laravel sont aussi traités comme des dépendances. De quoi s’agit-il ?
Imaginez que vous créez une application PHP et que vous utilisez des composants
issus de différentes sources : Carbon pour les dates, Redis pour les données… Une
Première partie – Les bases de Laravel

méthode laborieuse consiste à aller chercher tout cela de façon manuelle, et vous allez
être confrontés à des difficultés :
• télécharger tous les composants dont vous avez besoin et les placer dans votre struc-
ture de dossiers ;
• traquer les éventuels conflits de nommage entre les bibliothèques ;
• mettre à jour manuellement les bibliothèques quand c’est nécessaire ;
• prévoir le code pour charger les classes à utiliser…
Tout cela est évidemment faisable, mais avouez qu’il serait bien agréable d’automatiser
ces procédures. C’est justement ce que fait un gestionnaire de dépendances !

Installation

Laravel utilise Composer comme gestionnaire de dépendances. Il vous faut donc com-
mencer par l’installer sur votre ordinateur. Selon votre système, la procédure est dif-
férente ; je vous renvoie donc au site https://getcomposer.org/ pour obtenir tous les
renseignements sur le sujet.
Pour Windows, il suffit de télécharger un installeur (https://getcomposer.org/download/),
qui fait tout très proprement et renseigne aussi la variable d’environnement PATH, ce
qui rend Composer utilisable depuis n’importe quel emplacement. En revanche, l’ins-
talleur vous demandera où se trouve php.exe et vous devrez répondre, car Composer
est un fichier PHP et a besoin d’être exécuté.
Pour les autres systèmes, en particulier Linux, le plus simple est d’utiliser curl. Il suffit
de suivre les instructions détaillées sur le site.

Pour aller plus loin avec Composer, vous pouvez lire l’article suivant : http://laravel.sillo.
org/jouer-avec-composer/.

Fonctionnement

Pour comprendre le fonctionnement de Composer, il faut connaître le format JSON

(JavaScript Object Notation). Un fichier JSON a pour but de contenir des informations
de type étiquette-valeur. Regardez cet exemple élémentaire :

{
"nom": "Durand",
"prénom": "Jean"
}

Les étiquettes sont "nom" et "prénom" ; les valeurs correspondantes sont "Durand"
et "Jean". Les valeurs peuvent être aussi des tableaux ou des objets. Regardez ce
second exemple :

10
 Chapitre 2. Installation et organisation

{
"identité1" : {
"nom": "Durand",
"prénom": "Jean"
},
"identité2" : {
"nom": "Dupont",
"prénom": "Albert"
}
}

Composer a besoin d’un fichier composer.json, qui contient les instructions néces-
saires : les dépendances, les classes à charger automatiquement… Voici un extrait de
ce fichier pour Laravel :

{
"name": "laravel/laravel",
"description": "The Laravel Framework.",
"keywords": ["framework", "laravel"],
"license": "MIT",
"type": "project",
"require": {
"php": ">=5.5.9",
"laravel/framework": "5.2.*"
},
...
}

Créer une application Laravel

Prérequis

Composer fonctionne en ligne de commande. Vous avez donc besoin de la console

(nommée Terminal ou Konsole sur OS X et Linux). Les utilisateurs de Linux sont très
certainement habitués à l’utilisation de la console, mais il n’en est généralement pas
de même pour les adeptes de Windows. Pour trouver la console sur ce système, il faut
chercher l’invite de commande.

Trouver la console dans Windows

11
Première partie – Les bases de Laravel

Cet ouvrage a été créé avec la version 5.2.* de Laravel. Lorsque vous créez une nouvelle
application, que ce soit avec composer create-project ou avec l’installeur,
vous obtenez la dernière version stable. Sur OpenClassrooms.com, je m’efforcerai de
garder ce cours en phase avec l’évolution de Laravel, mais il y aura toujours un délai

! entre la sortie d’une nouvelle version et cet ouvrage. Si vous rencontrez des différences
de fonctionnement avec les exemples utilisés, vous pouvez toujours, en attendant la
mise à niveau de l’ouvrage installer la version précédente de Laravel. Il suffit d’utiliser
la commande create-project en spécifiant la version comme troisième argument
(voir la documentation complète sur https://getcomposer.org/doc/03-cli.md#create-
project).

Installation avec Composer

Il y a plusieurs façons de créer une application Laravel. Celle qui me semble la plus
simple consiste à utiliser la commande create-project de Composer. Par exemple,
si je veux créer une application dans un dossier laravel5 à la racine de mon serveur,
voici la syntaxe à utiliser :

composer create-project --prefer-dist laravel/laravel laravel5

L’installation démarre et je n’ai plus qu’à attendre quelques minutes pour que Composer
fasse son travail jusqu’au bout. Une liste de téléchargements s’affiche, pour finalement
se retrouver avec l’architecture suivante.

Architecture des dossiers de Laravel

12
 Chapitre 2. Installation et organisation

On peut vérifier que tout fonctionne bien avec l’URL http://localhost/laravel5/public.

Normalement, on doit obtenir cette page très épurée :

Page d’accueil de Laravel

Sous Windows avec Wamp, il est possible d’avoir un souci pour afficher la page d’accueil.
Si c’est votre cas, il y a trois solutions.

! • N’utilisez pas Wamp mais par exemple Laragon (http://laragon.org/).

• Créez un hôte virtuel.
• Suivez ce qui est préconisé sur la page http://stackoverflow.com/
questions/15607132/laravel-route-not-working-with-wamp.

Pour les mises à jour ultérieures, il suffit d’utiliser encore Composer, mais avec la
commande update :

composer update

Installation avec Laravel Installer

Une autre solution consiste à utiliser l’installeur de Laravel. Il faut commencer par
installer globalement l’installeur avec Composer :

composer global require "laravel/installer"

Il faut ensuite informer la variable d’environnement path de l’emplacement du dossier

.../composer/vendor/bin.
Pour créer une application, il suffit de taper :

laravel new monAppli

Laravel sera alors installé dans le dossier monAppli.

Si vous installez Laravel en téléchargeant directement les fichiers sur Github et en

utilisant la commande composer install, il vous faut effectuer deux actions
complémentaires. Dans ce cas en effet, il ne sera pas automatiquement créé de clé de
! sécurité et vous allez tomber sur une erreur au lancement. Il faut donc la créer avec la
commande php artisan key:generate. De plus, vous aurez à la racine le fichier
.env.example que vous devrez renommer en .env pour que la configuration
fonctionne.

13
Première partie – Les bases de Laravel

Autorisations

Au niveau des dossiers de Laravel, le seul qui ait besoin de droits d’écriture par le
serveur est storage.

Serveur

Pour fonctionner correctement, Laravel a besoin de PHP :

• version ≥ 5.5.9 ;
• extension PDO ;
• extension Mbstring ;
• extension OpenSSL ;
• extension Tokenizer.

URL propres

Pour un serveur Apache, il est prévu dans le dossier public un fichier .htaccess
avec ce code :

<IfModule mod_rewrite.c>
<IfModule mod_negotiation.c>
Options -MultiViews
</IfModule>

RewriteEngine On

# Redirect Trailing Slashes If Not A Folder...

RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)/$ /$1 [L,R=301]

# Handle Front Controller...

RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]

# Handle Authorization Header

RewriteCond %{HTTP:Authorization} .
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
</IfModule>

Le but est d’éviter d’avoir index.php dans l’URL. Cependant, pour que cela fonc-
tionne, il faut activer le module mod_rewrite.

Une autre façon d’obtenir un Laravel sur mesure est d’utiliser mon outil en ligne http://
laravel-designer.sillo.org/, décrit à l’adresse http://laravel.sillo.org/laravel-designer/.

14