Cours Laravel 13 – les bases – un environnement de développement

Pour fonctionner, Laravel requiert un environnement spécifique. Il requiert notamment un serveur, PHP, SQLite ou MySQL, Node avec NPM et Composer. De plus en plus d'environnements cloud sont disponibles, avec des options gratuites comme c9. Cependant, rien ne vaut un bon système local : c'est rapide, sûr, et vous avez un contrôle total. Mais il faut évidemment le configurer !

Heureusement, il existe des solutions toutes prêtes. Par exemple, pour PHP + MySQL, vous pouvez utiliser WampServer ou XAMPP.

Ces solutions sont intéressantes, mais pour ce cours, je vous recommande plutôt Laragon. Il est simple, rapide, convivial, non intrusif, complet et spécialement conçu pour Laravel ! Cependant, il ne fonctionne que sous Windows.

Les utilisateurs de Linux peuvent se tourner vers l'une des solutions mentionnées précédemment ou vers Homestead, l'environnement officiel de Laravel. L'installation de Homestead est bien documentée et relativement simple. En revanche, je déconseille aux utilisateurs de Windows d'installer Homestead, sauf s'ils sont prêts à consacrer de longues heures à la configuration de leur système.

Pour les utilisateurs de Mac, Valet est la solution idéale. Il s'agit d'un outil de développement minimaliste pour Mac qui configure votre environnement PHP en quelques minutes.

En résumé :

Pour Windows : Laragon
Pour Linux : Homestead
Pour Mac : Valet

Ces outils vous permettront de mettre en place un environnement de développement Laravel efficace et adapté à votre système d'exploitation.

Laragon

Installation

Pour récupérer Laragon, il faut se rendre sur le site :

