Installare su o2switch

o2switch è uno dei provider di hosting francesi più diffusi e si abbina alla perfezione a Éclair: cPanel, PHP fino alla versione 8.5, file .htaccess e certificati Let’s Encrypt gratuiti. Questa guida ti accompagna menu per menu, dal nome di dominio al sito online. Calcola 15 minuti, in gran parte passati ad aspettare il certificato HTTPS. È anche così che è ospitato eclaircms.org.

Perché o2switch è adatto a Éclair?

L’offerta di hosting di o2switch riunisce tutto ciò che Éclair richiede, senza opzioni da aggiungere. Le informazioni qui sotto provengono dalla pagina dell’offerta e dalla documentazione di o2switch, entrambe in francese, consultate il 30 ottobre 2026.

Passaggio 1: aggiungi il tuo dominio in cPanel

Se il tuo sito è il dominio principale del tuo account, usa già la cartella public_html: passa direttamente al passaggio 2. Altrimenti:

1. Accedi a cPanel dalla tua area clienti o2switch.
2. Apri Domini (Domaines), poi l’elenco dei domini configurati.
3. Crea un nuovo dominio e inserisci il suo nome, per esempio il-tuo-sito.it.
4. Lascia il campo Radice documenti (Racine des documents) proposto da cPanel: una cartella con il nome del dominio, accanto a public_html (per esempio /home/nomeutente/il-tuo-sito.it).
5. Conferma.

Tieni a mente questa cartella: è lì che caricherai Éclair. La procedura ufficiale è descritta nella documentazione di o2switch sui domini.

Passaggio 2: scegli PHP 8.3 o 8.4

La versione «nativa» di o2switch è PHP 8.1: Éclair funziona con quella, ma una versione recente è più veloce e viene supportata più a lungo.

1. In cPanel, apri Software › Select PHP Version (Logiciels › Sélectionner une version de PHP).
2. Scegli 8.3 o 8.4 dall’elenco, poi salva.

Le estensioni di cui Éclair ha bisogno (mbstring, json, dom, session e, in aggiunta, gd, zip, curl) si gestiscono nello stesso strumento: se la procedura guidata di Éclair ne segnala una mancante, spuntala qui. Vedi la documentazione PHP di o2switch.

Passaggio 3: attiva il certificato HTTPS gratuito

Fallo prima di installare Éclair: la procedura guidata registra l’indirizzo con cui apri il sito, tanto vale che inizi con https://.

1. In cPanel, apri Sicurezza › Let’s Encrypt™ SSL (Sécurité › Let’s Encrypt SSL).
2. Trova il tuo dominio e clicca sul link che genera il certificato (Générer nell’interfaccia in francese), includendo la versione www se viene proposta.
3. Attendi qualche minuto: il certificato viene poi rinnovato automaticamente.

In caso di problemi (per esempio un dominio che non punta ancora a o2switch), la documentazione Let’s Encrypt di o2switch descrive le verifiche da fare.

Passaggio 4: carica Éclair con il file manager

1. Scarica Éclair sul tuo computer (archivio eclair-cms-1.7.0.zip, 440 KB). Non serve estrarlo.
2. In cPanel, apri File › Gestione file (Fichiers › Gestionnaire de fichiers).
3. Clicca su Impostazioni (Paramètres, in alto a destra) e spunta Mostra file nascosti (Afficher les fichiers masqués), poi salva. È indispensabile per vedere il file .htaccess.
4. Apri la cartella del tuo dominio (quella del passaggio 1, oppure public_html).
5. Clicca su Carica (Charger) e invia l’archivio.
6. Di nuovo nella cartella, fai clic con il tasto destro sull’archivio e scegli Estrai (nell’interfaccia in francese, Extract): compare una cartella eclair.
7. Apri la cartella eclair, clicca su Seleziona tutto (Tout sélectionner), poi su Sposta (Déplacer) e indica la cartella del tuo dominio (per esempio /il-tuo-sito.it).
8. Elimina la cartella eclair, ormai vuota, e l’archivio.

Ora dovresti vedere, direttamente nella cartella del tuo dominio: app, assets, cache, data, media, index.php, .htaccess e eclair-config.exemple.php.

Passaggio 5: avvia la procedura guidata di installazione

Apri https://il-tuo-sito.it nel browser. La procedura guidata di Éclair controlla l’hosting: da o2switch tutti i punti devono essere verdi se PHP 8.3 o 8.4 è attivo e il certificato è presente.

Rispondi poi alle 4 domande (il tuo sito, il tuo account, la tua visibilità, l’indirizzo della tua area di amministrazione): ogni schermata è mostrata nella guida all’installazione. Ricordati di annotare l’indirizzo della tua area di amministrazione, poi clicca su Crea il mio sito ⚡.

Passaggio 6: i controlli dopo l’installazione

Accedi alla tua area di amministrazione, poi:

1. Sicurezza › Verifica l’indirizzo del sito: Éclair chiama se stesso sul tuo dominio. Una volta confermato l’indirizzo, impone l’HTTPS e reindirizza all’indirizzo ufficiale, con o senza www.
2. Guarda il registro di sicurezza nella stessa pagina: l’indirizzo IP del tuo accesso deve essere il tuo (confrontalo con un sito come «qual è il mio IP»). Se tutte le righe mostrano lo stesso indirizzo e non è il tuo, scegli l’header del tuo provider in Impostazioni › Avanzate › Sito dietro un proxy / CDN, così la protezione anti brute force e i limiti del modulo si applicano ai visitatori giusti.
3. Il mio profilo › Autenticazione a due fattori: attivala subito.
4. Completa l’elenco Primi passi della bacheca, descritto in Primi passi dopo l’installazione.

Non serve attivare altre cache lato o2switch: Éclair serve già ogni pagina dalla propria cache statica, che si svuota da sola a ogni modifica.

E le email del modulo di contatto?

I messaggi inviati dal tuo modulo arrivano all’indirizzo del tuo account amministratore e vengono salvati anche nell’area di amministrazione (menu Messaggi): non si perde nulla, anche se un’email si smarrisce. Puoi scegliere un altro indirizzo di ricezione in Impostazioni › Contatti. Se le email non arrivano, vedi le soluzioni nella guida alla risoluzione dei problemi.

Scarica Éclair 1.7.0