Tutta la documentazione

Provare Éclair sul tuo computer

Installare Éclair in locale per provarlo gratis: con XAMPP, MAMP o Laragon in 5 minuti, oppure con il server integrato di PHP, poi mettilo online.

Aggiornato il 3 min di lettura

Indice
  1. Quale soluzione scegliere per installare Éclair in locale?
  2. Come installare Éclair in locale con XAMPP?
  3. E con il server integrato di PHP?
  4. Come mettere online il sito preparato in locale?
  5. Domande sull’installazione in locale

Vuoi scoprire Éclair prima di scegliere un hosting, o preparare il tuo sito con calma offline? Puoi installare Éclair in locale, sul tuo computer, in 5 minuti. Ti serve soltanto un piccolo server web con PHP: XAMPP, MAMP o Laragon se non sei uno sviluppatore, oppure il server integrato di PHP per gli altri. Il tuo sito sarà poi pubblicabile così com’è.

Quale soluzione scegliere per installare Éclair in locale?

StrumentoSistemiPer chi?
XAMPPWindows, macOS, LinuxIl più diffuso, gratuito, con Apache e PHP
MAMPmacOS, WindowsSemplicissimo su Mac, la versione gratuita basta
LaragonWindowsLeggero e veloce, apprezzato dagli sviluppatori
Server integrato di PHPTuttiSviluppatori a loro agio con il terminale

I primi tre installano Apache e PHP in pochi clic: è esattamente l’ambiente di un hosting condiviso, .htaccess compreso. Verifica solo che la versione di PHP proposta sia 8.1 o successiva.

Come installare Éclair in locale con XAMPP?

  1. Installa XAMPP, poi avvia il pannello di controllo e fai partire Apache (MySQL non serve).
  2. Scarica Éclair ed estrai l’archivio.
  3. Copia la cartella eclair nella cartella web di XAMPP: C:\xampp\htdocs\ su Windows, /Applications/XAMPP/htdocs/ su Mac.
  4. Apri http://localhost/eclair/ nel browser: parte la procedura guidata di installazione.
  5. Rispondi alle 4 domande, come spiegato nella guida all’installazione.

Con MAMP la cartella web si chiama anch’essa htdocs e l’indirizzo dipende dalla porta scelta (per esempio http://localhost:8888/eclair/). Con Laragon, metti la cartella in C:\laragon\www\, poi apri http://localhost/eclair/.

E con il server integrato di PHP?

Per gli sviluppatori: il repository GitHub di Éclair contiene un router che riproduce le regole del .htaccess per il server integrato di PHP. Servono PHP 8.1 o successivo e 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

Apri poi http://localhost:8000. La variabile PHP_CLI_SERVER_WORKERS permette al sito di chiamare se stesso per verificare il proprio indirizzo: con un solo processo questa verifica semplicemente fallisce, senza disturbare il resto. Lo stesso repository contiene i test (php tests/run.php, 502 verifiche): tutto è spiegato nella pagina per sviluppatori.

Come mettere online il sito preparato in locale?

Il tuo sito sta in una sola cartella: basta copiarla.

  1. Nell’area di amministrazione locale, scarica un backup per sicurezza (Sicurezza › Scarica un backup).
  2. Carica tutto il contenuto della cartella eclair presso il tuo provider, cartelle data e media comprese, insieme ai file nascosti .htaccess.
  3. Accedi all’area di amministrazione online con la stessa email e la stessa password.
  4. In Impostazioni › Generali, sostituisci l’indirizzo locale con quello definitivo del sito (per esempio https://il-tuo-sito.it).
  5. In Sicurezza, clicca su Verifica l’indirizzo del sito, poi svuota la cache in Impostazioni › Avanzate.

I link interni si adattano automaticamente, anche se il tuo sito passa da una sottocartella locale alla radice di un dominio. Per un hosting o2switch, segui la guida o2switch a partire dal passaggio 4.

Domande sull’installazione in locale

Devo installare MySQL per provare Éclair in locale?

No. Éclair non ha bisogno di alcun database: avvia soltanto Apache in XAMPP, MAMP o Laragon. Il modulo MySQL può restare spento.

Posso installare Éclair in locale senza connessione a Internet?

Sì, una volta scaricato Éclair. Solo l’assistente IA, IndexNow e l’invio delle email hanno bisogno di Internet; tutto il resto funziona offline.

Il mio sito locale sarà visibile su Google?

No. Un sito aperto su http://localhost è accessibile solo dal tuo computer. Diventa pubblico una volta copiato presso un hosting.

La procedura guidata indica «Installazione bloccata»: cosa fare?

La finestra di 2 ore dopo la prima visita è scaduta. Elimina il file data/install-window.php nella cartella di Éclair, poi ricarica la pagina.

Scarica Éclair 1.7.0