Installation et configuration
⚠️ Configuration Apache requise : Pour les options Apache, n'oubliez pas de configurer les Server-Side Includes (SSI). Consultez le guide : Configuration SSI
Options d'installation
Option 1 : Apache local (Linux)
Installation d'Apache directement sur votre système Linux.
Prérequis
- Git - pour cloner le projet
- Apache - serveur web
Installation
# Installation Apache
sudo apt update
sudo apt install apache2
# Cloner le projet dans le dossier de votre choix
# Exemples selon votre environnement :
git clone https://github.com/10s25/dev_local.git ~/Bureau/site-main
# ou ~/Desktop/site-main ou ~/Documents/site-main
cd ~/Bureau/site-main # adaptez le chemin
# Créer un lien symbolique vers Apache
sudo ln -s ~/Bureau/site-main /var/www/html/site
# Démarrage du service
sudo systemctl start apache2
sudo systemctl enable apache2
📋 Configuration SSI requise : Voir la documentation complète : Configuration SSI
📊 Avantage : Le projet reste dans votre dossier utilisateur, facile à éditer sans permissions sudo.
⚠️ Attention : Si votre dossier
→ Alternative plus propre : copier le site dans
~/Bureau/site-main bouge ou change de nom, le lien symbolique cassera.→ Alternative plus propre : copier le site dans
/var/www/html/ directement ou utiliser un VirtualHost.
Vérification : Ouvrez dans votre navigateur : 👉 http://localhost/site/
⚠️ Chemins variables : Les chemins comme
~/Bureau/ ou ~/Desktop/ dépendent de la langue de votre système. Vous pouvez cloner le projet dans n'importe quel dossier de votre choix.
Option 2 : WAMP/MAMP/LAMP (Windows/macOS/Linux)
Solutions tout-en-un pour toutes les plateformes.
Windows - WAMP
- Téléchargez WampServer
- Installez et démarrez tous les services
- Clonez le projet dans le dossier
www
macOS - MAMP
- Téléchargez MAMP
- Installez et démarrez Apache
- Clonez le projet dans le dossier
htdocs
Linux - LAMP
- Installez LAMP stack ou utilisez des solutions comme XAMPP
- Démarrez les services Apache
- Clonez le projet dans le dossier web approprié
# Cloner le projet (adaptez le chemin selon votre configuration)
git clone https://github.com/10s25/dev_local.git
📋 Configuration SSI requise : Voir la documentation complète : Configuration SSI
Option 3 : Serveur Python (développement)
Solution simple avec serveur Python intégré et support SSI automatique.
Prérequis
- Git - pour cloner le projet
- Python 3.x - pour le serveur de développement
- Bash - pour exécuter les scripts (voir instructions Windows)
Installation sur Linux/macOS
# Cloner le projet
git clone https://github.com/10s25/dev_local.git
cd dev_local
# Donner les permissions d'exécution au script de setup
chmod +x dev/setup.sh
# Lancer la configuration initiale
./dev/setup.sh
✅ Configuration automatique : Le script setup.sh génère automatiquement le serveur Python avec support SSI et configure tous les fichiers nécessaires.
Installation sur Windows
Pour utiliser les scripts sur Windows, vous devez d'abord installer bash. Choisissez une des options suivantes :
Méthode 1 : Git Bash (recommandé)
- Téléchargez et installez Git for Windows
- Git Bash sera disponible dans le menu Démarrer
- Ouvrez Git Bash et naviguez vers votre projet
Méthode 2 : WSL (Windows Subsystem for Linux)
# Dans PowerShell en tant qu'administrateur
wsl --install
# Redémarrez votre ordinateur
# Puis ouvrez Ubuntu depuis le menu Démarrer
Méthode 3 : MSYS2
- Téléchargez MSYS2
- Suivez les instructions d'installation
- Utilisez le terminal MSYS2
Une fois bash installé, utilisez les mêmes commandes que sur Linux/macOS :
# Configuration initiale
chmod +x dev/setup.sh
./dev/setup.sh
Vérification de l'installation
Pour vérifier que tout fonctionne correctement :
# Démarrer le serveur de développement
./dev/start.sh
# Le navigateur devrait s'ouvrir automatiquement sur :
# http://localhost:8000
💡 Astuce : Le serveur détecte automatiquement s'il y a déjà un processus en cours et le remplace intelligemment.
Structure du projet après installation
├── index.html # Page d'accueil
├── global/ # Ressources partagées (CSS, JS, SSI)
├── local/ # Personnalisations locales
├── src/ # Scripts PHP de génération
├── dev/ # Outils de développement
│ ├── setup.sh # Configuration initiale
│ ├── start.sh # Démarrage du serveur
│ ├── stop.sh # Arrêt du serveur
│ └── prod.sh # Préparation production
├── docker/ # Configuration Docker
├── favicon.ico # Icône du site
└── .htaccess # Configuration Apache
Dépannage des permissions
Si vous rencontrez des problèmes de permissions :
# Donner les permissions à tous les scripts d'un coup
chmod +x dev/*.sh
# Ou individuellement si nécessaire
chmod +x dev/setup.sh
chmod +x dev/start.sh
chmod +x dev/stop.sh
chmod +x dev/prod.sh
⚠️ Note : Le script setup.sh attribue automatiquement les permissions aux autres scripts, donc normalement seule la première commande est nécessaire.