25

mars

Tutoriel sur Laravel

Prpar par : Lydiane Beaulne-Blisle
Ceci est un tutorial qui montre comment dbuter avec le Framework PHP
Laravel.

Cr pour le cours de Projet de fin dtude

Collge de Maisonneuve
25 mars 2014
TP2 Rapport de veille technologique

Table des matires

Laravel ...................................................................................................................... 2
I. Introduction .............................................................................................................................. 2
II. MVC ......................................................................................................................................... 2
Installation de Laravel .............................................................................................. 3
I. Composer .................................................................................................................................. 3
II. Installation de Composer ........................................................................................................ 3
III. Installation de Laravel ........................................................................................................... 3
Utilisation de Laravel ............................................................................................... 5
I. Structure des dossiers ............................................................................................................... 5
II. Relier la base de donnes ........................................................................................................ 6
III. Crer les models ..................................................................................................................... 7
IV. Controllers .............................................................................................................................. 8
V. Routes...................................................................................................................................... 9
VI. Crer la vue .......................................................................................................................... 10
Autres informations ............................................................................................... 11
Sources dinformations .......................................................................................... 12

1|Page
TP2 Rapport de veille technologique

Laravel
I. Introduction

Laravel est un Framework PHP libre de droits qui a fait son apparition en 2011. Il est
peut-tre jeune compar aux autres de son genre, mais il se dmarque par sa facilit, sa
syntaxe lgante, et toutes sa documentation disponible tous. De plus, Laravel utilise la toute
dernire version de PHP 5.3 et a frquemment des patches de disponibles avec de nouveaux
lments et des mises jour qui rglent les problmes, ce qui prouve quil est en constante
volution et amlioration. En ce moment, il se base sur Composer , le meilleur outil de
dpendance qui gre des projets en PHP jusqu maintenant.

II. MVC

Laravel se base effectivement sur le patron de conception MVC, cest--dire modle-

vue-contrleur.

Le modle interagit avec la base de donnes, les regroupe, traite et gre les donnes. La
vue soccupe principalement de faire afficher ce que le modle renvoie. Ensuite, elle soccupe
de recevoir toute interaction de lutilisateur (hover, clic de souris, entre de texte, etc.). Ce sont
ces actions-l que le contrleur gre. Celui-ci prend en charge de synchroniser le modle et la
vue. Il capte toutes les activits de lutilisateur et, en fonction de, il actionne les changements
effectuer sur le site.

En sparant les composants dun site internet en ces trois catgories, cela permet une
clart de larchitecture des dossiers et simplifie grandement la tche aux dveloppeurs.

2|Page
TP2 Rapport de veille technologique

Installation de Laravel
I. Composer

La premire tape serait dinstaller le Composer dont laravel utilise. Cependant, quest-
ce quun composer? Et bien cest assez simple, Composer trouve les fichiers PHP quon a besoin
dans un projet. Il va les chercher et les installer la bonne place, pour nous. Comme Laravel est
un Framework PHP, il est trs pratique de lutiliser pour bien partir un projet.

II. Installation de Composer

On peut le tlcharger sur le site getcomposer.org ou directement sur le site de

laravel.com. Ce Composer a une entente avec Laravel et va chercher tous les fichiers que
Laravel utilise pour bien fonctionner. En installant le Composer, on pourra installer beaucoup
plus facilement et rapidement le Framework Laravel, sans faire derreur. Une fois le fichier
Composer-Setup.exe est install dans lordinateur, on peut maintenant installer Laravel.

III. Installation de Laravel

Maintenant, il faut savoir o installer le projet. Je vous conseille de travailler en

localhost, avant de travailler sur le serveur lui-mme, pour simple efficacit. Ouvrez une fentre
Windows de o vous voulez mettre le dossier de projet et faites click-droit, si vous avez bien
install le Composer, vous devriez voir dans la liste use Composer here . Vous le slectionnez
et une fentre de commande va apparatre. Vous devez inscrire la ligne de commande ci-
dessous :
composer create-project laravel/laravel your-project-name prefer-dist

Composer : signifie quon utiliser le Composer

create-project : signifie quon cre un projet

laravel/laravel : va chercher les fichiers installer pour le Framework Laravel

