Solução de problemas

Este guia de solução de problemas do Éclair CMS reúne os problemas mais frequentes e as respectivas soluções, da senha esquecida ao erro 404. Cada seção corresponde a uma mensagem ou a um sintoma preciso: use o índice para ir direto ao seu. A maioria se resolve em dois minutos, com o seu programa de FTP ou o gerenciador de arquivos da hospedagem.

Esqueceu a senha ou perdeu o celular da autenticação de dois fatores?

Comece pelas soluções mais simples:

• Existe outro administrador: em Usuários, ele pode clicar em Redefinir senha (uma senha temporária é criada) ou em Desativar 2FA na sua conta.
• Você perdeu o celular, mas não os códigos: entre com um dos seus 8 códigos de recuperação no lugar do código de 6 dígitos.

Se você é o único administrador, use a recuperação por FTP. Crie um arquivo data/reset.php com exatamente estas três linhas:

<?php exit; ?>
seu-endereco@email.com.br
SuaNovaSenha2026

Em até 24 horas, faça login com esse e-mail e essa nova senha. A senha é substituída, a autenticação de dois fatores dessa conta é desativada, suas outras sessões são encerradas e o arquivo é apagado automaticamente.

“Instalação bloqueada”: o que fazer?

Por segurança, a instalação precisa ser feita nas 2 horas seguintes à primeira visita: caso contrário, qualquer pessoa poderia assumir o controle de um site enviado e esquecido. Passado esse prazo, apague o arquivo data/install-window.php por FTP e recarregue a página: uma nova janela de 2 horas se abre.

O que significa “Endereço do site não verificado” na página Segurança?

Seu servidor não consegue chamar a si mesmo no endereço do site: firewall da hospedagem, DNS ainda não propagado, domínio em transferência… O site funciona normalmente, mas sem redirecionamento para o endereço oficial (com ou sem www, http para https). Clique em Verificar endereço do site quando o domínio estiver pronto.

Por que um erro 404 em todas as páginas, menos a inicial?

O arquivo .htaccess não foi enviado, por ser um arquivo oculto, ou a reescrita de URL está desativada. Ative “Mostrar arquivos ocultos” no seu programa de FTP e envie-o de novo para a raiz do site. Se a sua hospedagem exigir, tire o comentário da linha RewriteBase / do .htaccess.

O que fazer diante de um erro 500 logo depois do envio?

Sua hospedagem recusa uma diretiva do .htaccess. É muito raro: só são usadas diretivas aceitas em hospedagens compartilhadas. Remova o bloco em questão ou fale com a sua hospedagem. Se aparecer a página “Oups, un court-circuit.” (em francês, “Ops, um curto-circuito”) com uma referência, os detalhes do erro estão em Segurança › Últimos erros técnicos.

Por que as imagens não são convertidas para WebP?

A extensão GD do PHP, ou o suporte dela ao WebP, não existe na sua hospedagem. Ative-a no painel de PHP da sua hospedagem. Enquanto isso, suas imagens continuam em JPG ou PNG: o site funciona, só fica um pouco menos leve.

Por que não recebo os e-mails do formulário?

Sem pânico: as mensagens também ficam salvas na administração, no menu Mensagens. Depois confira o endereço de recebimento em Configurações › Contato (campo Receber as mensagens no endereço); por padrão, é o e-mail do primeiro administrador. Algumas hospedagens exigem que o remetente pertença ao domínio do site: crie um endereço de e-mail no seu domínio, se for preciso.

Como ativar o modo de depuração?

Crie um arquivo eclair-config.php na raiz do site, ao lado do index.php, seguindo o modelo de eclair-config.exemple.php:

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

// Mostrar os detalhes dos erros enquanto você resolve o problema.
define('ECLAIR_DEBUG', true);

Os erros passam a ser exibidos em detalhe e o cache estático é desativado. Apague esse arquivo assim que o problema for resolvido: os detalhes dos erros não devem ficar visíveis para todos.

Todos os endereços IP são iguais: seu site está atrás de um proxy?

Se o registro de segurança mostra o mesmo endereço IP para todos os visitantes, seu site provavelmente é servido atrás de um proxy ou de uma CDN, como a Cloudflare. Os limites de tentativas, que valem por rede, passam então a atingir todo mundo de uma vez. Em Configurações › Avançado › “Site atrás de um proxy / CDN”, escolha o cabeçalho que repassa o endereço real: CF-Connecting-IP para a Cloudflare, X-Forwarded-For ou X-Real-IP, conforme a sua hospedagem.

O Éclair diz que precisa do PHP 8.1 ou superior?

Se a página mostrar “Éclair a besoin de PHP 8.1 ou plus récent” (em francês, “o Éclair precisa do PHP 8.1 ou superior”), sua hospedagem usa uma versão do PHP antiga demais. Troque-a na área do cliente da sua hospedagem, muitas vezes com um clique, e recarregue a página. O Éclair funciona do PHP 8.1 ao 8.5; escolha o 8.3 ou superior, se possível. O guia Instalar o Éclair na o2switch mostra onde fica essa configuração no cPanel.

O assistente de IA não responde?

Chave recusada, crédito esgotado, orçamento do mês atingido, conexões de saída bloqueadas: cada mensagem tem a sua solução no guia do assistente de IA.

Seu problema não está neste guia de solução de problemas do Éclair CMS?

Anote a mensagem de erro exata, a sua hospedagem e a sua versão do PHP e depois escreva para mim pela página Contato. Você também pode relatar um problema no GitHub: a solução dele vai enriquecer este guia de solução de problemas do Éclair CMS para todos os usuários.