🎯 Objectif de cette fiche
Installer et lancer un projet Web en local ne devrait pas ressembler à une tour Lego montée sans notice.
Pourtant, entre Git utilisé à l’aveugle, environnements mal compris et bases de données bricolées, beaucoup de juniors (et quelques seniors aussi…) empilent les briques au hasard jusqu’à l’effondrement final.
Cette fiche pratique a été conçue pour :
- les stagiaires et développeurs juniors,
- les profils en reconversion,
- toute personne travaillant sur un projet Web sous Windows en environnement d’entreprise.
🎯 Objectif clair :
👉 Monter un environnement propre, stable et compréhensible, sans toucher à l’infrastructure (vhosts, serveurs, tuning système).
🪟 Environnement standard sous Windows
Dans de nombreuses équipes, le poste de travail ressemble à ceci :
🧱 Stack locale
- Laragon : serveur local clé en main (Apache/Nginx, PHP, MySQL/MariaDB)
- HeidiSQL : gestion graphique des bases de données
- Git : versionnement du code
- Terminal : Git Bash ou terminal Laragon
- Éditeur : VS Code (souvent)
🧠 À retenir
Laragon, c’est la boîte de briques Lego : tout est dedans.
À vous de comprendre comment les assembler correctement.
📁 Où travailler avec Laragon ?
📌 Dossier racine des projets Web :
C:\laragon\www\
Chaque projet correspond à un dossier.
Exemple :
C:\laragon\www\prestashop\
Laragon génère automatiquement l’URL :
http://prestashop.test
🚫 Aucun vhost à configurer
👉 L’infrastructure n’est pas votre sujet. Et c’est très bien comme ça.
🐧 Commandes essentielles (Linux-like sous Windows)
À utiliser via Git Bash ou le terminal Laragon.
Même logique que sous Linux/Debian.
📁 Navigation & fichiers
| Commande | Rôle |
|---|---|
pwd | Afficher le dossier courant |
cd dossier | Se déplacer |
ls -la | Lister fichiers |
mkdir dossier | Créer un dossier |
touch fichier | Créer un fichier |
cp a b | Copier |
mv a b | Renommer / déplacer |
rm fichier | Supprimer (⚠️) |
⚠️ Règle Lego n°1
👉 Avant de casser une brique (rm), vérifiez toujours où vous êtes (pwd).
✏️ Lecture, édition et outils utiles
| Commande | Usage |
|---|---|
cat fichier | Lire rapidement |
less fichier | Lecture paginée |
nano fichier | Modifier un fichier |
grep texte fichier | Rechercher |
php -v | Vérifier PHP |
composer install | Installer dépendances |
unzip fichier.zip | Décompresser |
🌿 Git – le strict nécessaire (sans magie noire)
🧾 Commandes de base
| Commande | Utilité |
|---|---|
git clone <url> | Récupérer le projet |
git status | Vérifier l’état |
git checkout -b feature/x | Créer une branche |
git add . | Préparer un commit |
git commit -m "message clair" | Sauvegarder |
git pull | Mettre à jour |
git push | Envoyer son travail |
🔀 Pull Request / Merge Request
Ce n’est pas une commande, mais une étape obligatoire sur GitHub/GitLab :
- Branche dédiée
- Commits propres
- Push
- PR / MR
- Revue → merge
👉 On ne pousse jamais directement sur main.
Même si “ça marche chez vous”.
🏗️ Installer un projet Web en local (ex : PrestaShop)
1️⃣ Récupérer le projet
cd /c/laragon/www git clone <url-du-repo> cd prestashop
Ou depuis une archive :
unzip prestashop.zip
2️⃣ Démarrer Laragon
- Cliquer sur Start All
- Apache + MySQL doivent être verts
🟢 Vert = briques bien clipsées
🔴 Rouge = quelque chose est mal monté
3️⃣ Créer la base de données (HeidiSQL)
Connexion :
- Hôte :
127.0.0.1 - Utilisateur :
root - Mot de passe : (vide par défaut)
Créer une base :
prestashop_local
4️⃣ Configurer le projet
cp .env.example .env nano .env
Exemple :
DB_HOST=127.0.0.1 DB_NAME=prestashop_local DB_USER=root DB_PASSWORD=
5️⃣ Installer les dépendances
composer install
6️⃣ Accéder au site
Dans le navigateur :
http://prestashop.test
Ou via :
Menu Laragon → www → prestashop
⭐ Bonnes pratiques (ou comment éviter l’écroulement)
🧼 Git
- 1 branche = 1 sujet
- Commits clairs et lisibles
- 🚫 Jamais de
.enven dépôt git pullavant de coder- En cas de doute → demander avant de pousser
🧠 Environnement local
- Travailler uniquement dans
C:\laragon\www - Ne jamais modifier la config globale Laragon
- Base locale ≠ base de prod
- Toujours lire le
README.md
🧑🤝🧑 Communication efficace
Quand ça ne marche pas :
- la commande lancée,
- le message d’erreur exact,
- ce que vous vouliez faire,
- ce que vous attendiez.
🧩 Résumé express
🧱 Serveur local : Laragon
🗄️ Base de données : HeidiSQL
🌿 Code : Git
🌍 URL locale : *.test
🚫 Infra : pas votre chantier
🎬 Mot de la fin – esprit SecuSlice
Un environnement local propre, ce n’est pas du confort.
C’est la fondation.
Mal monter ses briques au début, c’est garantir des bugs, des pertes de temps… et des “ça marchait hier”.
👉 Prenez le temps de bien construire.
Le reste tiendra tout seul. 🧱💻
