Erro ao estabelecer uma ligação à base de dados

A mensagem Error establishing a database connection (em português, Erro ao estabelecer uma ligação à base de dados) significa que o seu site não consegue contactar a base de dados ou não tem permissão para iniciar sessão. Os seus ficheiros continuam lá, e normalmente a base de dados também. Em nove em cada dez casos, há algo incorreto nos dados que o seu site utiliza para iniciar sessão.

Causas, da mais frequente à mais rara

1. Os dados no ficheiro de configuração estão incorretos

Isto acontece sobretudo após uma mudança, uma nova instalação ou a alteração de uma palavra-passe. Verifique da seguinte forma:

1. Abra em DirectAdmin Bancos de dados. Aí vê o nome completo da sua base de dados e os utilizadores associados a ela (veja Criar um banco de dados e Utilizadores de bases de dados, permissões e palavras-passe).
2. Abra em Gerenciador de arquivos o ficheiro de configuração do seu site. No WordPress, é o wp-config.php em public_html.
3. Compare os quatro valores:
   • DB_NAME: o nome completo da base de dados, com o seu nome de utilizador do DA e um traço antes, por exemplo wtsilefl_shop.
   • DB_USER: o nome completo do utilizador da base de dados, também com esse prefixo.
   • DB_PASSWORD: a palavra-passe desse utilizador da base de dados. Não é a sua palavra-passe do DA.
   • DB_HOST: localhost.

Não tem a certeza da palavra-passe? Atribua uma nova palavra-passe ao utilizador da base de dados em DirectAdmin e introduza exatamente essa palavra-passe em wp-config.php. Tenha atenção às aspas e aos espaços.

Noutros sistemas, o ficheiro tem outro nome, por exemplo configuration.php no Joomla, app/config/parameters.php no PrestaShop ou .env no Laravel.

2. O utilizador já não está associado à base de dados

Um utilizador de base de dados precisa de ter permissões sobre a base de dados. Verifique em Bancos de dados se o utilizador está associado à base de dados correta. Se não estiver, associe-o novamente (veja Utilizadores de bases de dados, permissões e palavras-passe).

3. A base de dados está vazia ou não foi importada

Se mudou o seu site de servidor, verifique no phpMyAdmin se as tabelas estão realmente lá (veja Abrir e utilizar o phpMyAdmin). Se não houver tabelas, importe novamente a base de dados (veja Importar um banco de dados, mesmo ficheiros grandes).

4. Tabelas danificadas

Recebe a mensagem apenas ocasionalmente, ou o WordPress indica que uma ou mais tabelas não estão disponíveis? Verifique e repare a base de dados (veja Verificar, reparar e otimizar um banco de dados).

5. Demasiadas ligações

Vê no registo de erros Too many connections ou max_user_connections? Isso significa que o seu site está a estabelecer demasiadas ligações em simultâneo com a base de dados, muitas vezes devido a um plugin com muito tráfego ou que não funciona bem, ou devido a bots. Leia O meu site está lento.

6. O armazenamento está cheio

Um espaço em disco esgotado também pode causar falhas na base de dados. Consulte no painel principal o item Espaço em disco (veja Armazenamento cheio: onde está o espaço a ser usado?).

7. Uma falha de serviço

Raramente, o problema está no próprio servidor de bases de dados. Nesse caso, consulte Storingen & onderhoud para ver se há alguma ocorrência.

Testar se os dados estão corretos

Se conseguir ver as tabelas no phpMyAdmin a partir do DirectAdmin, a base de dados existe e está lá. Se continuar a receber a mensagem, o problema está quase de certeza no ficheiro de configuração do seu site.

Sugestão: Funcionava ontem e não sabe o que mudou? Com WebOké Backups em O meu WebOké pode colocar a base de dados de um momento anterior como cópia junto da atual, com um novo nome. Assim compara sem qualquer risco (veja Isto também é possível em O meu WebOké? WebOké Backups).