Avant d'installer pour la première fois Laravel, vous devez être sûr que votre ordinateur possède bien tous les logiciels requis : PHP >= 7.0 et les extensions OpenSSL, PDO, Mbstring et Tokenizer. Je recommande pour une nouvelle machine d'installer directement PHP 7.1 afin de ne pas prendre de retard sur les mises à jour.
L'objectif de ce chapitre est d'obtenir une installation fonctionnelle avec Ubuntu où il est possible, en ligne de commande et sans erreur, d'écrire :
php --version
composer --version
Installation de PHP et de Composer
Installation de PHP
Les extensions OpenSSL et Tokenizer sont déjà intégrées dans PHP. Nous allons installer uniquement php-cli
car nous n'avons pas besoin du programme apache
qui est installé automatiquement avec le paquet php
simple.
sudo apt install php-cli php-mbstring php-xml
Installation de Composer
Composer est le gestionnaire de dépendances de PHP. Il permet de télécharger des bibliothèques pour gérer par exemple les dates (avec Carbon) ou les paiements Paypal (avec leur bibliothèque PayPal PHP SDK). Composer permet également de créer des projets Laravel et de télécharger le framework. Le framework Laravel est d'ailleurs un simple assemblage de plusieurs dizaines de bibliothèques.
Pour installer Composer :
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
sudo php composer-setup.php --filename=composer --install-dir=/usr/local/bin
sudo
, permet d'obtenir les droits administrateurs car le dossier /usr/local/bin
n'est pas accessible sans les droits administrateur.
Vérifications
Félicitation ! Vous avez réussi à installer toutes les dépendances ! Pour vérifier que tout fonctionne vous pouvez demander les version de tous les programmes que vous avez installés :
php --version
composer --version
Création de notre premier projet
Tout est prêt pour créer notre premier projet Laravel. Nous allons utiliser Composer pour télécharger Laravel :
composer create-project --prefer-dist laravel/laravel blog
Si tout fonctionne normalement, Composer devrait avoir créé un dossier blog
dans le dossier courant. Vous devriez pouvoir lister les fichiers et les dossiers de Laravel via ls blog
et lancer le serveur de développement via :
cd blog
php artisan serve
Si php artisan serve
affiche « Laravel development server started on http://127.0.0.1:8000/ », tout est bon ! Vous pouvez vous rendre sur votre application.
Petite note, après avoir tapé php artisan serve
vous ne pouvez plus écrire de commande dans cette fenêtre. Deux choix sont possibles :
- ouvrir une nouvelle fenêtre ou un nouvel onglet avec « Ctrl-Maj-t »
- quitter le serveur local pour reprendre la main sur la fenêtre courante avec la combinaison de touches « Ctrl-c » (attention il faudra relancer
php artisan serve
pour pouvoir voir votre application sur http://127.0.0.1:8000)
Quel éditeur de code utiliser ?
Vous pouvez utiliser l'éditeur de votre choix pour suivre ce guide. Je vous conseille d'utiliser Atom qui est un très bon éditeur avec une communautée très active. Rendez-vous sur https://atom.io, et suivez les instructions pour installer ce programme.