Experimentar no seu computador

Quer conhecer o Éclair antes de escolher uma hospedagem, ou preparar seu site com calma, offline? Você pode instalar o Éclair localmente, no seu computador, em 5 minutos. Basta um pequeno servidor web com PHP: XAMPP, MAMP ou Laragon, se você não é desenvolvedor, ou o servidor embutido do PHP, se é. Depois, seu site poderá ser publicado do jeito que está.

Que solução escolher para instalar o Éclair localmente?

Os três primeiros instalam Apache e PHP em poucos cliques: é exatamente o ambiente de uma hospedagem compartilhada, .htaccess incluído. Só confira se a versão do PHP oferecida é 8.1 ou superior.

Como instalar o Éclair localmente com o XAMPP?

1. Instale o XAMPP, abra o painel de controle e inicie o Apache (o MySQL é desnecessário).
2. Baixe o Éclair e descompacte o arquivo ZIP.
3. Copie a pasta eclair para a pasta web do XAMPP: C:\xampp\htdocs\ no Windows, /Applications/XAMPP/htdocs/ no Mac.
4. Abra http://localhost/eclair/ no navegador: o assistente de instalação começa.
5. Responda às 4 perguntas, como explicado no guia de instalação.

No MAMP, a pasta web também se chama htdocs, e o endereço depende da porta escolhida (por exemplo, http://localhost:8888/eclair/). No Laragon, coloque a pasta em C:\laragon\www\ e abra http://localhost/eclair/.

E com o servidor embutido do PHP?

Para desenvolvedores: o repositório do Éclair no GitHub contém um roteador que reproduz as regras do .htaccess para o servidor embutido do PHP. É preciso ter PHP 8.1 ou superior e o 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

Depois, abra http://localhost:8000. A variável PHP_CLI_SERVER_WORKERS permite que o site chame a si mesmo para verificar o próprio endereço: com um único processo, essa verificação simplesmente falha, sem atrapalhar o resto. O mesmo repositório contém os testes (php tests/run.php, 502 verificações): tudo está detalhado na página para desenvolvedores.

Como colocar no ar o site preparado localmente?

Seu site cabe em uma única pasta: basta copiá-la.

1. Na administração local, baixe um backup por segurança (Segurança › Baixar backup).
2. Envie todo o conteúdo da pasta eclair para a sua hospedagem, incluindo as pastas data e media, com os arquivos ocultos .htaccess.
3. Entre na administração online com o mesmo e-mail e a mesma senha.
4. Em Configurações › Geral, troque o endereço local pelo endereço definitivo do site (por exemplo, https://seu-site.com.br).
5. Em Segurança, clique em Verificar endereço do site e depois limpe o cache em Configurações › Avançado.

Os links internos se adaptam automaticamente, mesmo que o seu site passe de uma subpasta local para a raiz de um domínio. Se a sua hospedagem for a o2switch, siga o guia da o2switch a partir da etapa 4.

Baixar o Éclair 1.7.0