your-project-name : on met le nom quon veut donner notre projet

--prefer-dist : il y a plusieurs sous branches de Laravel, et cette commande-l va chercher la

version complte de Laravel.

3|Page
TP2 Rapport de veille technologique

Exemple :

composer create-project laravel/laravel portfolio prefer-dist

Quand vous avez fini, vous pesez sur la touche enter et cela va installer systmatiquement
Laravel au complet.

Une fois linstallation complt, testez si a a bel et bien fonctionn. Pour ce faire, ouvrer votre
fentre de navigation, google chrome ou firefox, et entrer votre lien pour le site soit :

localhost/nom-de-votre-dossier/public

Il faut absolument rajouter /public la fin parce que le fichier index.php se retrouve dans ce
dossier-l. Si tout a bien fonctionn, vous devriez voir le logo de Laravel en plein centre de la
page.

Maintenant, vous tes prts commencer votre site!

4|Page
TP2 Rapport de veille technologique

Utilisation de Laravel

I. Structure des dossiers

Il est important de dabord analyser la structure des dossiers pour savoir comment la
hirarchie fonctionne. Voici les dossiers important retenir :

Projet app config

controllers
models
views
routes.php

css
public
img

js

less

Il y a dautres dossiers mais moins important quand on commence utiliser Laravel.

Le dossier app contient tous les lments ncessaires la programmation back-end du site.

Le dossier public, lui, contient les mdias et les autres langages de programmation, soit le CSS,
le JS et il y a mme un dossier less pour ceux qui veulent saventurer avec ce langage, ce que je
conseil trs fortement, less est trs facile utiliser et simplifie beaucoup lapparence du css!

Il y a galement un dossier pour boostrap si jamais on veut lutiliser pour le site internet.

On peut voir ici que Laravel utilise les dernires nouveauts dans la programmation pour
apporter la meilleure exprience aux utilisateurs de ce Framework.

5|Page
TP2 Rapport de veille technologique

II. Relier la base de donnes

Maintenant, il faut relier la base de donnes au projet. Dans le dossier config, il existe le
fichier database.php. En louvrant, on peut voir plusieurs array, dont un qui est associ mysql.

Pour 'database' => il faut mettre ensuite le nom de la base de donnes, soit portfolio dans
mon cas.

Pour 'username' => notre nom dutilisateur de la connexion phpmyadmin, qui est root pour
moi.

Pour 'password' => le mot de passe.

Et pour le charset, il est par dfaut en utf8.

Comme il y a plusieurs type de connexion une base de donnes disponible, il ne faut pas
oublier de mettre par dfaut le type de connexion que lon va utiliser, soit mysql comme ci-
dessous, toujours dans le mme fichier :

6|Page
TP2 Rapport de veille technologique

III. Crer les models

Pour chaque table de notre base de donnes que lon veut utiliser pour notre site, il faut
crer un modle pour chacun. Dans le dossier app/models, il y a User.php qui est un fichier de
base.

Dans mon portfolio, jai plusieurs tables. Alors jai cr un fichier php partir de
User.php comme suit :

Dpendamment des lments et de ce quon veut faire avec, chaque fichier peut diffrer avec
le niveau de complexit. Cependant, moi je veux seulement faire afficher mes donnes sur mon
portfolio.

Dans mon Menu.php, je dois absolument dclarer deux variables. La premire, je dois dfinir
dans quelle table je vais chercher mes informations. Et, par la suite, je dois dfinir une cl
premire par dfaut. Pour le moment, cest tout ce que cette class a besoin.

Et on fait de mme pour

toutes les autres tables
dans la base de donnes.

7|Page
TP2 Rapport de veille technologique

IV. Controllers

Dans le dossier app/controllers, il y a le fichier de base HomeController.php.

On crer une fonction showAccueil, qui va contenir toutes les donnes que lon veut
afficher dans la page Accueil.
On cre un array qui va contenir nos donnes de la base de donnes.
On cre une variable qui va aller prendre toutes les donnes de la table 'Menu'

8|Page
TP2 Rapport de veille technologique

On cre une autre variable $data['menu'] qui va tre un array et qui va contenir les
informations quon est all chercher.
Ensuite, ce quon veut retourner, ce sont les donnes quon a rcuprer de la base
de donnes. return View ::make('accueil')->with(data, $data);

