Skip to content

Chapitre 2.1 : Préparation de l'environnement Laravel

Temps d'étude : 1-2 heures

1. Pourquoi un environnement local est-il nécessaire ?

Imaginez que vous construisez une sonde spatiale. Avant de la lancer dans l'espace, vous testez tous les systèmes sur Terre. L'environnement local est votre "laboratoire de contrôle" pour le code :

  • Expériences sécurisées sans impact sur le serveur de production
  • Déploiement rapide des dépendances
  • Basculement facile entre les versions logicielles

💡 Analogie spatiale : Herd = Complexe de lancement mobile Docker = Simulateur de station spatiale XAMPP = Banc d'essai stationnaire

2. Installation de Herd

Herd — un outil moderne pour gérer l'environnement PHP (analogue à Laravel Valet).

Étapes d'installation :

  1. Téléchargez l'installateur : herd.laravel.com
  2. Exécutez Herd Installer.exe → Suivant → Installer
  3. Après l'installation :
    • Ouvrez Herd depuis le menu Démarrer. L'icône de l'application apparaîtra dans la barre d'état système (à côté de l'horloge).
    • Cliquez sur l'icône Herd : assurez-vous que Nginx et la version de PHP souhaitée (par exemple, 8.3) sont démarrés (indiqués par un point vert).
    • Allez dans Herd Paths et ajoutez le dossier où vos projets seront stockés (par exemple, C:\Users\YourUser\Code). Herd créera automatiquement pour chaque sous-répertoire de ce dossier un joli domaine de type nom-du-dossier.test.

⚠️ Important ! Lors de l'installation : - Autorisez l'accès au réseau (si le pare-feu le demande) - Vérifiez le chemin dans PATH : C:\Program Files\Herd\bin

Vérification du fonctionnement :

  1. Cliquez sur l'icône Herd dans la barre d'état système.
  2. Assurez-vous que les services Nginx et PHP sont actifs (indicateurs verts).
  3. Créez un dossier test dans votre dossier de projets (par exemple, C:\Users\YourUser\Code), et à l'intérieur, un fichier index.php avec le contenu <?php phpinfo(); ?>.
  4. Dans Herd, via l'onglet sites, indiquez le chemin vers le dossier test et cliquez sur "Add site".
  5. Ouvrez l'adresse http://test.test dans votre navigateur. Vous devriez voir la page d'informations PHP.

3. Méthodes alternatives (en bref)

Outil Pour qui Avantages Inconvénients
Laravel Sail (Docker) Pour tous les niveaux Isolation complète, répétabilité de l'environnement, support officiel de Laravel Nécessite l'installation de Docker, consomme plus de ressources
XAMPP Débutants Tout en un (All-in-One) Encombrant, plus difficile à gérer les versions logicielles, pollue le système
Laragon Développeurs Windows Rapide, facile à changer de version, configuration automatique des hôtes Nécessite un redémarrage manuel du serveur web lors de l'ajout d'un nouveau projet

Exemple avec Docker (Laravel Sail) : 

# Après l'installation de Docker
./vendor/bin/sail up

4. Installation de PHP et Composer

Si vous n'utilisez pas Herd :

  1. PHP :
    • Téléchargez PHP 8.3 pour Windows
    • Décompressez dans C:\PHP
    • Ajoutez au PATH : 
      # Recommandé d'exécuter dans PowerShell en tant qu'administrateur
[Environment]::SetEnvironmentVariable("Path", "$env:Path;C:\PHP", "User")
  2. Composer :

5. Installation de PostgreSQL

Pour travailler avec les bases de données :

  1. Téléchargez PostgreSQL 15
  2. Exécutez l'installateur :
  3. Mot de passe du superutilisateur : admin (ou le vôtre)
  4. Port : 5432 (standard)
  5. Après l'installation :
  6. Ouvrez pgAdmin 4 (client graphique)

    Vous pouvez utiliser n'importe quel autre client pour travailler avec la base de données, par exemple, DBeaver, DataGrip ou même la ligne de commande. Je préfère DBeaver - mais c'est une question de goût

  7. Créez une base de données pour le projet : space_api

6. Installation de Laravel

  1. Via Composer : 

    composer create-project laravel/laravel space-api
cd space-api

  2. Initialisation de Git (optionnel) : 

    git init
git add .
git commit -m "Démarrage du projet spatial"

  3. Démarrage et vérification du serveur :

    Si vous utilisez Herd : Assurez-vous que votre projet space-api se trouve dans le dossier que vous avez ajouté à Herd. Ouvrez l'adresse dans votre navigateur : http://space-api.test Vous devriez voir la page d'accueil de Laravel. Le serveur fonctionne déjà grâce à Herd !

Si vous N'UTILISEZ PAS Herd (installation manuelle) : 

php artisan serve
Ouvrez dans le navigateur : http://localhost:8000 → La page d'accueil de Laravel devrait apparaître !

Lors de la création du projet dans Herd :

Suivez simplement les instructions à l'écran. Pour plus de commodité, le nom du projet sera space-api. Le kit de démarrage — n'importe lequel, mais je préfère React.

Assurez-vous d'activer phpunit - il nous sera utile plus tard

7. Configuration du projet

Fichiers importants :

  • .env — paramètres d'environnement (clés, bases de données)
  • config/database.php — configuration SGBD
  • composer.json — dépendances PHP

Connexion de la BDD au projet :

Ajoutez dans .env :

DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=space_api
DB_USERNAME=postgres # Nom d'utilisateur pour postgres
DB_PASSWORD=admin # Mot de passe pour postgres

Premières commandes Artisan : 

php artisan key:generate  # Génération de la clé de l'application
php artisan migrate:fresh # Migration de la base de données (Lors du passage à postgres)

Quiz de consolidation

1. Herd est...

2. Quel outil Laravel utilise-t-il pour gérer les dépendances PHP ?

3. Le port standard pour PostgreSQL est :

4. La commande pour créer un projet Laravel via Composer est :

5. Quel fichier contient les paramètres d'environnement ?

🚀 Résumé du chapitre

Vous avez déployé la "plateforme de lancement" pour l'API spatiale ! Vous disposez maintenant de :

  • 🛠️ Un environnement local (Herd ou installation manuelle) avec PHP et Nginx
  • 🐘 Un serveur de bases de données PostgreSQL installé
  • 🚀 Un projet Laravel space-api
  • 🔌 Une connexion configurée à la base de données

📌 Vérification :

  • Si vous utilisez Herd : Assurez-vous que le site s'ouvre à l'adresse http://space-api.test.
  • Si sans Herd : Assurez-vous que la commande php artisan serve fonctionne et que le site s'ouvre à l'adresse http://localhost:8000.
  • Dans tous les cas, vérifiez que la base de données space_api créée est visible dans pgAdmin 4.