Création de votre premier projet Laravel avec Composer

Composer à la rescousse : initialiser votre application Laravel

Une fois PHP et Composer correctement installés et configurés sur votre système, vous disposez des outils fondamentaux pour donner vie à votre première application Laravel. La méthode la plus directe et universellement recommandée pour créer un nouveau projet Laravel est d'utiliser Composer, votre fidèle gestionnaire de dépendances PHP. Cette approche garantit que vous obtenez la dernière version stable du framework ainsi que toutes ses dépendances nécessaires.

Pour initier la création de votre projet, ouvrez votre terminal ou votre invite de commandes, naviguez jusqu'au répertoire où vous souhaitez créer votre projet (par exemple, un dossier `Sites` ou `projets_web` dans votre répertoire personnel), puis exécutez la commande suivante :

composer create-project laravel/laravel nom-de-votre-projet

Analysons cette commande :

• composer : C'est l'exécutable de Composer.
• create-project : C'est la commande spécifique à Composer pour télécharger un paquet (ici, le squelette d'une application Laravel) et l'installer comme un nouveau projet. Elle clone le dépôt du paquet, puis exécute un composer install pour récupérer toutes les dépendances.
• laravel/laravel : C'est le nom du paquet officiel de Laravel sur Packagist (le principal dépôt de paquets Composer). Il s'agit d'un squelette d'application Laravel.
• nom-de-votre-projet : Remplacez ceci par le nom que vous souhaitez donner à votre projet (par exemple, blog, ma-super-app). Composer créera un nouveau répertoire portant ce nom et y placera tous les fichiers du projet. Evitez les espaces et les caractères spéciaux dans le nom du répertoire.

Lorsque vous lancez cette commande, Composer se met au travail. Il contacte Packagist pour trouver le paquet laravel/laravel, télécharge la dernière version stable du framework, puis installe toutes les bibliothèques et dépendances requises (listées dans le fichier composer.json du squelette Laravel). Ce processus peut prendre quelques minutes en fonction de votre connexion internet et des performances de votre machine. Vous verrez de nombreuses lignes défiler dans votre terminal, indiquant les paquets qui sont téléchargés et installés. Une fois terminé, un message de succès s'affichera, et un nouveau dossier portant le nom de votre projet aura été créé, contenant une installation fraîche de Laravel.

Il est également possible de spécifier une version particulière de Laravel si vous ne souhaitez pas la toute dernière. Par exemple, pour installer une version spécifique de la branche 10.x :

composer create-project laravel/laravel nom-de-votre-projet "10.*"

Cependant, pour démarrer, il est généralement conseillé d'utiliser la dernière version stable implicitement sélectionnée par la commande de base.

Alternative : l'installateur global Laravel pour des créations plus rapides

Bien que la commande composer create-project soit la méthode fondamentale, Laravel propose également un outil d'installation alternatif qui peut s'avérer plus rapide si vous créez fréquemment de nouveaux projets : l'installateur Laravel. Il s'agit d'un petit programme que vous installez globalement sur votre système via Composer une seule fois.

Pour installer l'installateur Laravel, exécutez la commande suivante dans votre terminal :

composer global require laravel/installer

Cette commande télécharge le paquet laravel/installer et le rend disponible globalement. Assurez-vous que le répertoire global des binaires de Composer est bien ajouté à votre variable d'environnement PATH. Ce répertoire est généralement ~/.composer/vendor/bin sur les systèmes Unix (Linux, macOS) ou %USERPROFILE%\AppData\Roaming\Composer\vendor\bin sur Windows (ou C:\Users\VOTRE_NOM\AppData\Roaming\Composer\vendor\bin).

Une fois l'installateur Laravel configuré, la création d'un nouveau projet devient encore plus concise. Naviguez jusqu'à votre répertoire de projets et tapez simplement :

laravel new nom-de-votre-projet

Cette commande accomplit la même tâche que composer create-project, mais elle est souvent perçue comme plus rapide car l'installateur peut utiliser une copie archivée de Laravel qu'il télécharge une seule fois, plutôt que de tout récupérer via Git à chaque création. Le résultat final est identique : un nouveau projet Laravel prêt à l'emploi.

Le choix entre composer create-project et laravel new dépend de vos préférences. Si vous ne créez des projets Laravel qu'occasionnellement, composer create-project est parfaitement suffisant et ne nécessite aucune installation globale supplémentaire. Si vous êtes un développeur Laravel chevronné qui initialise régulièrement de nouveaux projets, l'installateur global peut vous faire gagner un peu de temps à chaque fois. Les deux méthodes sont officiellement supportées et mènent au même résultat.

Félicitations, votre projet Laravel est né !

Que vous ayez utilisé composer create-project ou laravel new, le résultat est le même : un nouveau répertoire portant le nom de votre projet a été créé. A l'intérieur de ce répertoire, vous trouverez une structure de fichiers et de dossiers bien définie, qui constitue l'ossature de toute application Laravel. C'est la base sur laquelle vous allez construire votre application.

Prenez un moment pour apprécier cette étape : vous venez de franchir une étape significative. Votre environnement est prêt, et votre premier projet Laravel est initialisé. C'est le point de départ de nombreuses possibilités, de la création d'un simple blog à la conception d'une application web complexe et robuste. La structure de dossiers peut sembler intimidante au premier abord, mais chaque répertoire a un rôle précis, que nous explorerons prochainement.

La prochaine étape logique, après la création du projet, est de vous familiariser avec cette structure et de lancer votre application pour la première fois. Cela vous permettra de vérifier que tout fonctionne correctement et de voir la page d'accueil par défaut de Laravel. C'est ce que nous allons aborder dans les sections suivantes, en explorant les répertoires clés et en démarrant le serveur de développement intégré.