Ne cherchez pas de documentation (il n'y en a pas vraiment besoin), mais sachez qu'il y a surtout un bouton pour accéder au forum de discussion et un autre pour télécharger le logiciel. Vous verrez qu'il existe plusieurs possibilités de téléchargement. Choisissez celle qui vous convient, par exemple Laragon full, qui comprend Apache 2.4, Nginx, MySQL 9.4/8.4, PHP 8.5/8.4/8.3/8.2/8.1, Node.js 25/24/23/22, Python 3.13, Redis, Memcached, PostgreSQL 18/17/16/15, npm, git.

Une fois l'installation effectuée, ouvrez Laragon et cliquez sur « Tout démarrer » pour créer et lancer le serveur :

Vous avez maintenant à disposition :

un serveur Apache
PHP 8 (8.5 et inférieurs)
MySQL 9.4/8.4
le terminal Cmder (une console améliorée par rapport à l’horrible de Windows !)
Notepad++
composer
nodejs
putty
memcached
git
redis...

Avec Homestead on obtient pratiquement les mêmes possibilités.

Ne vous inquiétez pas si vous ne connaissez pas la moitié de ces outils ! D’une part, nous ne les utiliserons pas tous, d’autre part, je détaillerai l’utilisation de ceux qui vous seront nécessaires.

Hôte virtuel

L'une des fonctionnalités les plus appréciables de Laragon est sa capacité à créer automatiquement des hôtes virtuels pour les dossiers situés dans le répertoire serveur (www). Pour ceux qui ne sont pas familiers avec ce concept, voici un exemple concret avec Laravel :

Le fichier de démarrage de Laravel est généralement placé dans le répertoire www/monsite/public/index.php. Pour y accéder via localhost, il faudrait entrer une URL du type localhost/monsite/public. Ce n'est ni pratique ni élégant. Un hôte virtuel permet de définir une adresse simplifiée. Par exemple, Laragon configure automatiquement monsite.test comme hôte virtuel. Avouez que c'est bien plus agréable !

Mais l'intérêt des hôtes virtuels ne se limite pas à l'esthétique ou à l'économie de frappe. Disposer d'un hôte virtuel permet de reproduire en local le même comportement qu'en production. Par exemple, si vous avez une image référencée dans une page HTML avec un chemin absolu, comme /images/bouton.png, un hôte virtuel garantit que l'image s'affichera correctement, tout comme elle le ferait sur le serveur de production.

La création manuelle d'un hôte virtuel sous Windows n'est pas compliquée, mais peut être fastidieuse. Il faut en effet modifier deux fichiers : le fichier hosts de Windows et le fichier httpd-vhosts.conf d'Apache. Autant laisser Laragon s'en charger automatiquement ! Vous gagnerez ainsi du temps et réduirez les risques d'erreur de configuration.

Laravel Herd

Laravel Herd est le dernier né de l'écosystème Laravel, conçu pour offrir l'expérience de développement la plus rapide possible. Contrairement à de nombreux outils qui utilisent Docker ou des machines virtuelles (ce qui peut ralentir votre ordinateur), Herd est une application native.

Il installe directement sur votre système les binaires nécessaires (PHP, Nginx, dnsmasq). Résultat : les sites s'affichent instantanément et la consommation de mémoire vive est minimale.

Pourquoi choisir Herd ?

Zéro Configuration : vous l'installez, et c'est prêt. Pas de bouton "Démarrer", pas de services à configurer manuellement.
Versions de PHP à la carte : vous avez besoin de tester votre site en PHP 8.2 mais vous voulez utiliser PHP 8.4 pour un autre projet ? Vous changez de version en un clic dans l'interface.
Isolation des sites : comme Laragon, il gère automatiquement les hôtes virtuels. Si vous créez un dossier monsite, il sera immédiatement accessible via http://monsite.test.
Intégration totale : il inclut nativement la gestion des certificats SSL (pour avoir du HTTPS en local) et s'interface parfaitement avec les autres outils de la suite Laravel.

Le verdict : Si vous voulez une solution "poids plume" et que vous ne voulez pas vous soucier de la technique serveur, Herd est aujourd'hui le choix numéro 1. Si vous préférez un environnement plus classique avec une interface qui centralise tout (console, base de données, éditeur de texte), Laragon reste une valeur sûre.

Composer

Présentation

Dans le chapitre précédent, j'ai mentionné que Laravel utilise des composants provenant de diverses sources. Au lieu de les intégrer directement, Laravel utilise un gestionnaire de dépendances appelé Composer. Même les composants internes de Laravel sont gérés comme des dépendances via Composer. Mais qu'est-ce qu'un gestionnaire de dépendances ?

Imaginez que vous développiez une application PHP et que vous souhaitiez utiliser des composants externes, comme Carbon pour la gestion des dates ou Redis pour la gestion des données. Vous pourriez adopter une méthode manuelle, mais cela vous exposerait à plusieurs défis :

Télécharger manuellement tous les composants nécessaires et les placer dans la structure de votre projet.
Gérer les éventuels conflits de nommage entre les différentes bibliothèques.
Mettre à jour manuellement les bibliothèques lorsque de nouvelles versions sont disponibles.
Écrire du code pour charger les classes nécessaires.

Bien que faisable, cette approche manuelle est fastidieuse et sujette aux erreurs. C'est là qu'intervient un gestionnaire de dépendances tel que Composer.

Composer automatise toutes ces tâches. Il vous permet de définir les dépendances de votre projet dans un fichier composer.json, puis de les installer et de les mettre à jour automatiquement. Voici quelques-uns des avantages de Composer :

Simplicité d'installation : avec une simple commande, Composer télécharge et installe toutes les dépendances spécifiées.
Gestion des versions : vous pouvez spécifier les versions exactes ou les plages de versions des bibliothèques que vous souhaitez utiliser.
Résolution des conflits : Composer gère automatiquement les conflits de versions entre les différentes dépendances.
Autoloading : Composer génère un fichier d'autoloading qui permet de charger automatiquement les classes nécessaires, sans avoir à écrire de code supplémentaire.

En résumé, Composer simplifie grandement la gestion des dépendances dans vos projets PHP, vous permettant de vous concentrer sur le développement de fonctionnalités plutôt que sur la gestion manuelle des bibliothèques.

JSON

Pour comprendre le fonctionnement de Composer, il est essentiel de connaître le format JSON, qui signifie JavaScript Object Notation. Un fichier JSON est conçu pour contenir des informations structurées sous forme de paires clé-valeur. Voici un exemple simple :

{
  "nom": "Durand",
  "prénom": "Jean"
}

Dans cet exemple, les clés sont "nom" et "prénom", et les valeurs correspondantes sont "Durand" et "Jean". Les valeurs peuvent également être des tableaux ou des objets imbriqués. Voici un exemple plus complexe :

{
  "identité1": {
    "nom": "Durand",
    "prénom": "Jean"
  },
  "identité2": {
    "nom": "Dupont",
    "prénom": "Albert"
  }
}

Dans ce cas, les valeurs des clés "identité1" et "identité2" sont elles-mêmes des objets JSON contenant d'autres paires clé-valeur.

Composer et le fichier composer.json

Composer utilise un fichier nommé composer.json pour gérer les dépendances et les configurations de votre projet. Ce fichier contient des instructions sur les dépendances à installer, les versions requises et d'autres paramètres de configuration. Voici un exemple de section « require » dans un fichier composer.json :

{
  "require": {
    "php": "^8.3",
    "laravel/framework": "^13.0"
  }
}

Dans cet exemple :

La clé "require" spécifie les dépendances nécessaires pour le projet.
"php": "^8.3" indique que le projet nécessite PHP version 8.3 ou supérieure.
"laravel/framework": "^13.0" indique que le projet nécessite le framework Laravel version 13.0 ou supérieure.

Ce fichier peut contenir de nombreuses autres informations, telles que les scripts à exécuter, les configurations d'autoloading et les dépendances de développement. Nous étudierons en détail la structure et le contenu de ce fichier dans le prochain chapitre.

Packagist

Tous les composants disponibles se trouvent sur le site Packagist :

Par exemple, s'il me faut un composant pour l’envoi d’email, j’entre ceci dans la zone de recherche :

J’obtiens une liste assez longue et je n’ai plus qu’à fouiller un peu pour trouver ce que je cherche.

Packalyst

Le site Packalyst est spécialisé dans les composants conçus pour Laravel :

Là, vous êtes sûr que le composant va fonctionner directement dans Laravel ! Il faut toutefois vérifier qu’il correspond au numéro de version que vous utilisez.

Les éditeurs de code

Choisir un éditeur de code n’est pas évident, les critères sont nombreux. J'aime bien Visual Studio Code qui jouit d’une grande popularité :

Son grand avantage est de proposer de très nombreux plugins pour étendre ses possibilités, et il y en a pas mal pour Laravel. Vous pouvez installer tous les plugins que vous voulez. Pour trouver ceux qui concernent Laravel, vous avez une zone de recherche :

Dans la communauté Laravel l’IDE qui a un grand succès est PhpStorm‌. Il est vraiment puissant et complet, mais il n’est pas gratuit (sauf pour les étudiants qui ont une carte internationale à jour).

Les IA

Les IA deviennent incontournables pour le codage parce qu'elles font gagner beaucoup de temps. Il y a plusieurs façons de les utiliser mais la plus pratique est sans doute d'en avoir une intégrée à l'éditeur qu'on utilise. Il devient classique d'ajouter Copilot à Visual Studio :

Vous avez ainsi un assistant bien pratique.

Mais une autre solution est d'utiliser un éditeur intégrant déjà une IA comme Windsurf de Codium.

En résumé

Pour développer avec Laravel, vous avez besoin d'un environnement complet incluant PHP, MySQL, et Composer. Voici les solutions recommandées :

Environnements de développement :
- Homestead pour Linux
- Valet pour Mac
- Laragon pour Windows
Gestion des dépendances : utilisez Composer.
Éditeur de code : Visual Studio Code est performant et gratuit, mais n'hésitez pas à utiliser par exemple la version Windurf qui intègre une IA efficace.
Intelligence Artificielle : les outils d'IA sont désormais indispensables pour les développeurs.

Conclusion : Votre atelier est prêt !

Vous disposez désormais d'un environnement de développement complet. Que vous ayez choisi la polyvalence de Laragon, la légèreté de Herd, ou la puissance de VS Code, l'essentiel est là : votre machine parle enfin le langage de Laravel.

Nous avons vu que Laravel n'est pas un outil isolé, mais le chef d'orchestre d'un ensemble de technologies :

PHP pour la logique.
Composer pour importer les meilleures bibliothèques.
Le serveur local pour simuler un site réel sur votre ordinateur.

Le décor est planté, les outils sont affûtés. Dans le prochain chapitre, nous allons passer de la théorie à l'action. Nous utiliserons la ligne de commande pour générer votre tout premier projet et nous explorerons ensemble l'arborescence de fichiers de Laravel pour comprendre où se cache la magie.