> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.
# Installation
> Comment installer Laravel et configurer un environnement PHP.
## 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.
```shell macOS theme={null}
/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.4)"
```
```powershell Windows (exécuter en tant qu'administrateur) theme={null}
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'))
```
```shell Linux theme={null}
/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.
```shell theme={null}
composer global require laravel/installer
```
Si vous préférez un outil graphique pour gérer PHP, consultez également [Laravel Herd](#installation-avec-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.
```shell theme={null}
laravel new example-app
```
Une fois l'application créée, démarrez le serveur de développement avec le script Composer `dev`.
```shell theme={null}
cd example-app
npm install && npm run build
composer run dev
```
Lorsque le serveur est démarré, ouvrez [http://localhost:8000](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](https://inertiajs.com). Il adopte React 19, TypeScript, Tailwind et [shadcn/ui](https://ui.shadcn.com), et offre une architecture moderne combinant SPA et routage côté serveur.
Kit de démarrage avec un frontend Vue utilisant [Inertia](https://inertiajs.com). Il adopte la Composition API de Vue, TypeScript, Tailwind et [shadcn-vue](https://www.shadcn-vue.com/).
Kit de démarrage avec un frontend Svelte utilisant [Inertia](https://inertiajs.com). Il adopte Svelte 5, TypeScript, Tailwind et [shadcn-svelte](https://www.shadcn-svelte.com/).
Kit de démarrage utilisant [Laravel Livewire](https://livewire.laravel.com). 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](https://fluxui.dev).
Si vous hésitez sur la configuration à choisir, consultez d'abord [Frontend](/fr/frontend) pour comprendre les différences entre Blade, Livewire, Inertia et SPA.
## Installation avec Laravel Herd
[Laravel Herd](https://herd.laravel.com) 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](https://herd.laravel.com).
2. Exécutez l'installateur, qui configure PHP automatiquement.
3. Le répertoire `~/Herd` est défini comme répertoire « park ».
```shell theme={null}
cd ~/Herd
laravel new my-app
cd my-app
herd open
```
### Windows
1. Téléchargez l'installateur Windows depuis [le site de Herd](https://herd.laravel.com/windows).
2. Lancez Herd après installation et complétez le processus d'onboarding.
3. Le répertoire `%USERPROFILE%\Herd` sert de répertoire « park ».
```shell theme={null}
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`.
```ini theme={null}
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.
```shell theme={null}
php artisan migrate
```
## Support IDE
Installez l'[extension officielle Laravel VS Code](https://marketplace.visualstudio.com/items?itemName=laravel.vscode-laravel) 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](https://www.jetbrains.com/phpstorm/laravel/) 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
Comprenez les principaux répertoires et fichiers d'un projet Laravel.
## Related topics
- [Laravel Console Starter](/fr/packages/laravel-console-starter/index.md)
- [Broadcasting](/fr/broadcasting.md)
- [Laravel Passport (implémentation d'un serveur OAuth2)](/fr/passport.md)
- [Laravel Reverb](/fr/reverb.md)
- [Laravel Cloud - GitHub Copilot SDK pour Laravel](/fr/packages/laravel-copilot-sdk/laravel-cloud.md)