make('accueil') parce quon veut afficher les information dans la page accueil.

Ensuite, comme ce sont les donnes dun tableau que lon veut afficher dans la page, on
doit faire un foreach qui va parcourir notre tableau, celui de $menu.

$value->nomMenu : nomMenu est le titre dune catgorie dans la table Menu. On veut afficher
chaque nom dans la table Menu.

Si a avait t le idMenu quon aurait voulu faire afficher, a aurait t :

$value->idMenu

V. Routes

Dans le fichier Homecontroller.php, il nous donne dj la ligne mettre dans le

routes.php.

Comme je fais un exemple rapide, il ny a quune seule route ici. Cependant, on peut en
mettre plusieurs quand on a plusieurs pages.

9|Page
TP2 Rapport de veille technologique

VI. Crer la vue

Il nous reste maintenant seulement crer la vue!

Dans le dossier app/views, on se crer un fichier .php qui contiendra du html5 dedans.
On commence par crer une page bien simple, avec un head et un body.

Il ne faut pas oublier de rajouter le <!DOCTYPE html> pour que le html5 soit reconnu.

Comme cest un menu que je veux faire afficher, je vais le mettre dans un <ul> et chaque
donne dans un <li>.

Il faut galement parcourir notre tableau qui contient les noms du menu pour laffichage. a
nous prend donc un autre foreach.

On peut remarquer quici, le foreach nest pas traditionnel. Effectivement, Laravel a sa propre
syntaxe qui facilite la visibilit des informations dans le code. Cependant, pour pouvoir
bnfici ce systme, il faut utiliser les blades

Pour ce faire, il suffit de rajouter au fichier .blade.php et le tour est jou!

10 | P a g e
TP2 Rapport de veille technologique

Et maintenant, si on retourne sur notre site, on devrait voir la liste de notre menu!

Maintenant, votre site est prt tre personnalis!

Autres informations

Laravel permet de faire beaucoup plus mais ceci est seulement un tutoriel pour vous
aider dbuter avec Laravel. Cependant, je vous conseille fortement de regarder :

Blade template
Systme dutilisateur
Systme de connexion
Less ( utiliser avec pour le CSS)

11 | P a g e
TP2 Rapport de veille technologique

Sources dinformations

Voici les sites qui mont vraiment aid dans ma recherche :

1. Cest le site officiel de Laravel. Il est le plus important parce quil contient toutes les
documentations ncessaires pour utiliser plein potentiel ce Framework. Il nous montre
galement comment dmarrer avec Laravel.
Laravel, Introduction, [En ligne] http://laravel.com/docs/introduction (Page consulte
le 25 mars 2014).
2. Cest le forum officiel de Laravel. On peut retrouver beaucoup daide et a nous aide
comprendre mieux.
Laravel.io, Forum , [En ligne] http://laravel.io/forum (Page consulte le 25 mars 2014).
3. Ce site contient plusieurs tutoriels. Certains tutoriels de Jeffrey Way sont pour aider
mieux comprendre Laravel et ils sont trs bien fait et il explique trs bien.
Tutsplus, Jeffrey Way, [En ligne] https://tutsplus.com/author/jeffreyway/ (Page
consulte le 25 mars 2014).
4. Pour bien comprendre Laravel, il faut que je comprenne dabord ce quest un
Composer puisquil se base sur a pour grer les projets.
Getcomposer, Getting Started, [En ligne] https://getcomposer.org/doc/00-intro.md
(Page consulte le 7 fvrier 2014).
5. Ce site montre comment utiliser Blade de Laravel.
Runnable, Introducting to the Blade template engine [PHP and Laravel], [En ligne]
http://runnable.com/UnApmfCNV4lmAAAz/-introducting-to-the-blade-template-
engine-for-php-and-laravel (Page consulte le 25 mars 2014).
6. Comme Laravel se base sur le modle MVC, il est fondamental de bien comprendre ce
que cest.
Wikipdia, Modle-vue-contrleur, [En ligne]
http://fr.wikipedia.org/wiki/Mod%C3%A8le-vue-contr%C3%B4leur (Page consulte le
7 fvrier 2014).

12 | P a g e