Prérequis¶
Avant de pouvoir lancer le projet en local, vous devez installer plusieurs outils sur votre machine.
Bonne nouvelle
Tous ces outils sont gratuits et disponibles sur Windows, macOS et Linux.
Outils requis¶
| Outil | Version minimale | Rôle dans le projet | Téléchargement |
|---|---|---|---|
| Node.js | v18+ | Exécution de JavaScript/TypeScript (Tech & Immo) | nodejs.org |
| npm | v9+ | Gestionnaire de paquets JavaScript | Inclus avec Node.js |
| PHP | v8.2+ | Langage du service drwh_group (Laravel) | php.net |
| Composer | v2+ | Gestionnaire de paquets PHP | getcomposer.org |
| Git | Dernière version | Gestion du code source | git-scm.com |
| Docker | Dernière version | (Optionnel) Déploiement conteneurisé | docker.com |
Vérifier que les outils sont installés¶
Ouvrez un terminal (PowerShell sur Windows, Terminal sur macOS/Linux) et exécutez :
node --version # → v18.x.x ou supérieur
npm --version # → 9.x.x ou supérieur
php --version # → PHP 8.2.x ou supérieur
composer --version # → Composer 2.x.x
git --version # → git version 2.x.x
docker --version # → Docker version 24.x.x (si installé)
Si une commande n'est pas reconnue
Si le terminal affiche command not found ou n'est pas reconnu, l'outil n'est pas installé ou n'est pas dans le PATH.
Suivez les liens de téléchargement dans le tableau ci-dessus.
Installation sur Windows¶
=== "Node.js & npm" 1. Téléchargez l'installeur LTS sur nodejs.org 2. Exécutez l'installeur (acceptez toutes les options par défaut) 3. Vérifiez : node --version et npm --version
Option recommandée : XAMPP ou Laragon
- [Laragon](https://laragon.org/download/) : le plus simple pour Windows, inclut PHP 8.2+, MySQL, etc.
- Après installation, PHP est disponible dans le terminal via Laragon
**Option manuelle :**
1. Téléchargez PHP depuis [windows.php.net](https://windows.php.net/download/)
2. Ajoutez le dossier PHP à la variable d'environnement `PATH`
=== "Composer" 1. Téléchargez l'installeur depuis getcomposer.org 2. Exécutez Composer-Setup.exe 3. Vérifiez : composer --version
=== "Git" 1. Téléchargez depuis git-scm.com 2. Exécutez l'installeur (acceptez les options par défaut) 3. Vérifiez : git --version
Installation sur macOS¶
Si vous n'avez pas Homebrew, installez-le d'abord :
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Ensuite, installez tout en une commande :
```bash
brew install node php composer git
```
bash
node --version
npm --version
php --version
composer --version
git --version
Configuration Git (première fois)¶
Avant d'utiliser Git, configurez votre identité :
Pourquoi ?
Git enregistre votre nom et email dans chaque commit que vous créez.
C'est ainsi que l'équipe sait qui a modifié quoi.
Éditeur de code recommandé¶
Nous recommandons Visual Studio Code (gratuit) :
code.visualstudio.com
Extensions recommandées pour ce projet :
| Extension | Utilité |
|---|---|
| ESLint | Vérification du code JavaScript/TypeScript |
| Prettier | Formatage automatique du code |
| PHP Intelephense | Autocomplétion PHP |
| Tailwind CSS IntelliSense | Autocomplétion Tailwind |
| GitLens | Voir l'historique Git directement dans le code |
Étape suivante¶
Une fois tous les outils installés, passez à :