Installation

Découvrez Laravel

Laravel est un cadre d'applications Web doté d'une syntaxe expressive et élégante. Un cadre d'application Web fournit une structure et un point de départ pour la création de votre application, vous permettant ainsi de vous concentrer sur la création d'un projet exceptionnel pendant que nous prenons en charge les détails techniques.

Laravel s'efforce d'offrir une expérience de développement optimale grâce à des fonctionnalités puissantes telles qu'une injection de dépendances complète, une couche d'abstraction de base de données expressive, la gestion des files d'attente et des tâches planifiées, les tests unitaires et d'intégration, et bien plus encore.

Que vous soyez novice en matière de cadre d'application Web PHP ou que vous ayez des années d'expérience, Laravel est un cadre d'application évoluant avec vous.

Pourquoi Laravel ?

De nombreux outils, langages et cadres d'applications sont aujourd'hui disponibles pour concevoir et développer des applications Web. Face à cette abondance de solutions, il peut être difficile de déterminer quel environnement répond le mieux aux exigences modernes en matière de performance, de maintenabilité et d'évolutivité. Les créateurs de Laravel affirment cependant avec conviction que leur cadre d'application constitue l'un des meilleurs choix pour bâtir des applications Web complètes, robustes et adaptées aux standards actuels du développement.

Laravel se distingue par sa philosophie axée sur la simplicité, l'élégance du code et la productivité des développeurs. Il propose une structure claire et cohérente qui facilite l'organisation des projets, tout en offrant une grande liberté d'implémentation. Cette approche permet de concevoir aussi bien de petites applications que des plateformes Web complexes destinées à un usage professionnel ou à grande échelle.

Un cadre d'application progressif

Les concepteurs de Laravel qualifient leur cadre d'application de cadre d'application «progressif». Cette notion signifie que Laravel est pensé pour évoluer en même temps que le développeur et s'adapter à son niveau de compétence. Pour les débutants en développement Web, Laravel met à disposition une documentation extrêmement riche, claire et bien structurée, accompagnée de guides pas à pas et de nombreux tutoriels vidéo. Ces ressources permettent d'assimiler progressivement les concepts fondamentaux sans être submergé par une complexité excessive.

À mesure que l'expérience du développeur augmente, Laravel révèle toute la puissance de son écosystème. Il offre des outils avancés pour l'injection de dépendances, la gestion des tests unitaires, le traitement asynchrone via les files d'attente, ainsi que la gestion d'événements en temps réel. Ces fonctionnalités facilitent la création d'architectures propres, testables et évolutives. Grâce à cette richesse fonctionnelle, Laravel s'impose comme une solution parfaitement adaptée au développement d'applications Web professionnelles, capables de supporter des charges importantes et de répondre aux exigences des environnements d'entreprise modernes.

Un cadre d'application évolutif

Laravel est incroyablement évolutif. Grâce à la nature même de PHP, facilitant la mise à l'échelle, et à la prise en charge native par Laravel de systèmes de cache distribués et rapides comme Redis, la mise à l'échelle horizontale avec Laravel est un jeu d'enfant. En effet, des applications Laravel ont été facilement dimensionnées pour gérer des centaines de millions de requêtes par mois.

Besoin d'une évolutivité extrême ? Des plateformes comme Laravel Cloud vous permettent d'exécuter votre application Laravel à une échelle quasi illimitée.

Un cadre d'application prêt pour les agents

Grâce à ses conventions bien définies et à sa structure rigoureuse, Laravel est un cadre d'application idéal pour le développement assisté par l'IA avec des outils comme Cursor et Claude Code. Lorsqu'un agent IA doit ajouter un contrôleur, il sait précisément où le placer. De même, lors d'une nouvelle migration, les conventions de nommage et l'emplacement des fichiers sont prévisibles. Cette cohérence élimine les approximations posant souvent problème aux outils d'IA dans des cadres d'applications plus flexibles.

Outre l'organisation des fichiers, la syntaxe expressive et la documentation complète de Laravel fournissent aux agents IA le contexte nécessaire pour générer un code précis et idiomatique. Des fonctionnalités comme les relations Eloquent, les requêtes de formulaire et les middlewares suivent des modèles que les agents peuvent comprendre et reproduire avec fiabilité. Le résultat ? Un code généré par l'IA ressemblant à celui écrit par un développeur Laravel expérimenté, et non à un assemblage de fragments PHP génériques.

