Tutta la documentazione

Aggiornare, fare backup, traslocare

Come aggiornare Éclair senza rischi, fare il backup del tuo sito in un clic, ripristinarlo e traslocarlo su un altro hosting o un altro dominio.

Aggiornato il 4 min di lettura

Indice
  1. Come fare il backup del tuo sito?
  2. Come ripristinare un backup?
  3. Come aggiornare Éclair a una nuova versione?
  4. Come traslocare su un altro hosting?
  5. Come cambiare nome di dominio?
  6. Si possono tenere i dati fuori dalla cartella pubblica?
  7. Bisogna svuotare la cache dopo ogni modifica?
  8. Domande sull’aggiornamento

Aggiornare Éclair richiede cinque minuti e non tocca mai i tuoi contenuti: vivono in cartelle che l’aggiornamento lascia intatte. Questa guida spiega anche come fare il backup del sito in un clic, ripristinarlo e traslocarlo su un altro hosting o un altro dominio, senza perdere una pagina né il tuo posizionamento.

Come fare il backup del tuo sito?

In Sicurezza › Backup, clicca su Scarica un backup. Ricevi un archivio ZIP che contiene due cartelle:

CartellaCosa contiene
data/I tuoi contenuti e le loro versioni, le impostazioni, gli account, i menu, le categorie e i messaggi
media/Tutte le tue immagini e le loro versioni WebP

Per sicurezza, le chiavi API dell’assistente IA, la cronologia delle sue conversazioni, le sessioni e i contatori di accesso sono esclusi dall’archivio. Se il tuo provider non ha l’estensione zip, copia semplicemente le cartelle data/ e media/ via FTP.

Se hai effettuato l’accesso più di 15 minuti fa, Éclair ti chiede di nuovo la password prima di creare l’archivio.

Come ripristinare un backup?

  1. Decomprimi l’archivio sul tuo computer: contiene data/, media/ e un file LISEZ-MOI.txt (in francese, «leggimi»).
  2. Via FTP, sostituisci le cartelle data/ e media/ della tua installazione con quelle dell’archivio.
  3. Accedi, poi vai in Impostazioni › Avanzate › Svuota la cache.
  4. Se usi l’assistente IA, incolla di nuovo le tue chiavi API in Impostazioni › Assistente IA: non fanno parte dei backup.

Come aggiornare Éclair a una nuova versione?

Consulta prima il registro delle versioni per vedere cosa cambia, poi scarica il nuovo archivio dalla pagina Scarica.

  1. Fai un backup da Sicurezza › Backup.
  2. Via FTP, elimina le cartelle app/ e assets/ del tuo sito.
  3. Carica quelle della nuova versione, insieme a index.php e .htaccess.
  4. Non toccare data/ (contenuti, impostazioni, account) né media/ (immagini).
  5. Nell’amministrazione, clicca su Impostazioni › Avanzate › Svuota la cache.

Eliminare prima di caricare evita di conservare vecchi file ormai inutili, che il controllo di integrità segnalerebbe. Per finire, avvia Sicurezza › Integrità dei file › Analizza ora: tutto deve essere verde.

Come traslocare su un altro hosting?

  1. Scarica un backup, poi copia l’intera cartella del sito via FTP, file nascosti .htaccess compresi.
  2. Caricala presso il tuo nuovo provider, nella cartella pubblica del dominio. Verifica che PHP sia in versione 8.1 o successiva (consigliata la 8.3).
  3. Fai puntare il tuo dominio al nuovo hosting, poi attendi la propagazione DNS (da qualche minuto a qualche ora).
  4. Accedi e clicca su Sicurezza › Verifica l’indirizzo del sito.

Nessun database da esportare né da reimportare: è uno dei grandi vantaggi di un CMS senza database.

Come cambiare nome di dominio?

Dopo aver copiato il sito, cambia l’indirizzo in Impostazioni › Generali › Indirizzo ufficiale del sito, poi verificalo nella pagina Sicurezza. I link interni si adattano automaticamente, anche se il sito è installato in una sottocartella. La sitemap, gli URL canonici e llms.txt usano subito il nuovo indirizzo.

Se il vecchio dominio resta attivo, reindirizzalo con un 301 al nuovo presso il tuo provider: i tuoi visitatori e il tuo posizionamento seguiranno. Ricordati anche di dichiarare il cambio di indirizzo in Google Search Console, come spiega la guida di Google ai trasferimenti di sito.

Si possono tenere i dati fuori dalla cartella pubblica?

Sì, se il tuo provider lo consente. Sposta prima la cartella data/ nella posizione scelta, poi copia il file eclair-config.exemple.php con il nome eclair-config.php, accanto a index.php, e indica il nuovo percorso:

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

// Dati conservati fuori dalla cartella pubblica.
define('ECLAIR_DATA', '/home/miaccount/eclair-data');

I tuoi dati sono già protetti due volte nella cartella pubblica. Questa opzione aggiunge una terza barriera: non si trovano più nemmeno nell’albero del sito.

Bisogna svuotare la cache dopo ogni modifica?

No. La cache statica si svuota da sola a ogni modifica fatta nell’amministrazione, e all’ora prevista per un articolo programmato. Svuotala a mano solo dopo un aggiornamento o una modifica dei file via FTP, in Impostazioni › Avanzate › Svuota la cache. Il pulsante Ricostruisci l’indice e svuota la cache della pagina Sicurezza ripara anche l’indice dei contenuti, in caso di bisogno.

Domande sull’aggiornamento

L’aggiornamento cancella i miei contenuti?

No. I tuoi contenuti, le impostazioni e gli account sono in data/, le tue immagini in media/: la procedura chiede appunto di non toccare queste due cartelle.

Quanto tempo ci vuole per aggiornare Éclair?

Circa cinque minuti: un backup, l’eliminazione e il caricamento di due cartelle (meno di 1 MB), poi un clic per svuotare la cache.

Il mio backup contiene le mie chiavi API?

No. Le chiavi dell’assistente IA e la cronologia delle sue conversazioni sono volutamente escluse. Dopo un ripristino, incolla di nuovo le tue chiavi in Impostazioni › Assistente IA.

Il sito va offline durante l’aggiornamento?

Solo il tempo di caricare app/ e assets/, in genere meno di un minuto. Le pagine già in cache continuano a essere servite grazie al file index.php.