Dépannage

Ce guide de dépannage Éclair CMS rassemble les problèmes les plus fréquents et leur solution, du mot de passe oublié à l’erreur 404. Chaque section correspond à un message ou à un symptôme précis : utilise le sommaire pour aller droit au tien. La plupart se règlent en deux minutes, avec ton logiciel FTP ou le gestionnaire de fichiers de ton hébergeur.

Mot de passe oublié ou téléphone de double authentification perdu ?

Commence par les solutions les plus simples :

• Un autre administrateur existe : dans Utilisateurs, il peut cliquer sur Réinitialiser le mot de passe (un mot de passe provisoire est créé) ou sur Désactiver la 2FA de ton compte.
• Tu as perdu ton téléphone, pas tes codes : connecte-toi avec l’un de tes 8 codes de secours à la place du code à 6 chiffres.

Si tu es le seul administrateur, utilise le secours par FTP. Crée un fichier data/reset.php contenant exactement ces trois lignes :

<?php exit; ?>
ton-adresse@email.fr
TonNouveauMotDePasse2026

Dans les 24 heures, connecte-toi avec cet e-mail et ce nouveau mot de passe. Le mot de passe est remplacé, la double authentification de ce compte est désactivée, tes autres sessions sont fermées et le fichier est supprimé automatiquement.

« Installation verrouillée » : que faire ?

Par sécurité, l’installation doit être faite dans les 2 heures qui suivent la première visite : sinon, n’importe qui pourrait s’emparer d’un site déposé puis oublié. Passé ce délai, supprime le fichier data/install-window.php par FTP, puis recharge la page : une nouvelle fenêtre de 2 heures s’ouvre.

Que signifie « Adresse non vérifiée » dans la page Sécurité ?

Ton serveur n’arrive pas à s’appeler lui-même sur l’adresse du site : pare-feu de l’hébergeur, DNS pas encore propagé, domaine en cours de transfert… Le site fonctionne normalement, mais sans redirection vers l’adresse officielle (avec ou sans www, http vers https). Clique sur Vérifier l’adresse du site une fois le domaine en place.

Pourquoi une erreur 404 sur toutes les pages sauf l’accueil ?

Le fichier .htaccess n’a pas été envoyé, car c’est un fichier caché, ou la réécriture d’URL est désactivée. Active « Afficher les fichiers cachés » dans ton logiciel FTP et renvoie-le à la racine du site. Si ton hébergeur l’exige, décommente la ligne RewriteBase / du .htaccess.

Que faire en cas d’erreur 500 juste après l’envoi ?

Une directive du .htaccess est refusée par ton hébergeur. C’est très rare : seules des directives tolérées sur les hébergements mutualisés sont utilisées. Supprime le bloc concerné ou contacte ton hébergeur. Si la page « Oups, un court-circuit » s’affiche avec une référence, le détail de l’erreur se trouve dans Sécurité › Dernières erreurs techniques.

Pourquoi les images ne sont-elles pas converties en WebP ?

L’extension PHP GD, ou son support du WebP, manque sur ton hébergement. Active-la dans le panneau PHP de ton hébergeur. En attendant, tes images restent en JPG ou en PNG : le site fonctionne, il est juste un peu moins léger.

Pourquoi je ne reçois pas les e-mails du formulaire ?

Pas de panique : les messages sont aussi enregistrés dans l’administration, menu Messages. Vérifie ensuite l’adresse de réception dans Réglages › Contact ; par défaut, c’est l’e-mail du premier administrateur. Certains hébergeurs exigent que l’expéditeur appartienne au domaine du site : crée une adresse e-mail sur ton domaine si besoin.

Comment activer le mode débogage ?

Crée un fichier eclair-config.php à la racine du site, à côté de index.php, sur le modèle de eclair-config.exemple.php :

<?php
defined('ECLAIR') || exit;

// Afficher le détail des erreurs, le temps de résoudre le problème.
define('ECLAIR_DEBUG', true);

Les erreurs s’affichent alors en détail et le cache statique est désactivé. Supprime ce fichier dès que le problème est réglé : le détail des erreurs n’a pas à être visible de tous.

Toutes les adresses IP sont identiques : ton site est-il derrière un proxy ?

Si le journal de sécurité affiche la même adresse IP pour tous les visiteurs, ton site est probablement servi derrière un proxy ou un CDN, comme Cloudflare. Les limites de tentatives, qui s’appliquent par réseau, concernent alors tout le monde à la fois. Dans Réglages › Avancé › « Site derrière un proxy / CDN », choisis l’en-tête qui transmet la vraie adresse : CF-Connecting-IP pour Cloudflare, X-Forwarded-For ou X-Real-IP selon ton hébergeur.

« Éclair a besoin de PHP 8.1 ou plus récent » : que faire ?

Ton hébergement utilise une version de PHP trop ancienne. Change-la dans l’espace client de ton hébergeur, souvent en un clic, puis recharge la page. Éclair fonctionne de PHP 8.1 à 8.5 ; choisis 8.3 ou plus récent si possible. Le guide Installer Éclair sur o2switch montre où se trouve ce réglage dans cPanel.

L’assistant IA ne répond pas ?

Clé refusée, crédit épuisé, budget du mois atteint, connexions sortantes bloquées : chaque message a sa solution dans le guide de l’assistant IA.

Ton problème n’est pas dans ce guide de dépannage Éclair CMS ?

Note le message d’erreur exact, ton hébergeur et ta version de PHP, puis écris-moi via la page Contact. Tu peux aussi signaler un problème sur GitHub : sa solution viendra enrichir ce dépannage Éclair CMS pour tous les utilisateurs.