Essayer sur ton ordinateur

Tu veux découvrir Éclair avant de choisir un hébergement, ou préparer ton site tranquillement hors ligne ? Tu peux installer Éclair en local, sur ton ordinateur, en 5 minutes. Il te faut seulement un petit serveur web avec PHP : XAMPP, MAMP ou Laragon pour les non-développeurs, ou le serveur intégré de PHP pour les autres. Ton site sera ensuite publiable tel quel.

Quelle solution choisir pour installer Éclair en local ?

Les trois premiers installent Apache et PHP en quelques clics : c’est exactement l’environnement d’un hébergement mutualisé, .htaccess compris. Vérifie seulement que la version de PHP proposée est 8.1 ou plus.

Comment installer Éclair en local avec XAMPP ?

1. Installe XAMPP, puis lance le panneau de contrôle et démarre Apache (MySQL est inutile).
2. Télécharge Éclair et décompresse l’archive.
3. Copie le dossier eclair dans le dossier web de XAMPP : C:\xampp\htdocs\ sous Windows, /Applications/XAMPP/htdocs/ sur Mac.
4. Ouvre http://localhost/eclair/ dans ton navigateur : l’assistant d’installation démarre.
5. Réponds aux 4 questions, comme expliqué dans le guide d’installation.

Avec MAMP, le dossier web s’appelle aussi htdocs et l’adresse dépend du port choisi (par exemple http://localhost:8888/eclair/). Avec Laragon, dépose le dossier dans C:\laragon\www\ puis ouvre http://localhost/eclair/.

Et avec le serveur intégré de PHP ?

Pour les développeurs : le dépôt GitHub d’Éclair contient un routeur qui reproduit les règles du .htaccess pour le serveur intégré de PHP. Il faut PHP 8.1 ou plus et Git.

git clone https://github.com/Jacckisback/eclair-cms.git
cd eclair-cms
PHP_CLI_SERVER_WORKERS=4 php -S localhost:8000 -t eclair tools/router.php

Ouvre ensuite http://localhost:8000. La variable PHP_CLI_SERVER_WORKERS permet au site de s’appeler lui-même pour vérifier son adresse : avec un seul processus, cette vérification échoue simplement, sans gêner le reste. Le même dépôt contient les tests (php tests/run.php, 299 vérifications) : tout est détaillé dans la page développeurs.

Comment mettre en ligne le site préparé en local ?

Ton site tient dans un seul dossier : il suffit de le copier.

1. Dans l’administration locale, télécharge une sauvegarde par sécurité (Sécurité › Télécharger une sauvegarde).
2. Envoie tout le contenu du dossier eclair chez ton hébergeur, dossiers data et media compris, avec les fichiers cachés .htaccess.
3. Connecte-toi à l’administration en ligne avec le même e-mail et le même mot de passe.
4. Dans Réglages › Général, remplace l’adresse locale par l’adresse définitive du site (par exemple https://mon-site.fr).
5. Dans Sécurité, clique sur Vérifier l’adresse du site, puis vide le cache dans Réglages › Avancé.

Les liens internes s’adaptent automatiquement, même si ton site passe d’un sous-dossier local à la racine d’un domaine. Pour un hébergement o2switch, suis le guide o2switch à partir de l’étape 4.

Télécharger Éclair 1.2.0