Passer au contenu principal

​
Prérequis

Avant de commencer avec Laravel, les éléments suivants sont requis :
  • PHP 8.3 ou supérieur
  • Composer (gestionnaire de paquets PHP)
  • Installateur Laravel (optionnel mais recommandé)
Node.js/npm ou Bun est également nécessaire pour compiler les assets frontend.

​
Installation de PHP et de l’installateur Laravel

Le moyen le plus simple d’installer PHP, Composer et l’installateur Laravel en une seule commande est d’exécuter la commande correspondant à votre système d’exploitation. 
/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.4)"

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://php.new/install/windows/8.4'))

/bin/bash -c "$(curl -fsSL https://php.new/install/linux/8.4)"
Après l’exécution de la commande, redémarrez votre session de terminal. Si vous avez déjà installé PHP et Composer, vous pouvez installer uniquement l’installateur Laravel via Composer. 
composer global require laravel/installer
Si vous préférez un outil graphique pour gérer PHP, consultez également Laravel Herd.

​
Création d’une nouvelle application Laravel

Une fois PHP, Composer et l’installateur Laravel installés, créez une nouvelle application Laravel. L’installateur vous invite à choisir le framework de test, la base de données et le kit de démarrage. 
laravel new example-app
Une fois l’application créée, démarrez le serveur de développement avec le script Composer dev. 
cd example-app
npm install && npm run build
composer run dev
Lorsque le serveur est démarré, ouvrez http://localhost:8000 dans votre navigateur.
Les kits de démarrage génèrent automatiquement un squelette de base incluant l’authentification. Sous Laravel 13, vous pouvez choisir parmi quatre options : React, Vue, Svelte et Livewire.

​
Choix du kit de démarrage

Lors de l’exécution de laravel new, vous pouvez choisir parmi les kits suivants.
Kit de démarrage avec un frontend React utilisant Inertia. Il adopte React 19, TypeScript, Tailwind et shadcn/ui, et offre une architecture moderne combinant SPA et routage côté serveur.
Kit de démarrage avec un frontend Vue utilisant Inertia. Il adopte la Composition API de Vue, TypeScript, Tailwind et shadcn-vue.
Kit de démarrage avec un frontend Svelte utilisant Inertia. Il adopte Svelte 5, TypeScript, Tailwind et shadcn-svelte.
Kit de démarrage utilisant Laravel Livewire. Vous pouvez construire des UI dynamiques uniquement en PHP, ce qui convient parfaitement aux équipes utilisant principalement les templates Blade. Il adopte Tailwind et Flux UI.
Si vous hésitez sur la configuration à choisir, consultez d’abord Frontend pour comprendre les différences entre Blade, Livewire, Inertia et SPA.

​
Installation avec Laravel Herd

Laravel Herd est un environnement de développement natif pour Laravel/PHP sur macOS et Windows. Il installe PHP, Nginx et le CLI Laravel d’un coup.

​
macOS

  1. Téléchargez l’installateur depuis le site de Herd.
  2. Exécutez l’installateur, qui configure PHP automatiquement.
  3. Le répertoire ~/Herd est défini comme répertoire « park ».
cd ~/Herd
laravel new my-app
cd my-app
herd open

​
Windows

  1. Téléchargez l’installateur Windows depuis le site de Herd.
  2. Lancez Herd après installation et complétez le processus d’onboarding.
  3. Le répertoire %USERPROFILE%\Herd sert de répertoire « park ».
cd ~\Herd
laravel new my-app
cd my-app
herd open

​
Configuration initiale

​
Configuration d’environnement

De nombreuses valeurs de configuration Laravel diffèrent selon l’environnement. Elles sont donc gérées dans le fichier .env à la racine du projet.
Ne versionnez pas le fichier .env. Cela expose vos informations sensibles.

​
Configuration de la base de données

Par défaut, Laravel est configuré pour utiliser SQLite. Pour utiliser MySQL ou PostgreSQL, mettez à jour le fichier .env. 
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=
Pour une base autre que SQLite, exécutez les migrations pour créer les tables. 
php artisan migrate

​
Support IDE

Installez l’extension officielle Laravel VS Code pour bénéficier de la coloration syntaxique, des snippets, de l’intégration des commandes Artisan et de l’autocomplétion intelligente des modèles Eloquent.
PhpStorm possède un support intégré du framework Laravel avec autocomplétion intelligente pour les templates Blade, les modèles Eloquent, les routes, les vues et les traductions.

​
Prochaines étapes

Structure des répertoires

Comprenez les principaux répertoires et fichiers d’un projet Laravel.
Dernière modification le 13 juillet 2026

Sujets connexes

Laravel Console StarterBroadcastingLaravel Passport (implémentation d'un serveur OAuth2)Laravel ReverbLaravel Cloud - GitHub Copilot SDK pour Laravel