Installer Laravel : avec ou sans installateur global ?

Objectif : comprendre la différence entre l’installation de Laravel via Composer directement et l’installation via l’installateur global, puis savoir quelle méthode utiliser en pratique.

Environnement nécessaire avant d’installer Laravel

Objectif : s’assurer que tous les outils indispensables au développement avec Laravel sont installés et fonctionnels.

---

PHP (≥ 8.2)

Laravel est un framework basé sur PHP, il faut donc disposer d’une version récente de PHP.

• Version minimale requise : PHP 8.2
• Pour vérifier la version installée :

php -v

Exemple de résultat attendu :

PHP 8.3.12 (cli) (built: Sep 2025)

---

Composer

Composer est le gestionnaire de dépendances PHP.
Laravel utilise Composer pour télécharger toutes ses bibliothèques.

• Vérifiez sa présence avec :

composer -V

Exemple de résultat :

Composer version 2.8.3 2024-11-17 13:13:04

---

Node.js et NPM (ou Bun)

Laravel utilise Vite pour compiler les ressources front-end (CSS, JavaScript, etc.).
Il faut donc installer Node.js et son gestionnaire de paquets NPM (ou l’alternative Bun).

• Vérifiez les versions installées :

node -v
npm -v

Exemple de sortie :

node v20.10.0
npm 10.2.3

 

---

1. Deux méthodes possibles pour installer Laravel

Laravel peut être installé de deux façons :

1. Avec l’installateur global (méthode rapide et réutilisable)
2. Avec Composer directement (méthode recommandée pour l’apprentissage et la fiabilité)

---

2. Méthode 1 – Installer l’outil Laravel globalement

La documentation officielle de Laravel propose cette commande :

composer global require laravel/installer

Cette commande installe un petit programme appelé Laravel Installer sur ton ordinateur.
Il te permet ensuite de créer un nouveau projet Laravel depuis n’importe quel dossier avec une commande courte :

laravel new monprojet

✅ Avantages

• Création très rapide de nouveaux projets Laravel.
• Fonctionne depuis n’importe quel dossier.
• Utile pour les développeurs qui créent souvent de nouveaux projets.

⚠️ Inconvénients

• Nécessite d’ajouter le chemin global de Composer (~/.composer/vendor/bin) au PATH.
• Peut poser des problèmes si plusieurs versions de Laravel coexistent.
• Demande des mises à jour manuelles de l’installateur global.

---

3. Méthode 2 – Installer Laravel directement avec Composer

La méthode la plus simple et la plus sûre consiste à créer ton projet Laravel directement via Composer :

composer create-project laravel/laravel monprojet

Composer va alors :

• Télécharger la dernière version stable de Laravel.
• Créer automatiquement le dossier du projet.
• Installer toutes les dépendances nécessaires.

✅ Avantages

• Pas de configuration globale nécessaire.
• Toujours la version la plus récente du framework.
• Aucune gestion du PATH ou de variables système.
• Parfait pour les étudiants et les environnements pédagogiques.

⚠️ Inconvénient mineur

• Téléchargement complet de Laravel à chaque création (un peu plus long).

---

4. Comparaison rapide

Critère	Installateur global	Via Composer direct
Commande d’installation	composer global require laravel/installer	composer create-project laravel/laravel monprojet
Création d’un projet	laravel new monprojet	composer create-project ...
Configuration du PATH	Oui ❌	Non ✅
Version toujours à jour	Non (nécessite mise à jour manuelle)	Oui, version la plus récente
Recommandé pour les étudiants	❌	✅

---

Méthode retenue pour nos cours

Pour un usage en BTS SIO option SLAM (ou pour tout développeur débutant), la méthode la plus simple, stable et compatible est :

composer create-project laravel/laravel monprojet

✅ Avantages de cette méthode :

• Aucune configuration globale à faire.
• Pas de problème de version ou de mise à jour.
• Compatible sur tous les systèmes (Windows, macOS, Linux).
• Recommandée par la majorité des formateurs et écoles.

Une fois le projet créé, il suffit de se rendre dans le dossier :

cd monprojet
php artisan serve

Et ton application Laravel sera accessible à l’adresse :

http://127.0.0.1:8000