II. Chapitre 2 : Installation▲
Nous avons vu précédemment où trouver le paquetage d'installation. Voyons à présent comment l'installer et le configurer.
II-A. Prérequis▲
Laravel nécessite un serveur Apache avec au minimum PHP 5.3 et l'extension Mcrypt.
Vous pouvez installer en local un pack comme Wamp (c'est celui que j'utilise personnellement), Xampp ou EasyPHP.
Vérifiez que vous avez l'extension Mcrypt activée.
II-A-1. Composer▲
Laravel 4 utilise Composer, un gestionnaire de dépendances, pour son installation.
Les frameworks sont composés de nombreux éléments et utilisent souvent des applications « tierces », c'est-à-dire qui sont développées dans le cadre d'autres projets. Ces applications peuvent avoir elles-mêmes d'autres applications « tierces ». Avoir en permanence tous ces éléments à jour est un défi qui n'est pas facile à assumer dans le cadre d'un paquetage figé. C'est pour cette raison que les gestionnaires de dépendances ont été créés.
L'objectif d'un gestionnaire de dépendances est de télécharger les dernières versions de ces applications et de les conserver à jour. Composer est le gestionnaire le plus récent et sans aucun doute le plus abouti, en tout cas c'est celui qui a été choisi pour l'installation de Laravel. Il offre aussi l'avantage de créer un fichier pour générer automatiquement des références de chargement automatique de classes (Laravel 4 respecte les PSR-0 et PSR-1 du fig-standards). Si le chargement de classe ne vous est pas familier, allez faire un tour sur ce chapitreChapitre 2 : Installation.
Il vous faut donc installer Composer, ce qui est relativement facile. Vous avez toutes les informations requises ici : http://getcomposer.org/doc/00-intro.md.
Composer ne fonctionnera pas si vous n'avez pas Git installé sur votre ordinateur. Vous pouvez télécharger la version correspondant à votre système ici.
Vous n'avez pas besoin de maîtriser ces deux applications pour installer Laravel, nous allons voir les commandes de base pour télécharger les fichiers.
Vérifiez que Composer fonctionne en utilisant simplement la commande composer à partir de l'invite de commande. Vous devez voir apparaître un logo d'accueil ainsi qu'une liste des commandes disponibles :
II-A-2. Installation en un clic▲
II-A-2-a. Méthode 1▲
La façon la plus simple d'installer Laravel est d'utiliser la commande create-project de Composer :
Il suffit d'attendre quelques minutes pour avoir une installation complète !
II-A-2-b. Méthode 2▲
Vous pouvez aussi utiliser l'archive phar de l'installateur de Laravel. Vous la placez sur votre serveur et vous entrez laravel new pour créer directement une nouvelle version de Laravel dans le dossier. Vous pouvez aussi pointer un autre dossier avec laravel new mon_dossier.
II-A-3. Installation plus laborieuse▲
Vous pouvez télécharger le pack de base comme nous l'avons vu au chapitre précédent dans un dossier de votre serveur. Dans mon cas j'ai créé un dossier laravel :
Ouvrez le fichier « composer.json » :
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
{
"name"
:
"laravel/laravel"
,
"description"
:
"The Laravel Framework."
,
"keywords"
:
[
"framework"
,
"laravel"
],
"license"
:
"MIT"
,
"require"
:
{
"laravel/framework"
:
"4.1.*"
},
"autoload"
:
{
"classmap"
:
[
"app/commands"
,
"app/controllers"
,
"app/models"
,
"app/database/migrations"
,
"app/database/seeds"
,
"app/tests/TestCase.php"
]
},
"scripts"
:
{
"post-install-cmd"
:
[
"php artisan optimize"
],
"post-update-cmd"
:
[
"php artisan clear-compiled"
,
"php artisan optimize"
],
"post-create-project-cmd"
:
[
"php artisan key:generate"
]
},
"config"
:
{
"preferred-install"
:
"dist"
},
"minimum-stability"
:
"dev"
}
C'est le fichier qui va indiquer à Composer les applications à télécharger. La clé « require » indique qu'il faut aller chercher le paquetage laravel/framework dans sa version 4.1 la plus récente. Pour sa localisation c'est tout simple, c'est dans Github.com/laravel/framework. Pour la clé autoload, sont inclus les dossiers de Laravel qui nécessitent un chargement automatique des classes.
Pour finir l'installation de Laravel il suffit de taper composer install dans le dossier racine de l'application et d'attendre la fin des téléchargements :
II-A-4. Résultat de l'installation▲
Si on regarde maintenant ce qu'il s'est passé, on découvre un nouveau dossier bien garni :
On trouve en particulier un fichier autoload.php qui est là pour gérer le chargement automatique dont j'ai parlé plus haut.
L'installation est maintenant terminée, vous n'avez plus qu'à vérifier que tout fonctionne en entrant l'URL de votre site et en pointant le répertoire public. Ce qui donne dans mon cas :http://localhost/laravel/public/
Normalement vous obtenez ça :
Si ce n'est pas le cas reprenez tout depuis le début .
Comment mettre à jour Laravel ? Mais c'est d'une simplicité enfantine, il suffit de taper la commande composer update !
Pour l'installation sur un serveur distant il faut disposer d'un accès SSH, il suffit alors d'utiliser composer.phar sur le serveur, si on dispose de toutes les commandes utiles, ce qui n'est pas souvent le cas sur les serveurs mutualisés. Sinon il faut tout transmettre en FTP.