Un cadre d'application communautaire

Laravel combine les meilleurs paquets de l'écosystème PHP pour offrir le cadre d'application le plus robuste et le plus convivial pour les développeurs. De plus, des milliers de développeurs talentueux du monde entier ont contribué à son développement.

Création d'une application Laravel

Installation de PHP et de l'installateur Laravel

Avant de créer votre première application Laravel, assurez-vous que PHP, Composer et l'installateur Laravel sont installés sur votre machine. De plus, vous devez installer Node.js et npm, ou Bun, afin de pouvoir compiler les ressources frontend de votre application.

Si PHP et Composer ne sont pas installés sur votre machine, les commandes suivantes permettent de les installer sur macOS :

sous Windows :

ou sous Linux :

Après avoir exécuté l'une des commandes ci-dessus, redémarrez votre session de terminal. Pour mettre à jour PHP, Composer et l'installateur Laravel après leur installation via php.new, vous pouvez réexécuter la commande dans votre terminal.

Si PHP et Composer sont déjà installés, vous pouvez installer l'installateur Laravel via Composer :

Pour une expérience d'installation et de gestion PHP graphique et complète, découvrez Laravel Herd.

Création d'une application

Après avoir installé PHP, Composer et l'installateur Laravel, vous pouvez créer une nouvelle application Laravel. L'installateur Laravel vous invitera à choisir votre cadre d'application de test, votre base de données et votre ensemble de démarrage :

Une fois l'application créée, vous pouvez démarrer le serveur de développement local de Laravel, le gestionnaire de files d'attente et le serveur de développement Vite à l'aide du script Composer dev :

Une fois le serveur de développement démarré, votre application sera accessible dans votre navigateur web à l'adresse http://localhost:8000. Vous pouvez alors explorer l'écosystème Laravel. Bien sûr, vous pouvez également configurer une base de données.

Pour faciliter le développement de votre application Laravel, pensez à utiliser l'un des ensembles de démarrage. Ces ensembles fournissent la structure d'authentification côté serveur et côté client pour votre nouvelle application Laravel.

Configuration initiale

Tous les fichiers de configuration du cadre d'application Laravel se trouvent dans le répertoire `config`. Chaque option est documentée ; n'hésitez pas à consulter les fichiers pour vous familiariser avec les options disponibles.

Laravel ne nécessite quasiment aucune configuration supplémentaire par défaut. Vous pouvez commencer à développer immédiatement ! Toutefois, nous vous recommandons de consulter le fichier `config/app.php` et sa documentation. Il contient plusieurs options, telles que `url` et `locale`, que vous pouvez modifier en fonction de votre application.

Configuration basée sur l'environnement

Comme de nombreuses options de configuration de Laravel peuvent varier selon que votre application s'exécute en local ou sur un serveur web de production, plusieurs paramètres importants sont définis dans le fichier `.env` situé à la racine de votre application.

Il est déconseillé d'inclure ce fichier `.env` dans le système de gestion de versions de votre application, car chaque développeur ou serveur utilisant votre application peut nécessiter une configuration d'environnement différente. De plus, cela représenterait un risque de sécurité si un intrus accédait à votre dépôt de contrôle de version, car toutes les informations d'identification sensibles seraient exposées.

Pour plus d'informations sur le fichier `.env` et la configuration basée sur l'environnement, consultez la documentation complète.

Bases de données et migrations

Maintenant que vous avez créé votre application Laravel, vous souhaitez probablement entreposer des données dans une base de données. Par défaut, le fichier de configuration `.env` de votre application spécifie que Laravel interagira avec une base de données SQLite.

Lors de la création de l'application, Laravel a créé un fichier `database/database.sqlite` et a exécuté les migrations nécessaires pour créer les tables de la base de données.

Si vous préférez utiliser un autre pilote de base de données, tel que MySQL ou PostgreSQL, vous pouvez modifier votre fichier de configuration `.env` en conséquence. Par exemple, si vous souhaitez utiliser MySQL, modifiez les variables `DB_*` de votre fichier de configuration `.env` comme suit :

Si vous choisissez d'utiliser une base de données autre que SQLite, vous devrez créer la base de données et exécuter les migrations de base de données de votre application :

Si vous développez sous macOS ou Windows et que vous devez installer MySQL, PostgreSQL ou Redis localement, envisagez d'utiliser Herd Pro ou DBngin.

