Risoluzione dei problemi

Questa guida alla risoluzione dei problemi di Éclair CMS raccoglie i problemi più frequenti e la loro soluzione, dalla password dimenticata all’errore 404. Ogni sezione corrisponde a un messaggio o a un sintomo preciso: usa l’indice per andare dritto al tuo. La maggior parte si risolve in due minuti, con il tuo programma FTP o il file manager del tuo provider.

Password dimenticata o telefono dell’autenticazione a due fattori perso?

Parti dalle soluzioni più semplici:

• Esiste un altro amministratore: in Utenti, può cliccare su Reimposta password (viene creata una password temporanea) o su Disattiva la 2FA del tuo account.
• Hai perso il telefono, non i tuoi codici: accedi con uno dei tuoi 8 codici di recupero al posto del codice a 6 cifre.

Se sei l’unico amministratore, usa il recupero via FTP. Crea un file data/reset.php che contenga esattamente queste tre righe:

<?php exit; ?>
tuo-indirizzo@email.it
LaTuaNuovaPassword2026

Entro 24 ore, accedi con questa email e questa nuova password. La password viene sostituita, l’autenticazione a due fattori di questo account viene disattivata, le tue altre sessioni vengono chiuse e il file viene eliminato automaticamente.

«Installazione bloccata»: cosa fare?

Per sicurezza, l’installazione va completata entro 2 ore dalla prima visita: altrimenti chiunque potrebbe impadronirsi di un sito caricato e poi dimenticato. Scaduto questo tempo, elimina via FTP il file data/install-window.php, poi ricarica la pagina: si apre una nuova finestra di 2 ore.

Perché nella pagina Sicurezza l’indirizzo del sito risulta non verificato?

Il tuo server non riesce a contattare se stesso all’indirizzo del sito: firewall del provider, DNS non ancora propagato, dominio in corso di trasferimento… Il sito funziona normalmente, ma senza reindirizzamento all’indirizzo ufficiale (con o senza www, da http a https). Clicca su Verifica l’indirizzo del sito quando il dominio è a posto.

Perché compare un errore 404 su tutte le pagine tranne la homepage?

Il file .htaccess non è stato caricato, perché è un file nascosto, oppure la riscrittura degli URL è disattivata. Attiva «Mostra file nascosti» nel tuo programma FTP e ricaricalo nella radice del sito. Se il tuo provider lo richiede, togli il commento alla riga RewriteBase / del .htaccess.

Cosa fare in caso di errore 500 subito dopo il caricamento?

Il tuo provider rifiuta una direttiva del .htaccess. È molto raro: vengono usate solo direttive tollerate sugli hosting condivisi. Elimina il blocco in questione o contatta il tuo provider. Se compare la pagina «Oups, un court-circuit.» (in francese, «Oops, un cortocircuito») con un riferimento, il dettaglio dell’errore si trova in Sicurezza › Ultimi errori tecnici.

Perché le immagini non vengono convertite in WebP?

Sul tuo hosting manca l’estensione PHP GD, o il suo supporto WebP. Attivala nel pannello PHP del tuo provider. Nel frattempo, le tue immagini restano in JPG o PNG: il sito funziona, è solo un po’ meno leggero.

Perché non ricevo le email del modulo?

Niente panico: i messaggi vengono salvati anche nell’amministrazione, nel menu Messaggi. Controlla poi il campo Ricevi i messaggi all’indirizzo in Impostazioni › Contatti; di default è l’email del primo amministratore. Alcuni provider richiedono che il mittente appartenga al dominio del sito: crea un indirizzo email sul tuo dominio, se serve.

Come attivare la modalità debug?

Crea un file eclair-config.php nella radice del sito, accanto a index.php, sul modello di eclair-config.exemple.php:

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

// Mostra il dettaglio degli errori finché risolvi il problema.
define('ECLAIR_DEBUG', true);

Gli errori vengono allora mostrati nel dettaglio e la cache statica viene disattivata. Elimina questo file non appena il problema è risolto: il dettaglio degli errori non deve essere visibile a tutti.

Tutti gli indirizzi IP sono uguali: il tuo sito è dietro un proxy?

Se il registro di sicurezza mostra lo stesso indirizzo IP per tutti i visitatori, il tuo sito è probabilmente servito dietro un proxy o una CDN, come Cloudflare. I limiti di tentativi, che si applicano per rete, riguardano allora tutti insieme. In Impostazioni › Avanzate › «Sito dietro un proxy / CDN», scegli l’header che trasmette il vero indirizzo: CF-Connecting-IP per Cloudflare, X-Forwarded-For o X-Real-IP a seconda del tuo provider.

Éclair dice di aver bisogno di PHP 8.1 o successivo: cosa fare?

Se la pagina mostra «Éclair a besoin de PHP 8.1 ou plus récent» (in francese, «Éclair ha bisogno di PHP 8.1 o successivo»), il tuo hosting usa una versione di PHP troppo vecchia. Cambiala nell’area clienti del tuo provider, spesso con un clic, poi ricarica la pagina. Éclair funziona da PHP 8.1 a 8.5; scegli l’8.3 o successivo, se possibile. La guida Installare Éclair su o2switch mostra dove si trova questa impostazione in cPanel.

L’assistente IA non risponde?

Chiave rifiutata, credito esaurito, budget del mese raggiunto, connessioni in uscita bloccate: ogni messaggio ha la sua soluzione nella guida all’assistente IA.

Il tuo problema non è in questa guida alla risoluzione dei problemi di Éclair CMS?

Annota il messaggio di errore esatto, il tuo provider e la tua versione di PHP, poi scrivimi tramite la pagina Contatti. Puoi anche segnalare un problema su GitHub: la sua soluzione arricchirà questa guida alla risoluzione dei problemi di Éclair CMS per tutti gli utenti.