Configuration des répertoires

Laravel doit toujours être servi depuis la racine du répertoire «web» configuré sur votre serveur Web. Il est fortement déconseillé de servir une application Laravel depuis un sous-répertoire de ce répertoire. Cela pourrait exposer des fichiers sensibles contenus dans votre application.

Installation avec Herd

Laravel Herd est un environnement de développement Laravel et PHP natif et ultra-rapide pour macOS et Windows. Herd inclut tout le nécessaire pour débuter avec Laravel, notamment PHP et Nginx.

Une fois Herd installé, vous êtes prêt à développer avec Laravel. Herd intègre des outils en ligne de commande pour PHP, Composer, Laravel, Expose, Node.js, npm et nvm.

Herd Pro enrichit Herd de fonctionnalités puissantes supplémentaires, telles que la création et la gestion de bases de données locales MySQL, PostgreSQL et Redis, ainsi que la consultation des courriels et la surveillance des journaux.

Herd sur macOS

Si vous développez sous macOS, vous pouvez télécharger le programme d'installation de Herd depuis le site web de Herd. Ce programme télécharge automatiquement la dernière version de PHP et configure votre Mac pour que Nginx s'exécute en permanence en arrière-plan.

Herd pour macOS utilise dnsmasq pour la gestion des répertoires «parked». Toute application Laravel placée dans un répertoire «parked» sera automatiquement servie par Herd. Par défaut, Herd crée un répertoire «parked» dans ~/Herd. Vous pouvez accéder à toute application Laravel présente dans ce répertoire sur le domaine .test en utilisant son nom.

Après avoir installé Herd, la méthode la plus rapide pour créer une nouvelle application Laravel consiste à utiliser l'interface de ligne de commande Laravel (CLI), fournie avec Herd :

Bien sûr, vous pouvez toujours gérer vos répertoires en attente et autres paramètres PHP via l'interface utilisateur de Herd, accessible depuis le menu Herd dans la barre d'état système.

Pour en savoir plus sur Herd, consultez sa documentation.

Herd sur Windows

Vous pouvez télécharger le programme d'installation Windows de Herd sur le site web de Herd. Une fois l'installation terminée, lancez Herd pour finaliser la configuration et accéder à l'interface utilisateur pour la première fois.

L'interface utilisateur de Herd est accessible en cliquant sur l'icône Herd dans la barre d'état système. Un clic droit ouvre le menu contextuel donnant accès à tous les outils nécessaires au quotidien.

Lors de l'installation, Herd crée un répertoire «parked» dans votre répertoire personnel, à l'emplacement %USERPROFILE%\Herd. Toute application Laravel présente dans ce répertoire sera automatiquement servie par Herd, et vous pourrez y accéder sur le domaine .test en utilisant son nom.

Après avoir installé Herd, la méthode la plus rapide pour créer une nouvelle application Laravel consiste à utiliser l'interface de ligne de commande Laravel (CLI), fournie avec Herd. Pour commencer, ouvrez PowerShell et exécutez les commandes suivantes :

Pour en savoir plus sur Herd, consultez la documentation Herd pour Windows.

Compatibilité avec les IDE

Vous êtes libre d'utiliser l'éditeur de code de votre choix pour développer des applications Laravel. Si vous recherchez un éditeur léger et extensible, VS Code ou Cursor, associés à l'extension officielle Laravel pour VS Code, offrent une excellente prise en charge de Laravel grâce à des fonctionnalités telles que la coloration syntaxique, les extraits de code, l'intégration des commandes Artisan et la saisie semi-automatique intelligente pour les modèles, routes, middlewares, assets, configurations et Inertia.js d'Eloquent.

Pour une prise en charge complète et performante de Laravel, découvrez PhpStorm, un IDE de JetBrains. La prise en charge intégrée du cadre d'application Laravel par PhpStorm inclut les gabarits Blade, la saisie semi-automatique intelligente pour les modèles, routes, vues, traductions et composants Eloquent, ainsi qu'une génération de code et une navigation performantes au sein des projets Laravel.

Pour ceux recherchant une expérience de développement dans l'infonuagique, Firebase Studio permet d'accéder instantanément à la création d'applications Laravel directement dans votre navigateur. Sans aucune configuration requise, Firebase Studio facilite la création d'applications Laravel depuis n'importe quel appareil.

Laravel et l'IA

Laravel Boost est un outil puissant facilitant la communication entre les agents de programmation IA et les applications Laravel. Boost fournit aux agents IA le contexte, les outils et les bonnes pratiques spécifiques à Laravel, leur permettant ainsi de générer un code plus précis, adapté à la version et respectant les conventions Laravel.

Lorsque vous installez Boost dans votre application Laravel, les agents IA accèdent à plus de 15 outils spécialisés. Ils peuvent notamment identifier les paquets utilisés, interroger votre base de données, consulter la documentation Laravel, lire les journaux du navigateur, générer des tests et exécuter du code via Tinker.

De plus, Boost donne accès aux agents IA à plus de 17 000 documents vectorisés de l'écosystème Laravel, spécifiques aux versions de vos paquets installés. Les agents peuvent ainsi fournir des conseils ciblés sur les versions exactes utilisées par votre projet.

Boost inclut également des bonnes pratiques IA maintenues par Laravel, qui aident les agents à respecter les conventions du cadre d'application, à écrire des tests appropriés et à éviter les pièges courants lors de la génération de code Laravel.

Installation de Laravel Boost

Boost peut être installé dans les applications Laravel 10, 11 et 12 exécutant PHP 8.1 ou une version ultérieure. Pour commencer, installez Boost comme dépendance de développement :

Une fois installé, exécutez le programme d'installation interactif :

Le programme d'installation détectera automatiquement votre IDE et vos agents d'IA, vous permettant ainsi de choisir les fonctionnalités les plus pertinentes pour votre projet. Boost respecte les conventions existantes et n'impose pas de règles de style par défaut.

Pour en savoir plus sur Boost, consultez le dépôt Laravel Boost sur GitHub.

Ajout de règles d'IA personnalisées

Pour intégrer vos propres règles d'IA personnalisées à Laravel Boost, ajoutez les fichiers .blade.php ou .md au répertoire .ai/guidelines/* de votre application. Ces fichiers seront automatiquement inclus dans les règles de Laravel Boost lors de l'exécution de la commande boost:install.

Étapes suivantes

Maintenant que vous avez créé votre application Laravel, vous vous demandez peut-être quelles sont les prochaines étapes à explorer. Il est vivement recommandez de commencer par vous familiariser avec le fonctionnement de Laravel en consultant la documentation suivante :

• Cycle de vie des requêtes
• Configuration
• Structure des répertoires
• Interface utilisateur
• Conteneur de services
• Facades

La manière dont vous souhaitez utiliser Laravel déterminera également les prochaines étapes de votre parcours. Il existe différentes façons d'utiliser Laravel, et nous explorerons ci-dessous deux cas d'utilisation principaux de ce cadre d'application.

Laravel, le cadre d'application complet

Laravel peut servir de cadre d'application complet. Par «cadre d'application complet», nous entendons que vous utiliserez Laravel pour acheminer les requêtes vers votre application et afficher votre interface utilisateur via des gabarits Blade ou une technologie hybride monopage (SPA) comme Inertia. C'est l'utilisation la plus courante et, selon les concepteurs de Laravel, la plus productive de Laravel.

Si vous envisagez d'utiliser Laravel de cette manière, il est recommandez de consulter la documentation sur le développement frontend, le routage, les vues et l'ORM Eloquent. Vous pourriez également être intéressé par des paquets communautaires tels que Livewire et Inertia. Ces paquets vous permettent d'utiliser Laravel comme un cadre d'application complet tout en profitant des nombreux avantages d'interface utilisateur offerts par les applications JavaScript monopages.

Si vous utilisez Laravel comme cadre d'application complet, les concepteurs de Laravel recommande vivement d'apprendre à compiler le CSS et le JavaScript de votre application avec Vite.

Si vous souhaitez prendre de l'avance dans la création de votre application, consultez l'un de leurs ensembles de démarrage officiels.

Laravel comme backend d'API

Laravel peut également servir de backend d'API pour une application monopage JavaScript ou une application mobile. Par exemple, vous pouvez utiliser Laravel comme backend d'API pour votre application Next.js. Dans ce cas, Laravel vous permet de gérer l'authentification et l'entreposage/la récupération des données de votre application, tout en tirant parti de ses puissants services tels que les files d'attente, les courriels, les notifications,...

Si vous envisagez d'utiliser Laravel de cette manière, il est recommandé de consulter la documentation sur le routage, Laravel Sanctum et l'ORM Eloquent.