Como corrigir o erro “Sua instalação do PHP parece estar sem a extensão MySQL” no WordPress?

Se você já tentou instalar ou carregar o WordPress e se deparou com o erro “Sua instalação do PHP parece não ter a extensão MySQL, que é necessária para o WordPress”, saiba que não está sozinho. Esse erro de ausência da extensão MySQL no WordPress paralisa seu site e pode parecer desesperador à primeira vista.

A boa notícia é que quase sempre se trata de um problema com o driver PHP MySQL ou com a configuração do servidor. Com os passos certos, você pode corrigi-lo sem conhecimentos técnicos avançados.

Resumo: Extensão MySQL ausente: o que você precisa saber

• O PHP não consegue encontrar o driver de banco de dados necessário para se comunicar com o MySQL, portanto o WordPress não carrega. Este é um erro de extensão PHP não carregada no nível do servidor.

• O erro geralmente é causado por uma atualização do PHP, uma migração de servidor ou um arquivo php.ini mal configurado, fazendo com que o site WordPress seja desativado para todos os visitantes.

• Habilitar a extensão MySQLi ou PDO_MySQL no PHP resolve o problema na maioria dos casos.

• Se alterações no nível do servidor estiverem fora da sua zona de conforto, seu provedor de hospedagem pode aplicar a correção rapidamente.

Visão geral do erro "Sua instalação do PHP parece estar sem a extensão MySQL" no WordPress

Esse erro ocorre quando o WordPress não consegue se conectar ao banco de dados porque uma extensão MySQL necessária está faltando ou desativada na sua configuração do PHP.

O que significa a mensagem de erro no WordPress?

A mensagem de erro completa é: “Sua instalação do PHP parece não ter a extensão MySQL, que é necessária para o WordPress.”

Em termos simples, o PHP não consegue localizar a biblioteca necessária para se comunicar com o seu banco de dados MySQL. Essa ausência da extensão PHP causa um erro no banco de dados do WordPress antes que qualquer conteúdo possa ser exibido.

Sem essa conexão, o WordPress não consegue carregar nenhum conteúdo, configuração ou parte do seu site. O site inteiro fica inacessível.

Isso não é um bug do WordPress. É um problema no servidor. O WordPress simplesmente detecta o componente ausente e o reporta.

Exemplo de mensagem de erro de extensão MySQL ausente

Quando esse erro ocorre, você geralmente vê uma das seguintes mensagens em uma tela branca em branco. Essa tela branca do WordPress geralmente não apresenta nenhuma explicação adicional:

• "Aparentemente, sua instalação do PHP não possui a extensão MySQL, que é necessária para o WordPress."

• “Não foi possível conectar ao MySQL.”

• “Não foi possível selecionar o banco de dados.”

Essas mensagens geralmente aparecem antes do carregamento do painel de administração do WordPress. Você também pode ver esse erro durante uma instalação nova do WordPress, quando o script de configuração não consegue se conectar ao banco de dados.

Por que esse erro está prejudicando seu site WordPress?

O WordPress é totalmente baseado em banco de dados. Cada carregamento de página aciona uma consulta PHP ao seu banco de dados MySQL. Uma conexão MySQL interrompida significa que o WordPress não pode fazer nenhuma das seguintes coisas:

• Recupere publicações, páginas, categorias ou comentários.
• Carregue as configurações do seu tema ativo e as configurações dos widgets.
• Autenticar logins de usuários.
• Execute qualquer funcionalidade dos plugins instalados.

O resultado é um site completamente não funcional. Os visitantes veem uma tela de erro em vez do seu conteúdo.

Relação entre PHP, MySQL e conexão de banco de dados WordPress

PHP é a linguagem de script que alimenta o WordPress. MySQL é o banco de dados relacional que armazena todos os dados do seu site: posts, usuários, configurações, dados de pluginse muito mais.

Esses dois sistemas se comunicam por meio de uma extensão PHP que atua como uma ponte. O WordPress gerencia isso internamente por meio de sua camada de abstração de banco de dados, a classe wpdb.

Cada vez que um visitante acessa seu site, o PHP envia consultas ao MySQL por meio da classe wpdb, recupera os dados relevantes e retorna os resultados como uma página HTML. Se a extensão PHP necessária para essa comunicação estiver ausente ou desativada, todo o processo falha.

O WordPress verifica a presença dessa extensão na inicialização. Se não encontrar nada, ele exibe imediatamente um erro de "extensão MySQL ausente".

MySQL vs MySQLi vs PDO: Uma explicação sobre MySQL

Três extensões do PHP podem lidar com conexões de banco de dados MySQL:

• MySQL: A extensão original do MySQL para PHP. Foi descontinuada no PHP 5.5 e removida permanentemente no PHP 7.0. O WordPress também deixou de oferecer suporte a ela na mesma época. Se o seu servidor estiver executando o PHP 7.0 ou superior (o que é recomendável), essa extensão simplesmente não estará disponível. Usá-la nunca foi uma opção viável a longo prazo.

• MySQLi: A extensão "aprimorada" do MySQL (o "i" significa aprimorado). Você pode habilitar o MySQLi no PHP através do php.ini ou do painel de controle da sua hospedagem. Ele suporta estilos de programação orientados a objetos e procedurais. Também adiciona recursos como instruções preparadas e múltiplas instruções. O WordPress usa o MySQLi por padrão quando disponível.

• PDO_MySQL: Objetos de Dados PHP, uma interface de banco de dados mais abstrata. Suporta múltiplos sistemas de banco de dados através de uma API única e consistente. O WordPress pode usar PDO_MySQL como alternativa quando o MySQLi não estiver disponível.

O WordPress moderno exige que o MySQLi ou o PDO_MySQL estejam instalados e ativos. Caso nenhum dos dois esteja presente, o erro de extensão MySQL ausente aparece imediatamente.

O que causa o erro de extensão MySQL ausente no WordPress?

Diversos cenários distintos podem desencadear esse erro. Identificar a causa raiz é o primeiro passo para a solução correta.

• Atualização do PHP sem transferência de extensões: Ao atualizar o PHP, por exemplo, da versão 7.4 para a 8.1 ou 8.2, a nova instalação pode não incluir automaticamente todas as extensões anteriormente ativas. O pacote php-mysqli geralmente precisa ser reinstalado separadamente. A extensão MySQLi pode ser omitida da nova instalação, mesmo que estivesse ativa na anterior. Este é um dos gatilhos mais comuns para esse erro em ambientes de produção.

• Migração de servidor: Mover seu site WordPress para um novo servidor ou trocar de provedor de hospedagem pode resultar em um ambiente PHP mal configurado. Nem todas as configurações de servidor habilitam o MySQLi por padrão. O novo servidor pode executar o PHP sem ele.

• Arquivo php.ini corrompido ou incompleto. O arquivo php.ini controla todos os aspectos do seu ambiente PHP, incluindo quais extensões são carregadas e onde o PHP as procura através da extension_dir . Se este arquivo estiver corrompido, incompleto ou faltando a linha correta da extensão MySQLi, o PHP apresentará um erro de inicialização e o WordPress não conseguirá encontrar o driver necessário.

• Várias versões do PHP em execução simultânea. Alguns servidores executam várias versões do PHP lado a lado. Se o WordPress estiver apontando para o binário do PHP errado, um que não possui o MySQLi, você verá esse erro mesmo que outros sites no mesmo servidor funcionem normalmente. Esse conflito de versões do PHP é fácil de passar despercebido, pois o painel de controle da hospedagem pode mostrar a versão correta enquanto o servidor web está usando uma versão diferente.

• Instalação nova em um servidor personalizado: Novas instalações do WordPress em servidores locais com configuração personalizada, como XAMPP, MAMP, Laragon ou contêineres Docker, frequentemente falham ao habilitar o MySQLi por padrão. Desenvolvedores que configuram ambientes locais frequentemente se deparam com esse problema, pois a extensão php-mysqli precisa ser habilitada manualmente na maioria das configurações padrão do XAMPP e MAMP.

• Alterações na configuração do provedor de hospedagem: Os provedores de hospedagem ocasionalmente ajustam as configurações do servidor durante janelas de manutenção ou atualizações de infraestrutura. Essas alterações podem desativar inadvertidamente extensões anteriormente ativas.

Métodos para corrigir o erro de extensão MySQL ausente no WordPress

Você pode resolver esse problema habilitando a extensão MySQL, atualizando o PHP ou corrigindo as configurações do seu servidor.

Método 1: Instalar ou ativar a extensão MySQLi no PHP

Esta é a solução mais direta. Em um servidor Linux, você pode instalar a extensão MySQLi usando o gerenciador de pacotes. O pacote geralmente se chama php-mysqli em sistemas baseados em Debian.

Para Ubuntu ou Debian (instale php-mysqli):

sudo apt install php-mysqli sudo service apache2 restart

Para CentOS ou RHEL:

sudo yum install php-mysqli sudo systemctl restart httpd

Após a instalação, reinicie o servidor web. Em seguida, recarregue a página WordPress para verificar se o erro foi corrigido.

Se você estiver em uma hospedagem compartilhada, procure a seção "Extensões PHP" ou "Selecionar extensões PHP" no seu painel de controle (cPanel, Plesk ou similar). Localize o mysqli na lista, habilite-o e salve as alterações. A alteração geralmente entra em vigor imediatamente.

Método 2: Verificar e atualizar ou fazer downgrade da versão do PHP

Uma versão incompatível do PHP é uma causa frequente. O WordPress recomenda oficialmente o PHP 8.1 ou superior.

Executar uma versão não suportada, especialmente uma que não possua extensões essenciais, causa esse erro. O PHP 8.1 e o PHP 8.2 incluem o MySQLi por padrão em servidores configurados corretamente.

Para verificar e alterar sua versão do PHP:

• Faça login no painel de controle da sua hospedagem.

• Procure por “Versão do PHP”, “Gerenciador MultiPHP” ou uma opção similar (no cPanel, isso fica em “Software”).

• Mude para o PHP 8.1 ou 8.2, que já incluem o MySQLi por padrão.

Se uma atualização recente causou problemas no seu site, você pode reverter temporariamente para a versão anterior enquanto investiga o ocorrido. Alguns serviços de hospedagem permitem a seleção da versão do PHP por domínio.

Sempre teste as alterações de versão do PHP em um ambiente de teste antes de aplicá-las em produção. Uma incompatibilidade de versões pode quebrar plugins e temas, além de causar erros no banco de dados.

Método 3: Atualizar o núcleo, os temas e os plugins do WordPress

Arquivos principais, temas ou plugins desatualizados às vezes causam erros de compatibilidade, incluindo falhas na camada de banco de dados PHP.

O WordPress atualiza regularmente sua classe de abstração de banco de dados interna (wpdb) para oferecer suporte a versões mais recentes do PHP e aos requisitos de compatibilidade com o MySQL.

Para atualizar o WordPress:

• Acesse Painel de Controle → Atualizações no seu painel de administração.
• Clique em Atualizar agora para o núcleo do WordPress.
• Em seguida, atualize todos os plugins e temas ativos.

Se você não conseguir acessar o painel de administração porque o erro está bloqueando o acesso, atualize via FTP enviando os arquivos mais recentes do WordPress baixados diretamente do WordPress.org. Esta é uma maneira segura de atualizar os arquivos principais sem alterar a pasta wp-content.

Sempre faça backup completo do seu site e banco de dados antes de executar qualquer atualização. Isso protege seus dados caso algo dê errado durante o processo.

Método 4: Verificar a configuração do PHP usando phpinfo()

A phpinfo() gera um relatório detalhado do ambiente PHP do seu servidor. Executar uma verificação do WordPress com phpinfo() é uma das maneiras mais rápidas de confirmar se o MySQLi ou o PDO_MYSQL está carregado.

• Crie um novo arquivo chamado info.php no diretório raiz do seu WordPress.
• Adicione esta única linha: <?php phpinfo(); ?>
• Acesse yourdomain.com/info.php no seu navegador.
• Use CTRL+F para pesquisar por “mysqli” ou “pdo_mysql” na saída.

Se você vir uma seção intitulada “mysqli” com o status ativado, a extensão está carregada. Caso contrário, a extensão está faltando e precisa ser adicionada.

Nota de segurança: exclua o info.php imediatamente após a verificação. Deixá-lo acessível expõe dados detalhados da configuração do servidor a qualquer pessoa que visite o URL.

Método 5: Corrigir problemas de configuração do php.ini

O arquivo php.ini determina quais extensões do PHP são carregadas na inicialização. Um caractere de comentário (ponto e vírgula) no início da linha da extensão impedirá que ela seja carregada. A linha que você está procurando é extension=mysqli.

• Acesse seu servidor via FTP ou SSH.
• Localize o seu arquivo php.ini. Os caminhos comuns incluem /etc/php/8.1/apache2/php.ini ou /etc/php.ini.
• Procure pela linha: ;extension=mysqli
• Remova o ponto e vírgula para descomentá-lo: extension=mysqli
• Salve o arquivo e reinicie o servidor web.

Se o seu provedor de hospedagem restringir o acesso direto ao arquivo php.ini, crie um .user.ini no diretório raiz do seu WordPress. Adicione extension=mysqli a ele e salve. O PHP detectará esse .user.ini automaticamente na maioria das plataformas de hospedagem compartilhada.

Método 6: Resolver conflitos entre múltiplas versões do PHP

Em servidores que executam várias versões do PHP, o WordPress pode ser atribuído à versão errada. Se essa versão não tiver o MySQLi, o erro ocorrerá.

Para resolver isso:

• Confirme qual versão do PHP seu site está usando (via phpinfo() , conforme descrito no Método 4).

• No cPanel, abra o Gerenciador MultiPHP e atribua a versão correta do PHP ao seu domínio.

• Abra as extensões do PHP e verifique se o mysqli está habilitado para essa versão específica.

Em um servidor autogerenciado, use `php -v` no terminal para confirmar a versão ativa e `php -m | grep mysqli` para confirmar se o MySQLi está carregado para esse binário. Se `php -m | grep mysqli` não retornar nada, significa que a extensão está faltando para essa versão.

Método 7: Reinstalar o PHP e as extensões necessárias

Se a ativação do MySQLi falhar, a própria instalação do PHP pode estar corrompida. Uma reinstalação limpa do PHP e do módulo mysqli resolve o problema.

No Ubuntu ou Debian:

sudo apt purge php8.1 php8.1-mysql sudo apt install php8.1 php8.1-mysqli sudo service apache2 restart

No CentOS ou RHEL:

sudo yum remove php php-mysql sudo yum install php php-mysqli sudo systemctl restart httpd

Após reinstalar, execute o comando `php -m | grep mysqli` no seu terminal para confirmar se a extensão está ativa. Você deverá ver “mysqli” na saída.

Método 8: Verificar a configuração da pilha de servidores (Apache ou Nginx e MySQL)

Seu servidor web deve encaminhar corretamente as requisições PHP para o interpretador PHP correto. Uma configuração incorreta nesse ponto pode impedir o carregamento de extensões, mesmo quando elas estão instaladas.

• Para o Apache: Verifique se o mod_php ou o php-fpm está configurado corretamente. O mod_php carrega o PHP diretamente como um módulo, enquanto o PHP-FPM é executado como um processo separado. Verifique a configuração do seu VirtualHost para confirmar se o manipulador PHP correto está atribuído.

• Para Nginx: O Nginx não executa PHP nativamente e sempre requer PHP-FPM. Confirme se a `fastcgi_pass` no seu bloco de servidor aponta para o arquivo de socket PHP-FPM correto. Certifique-se de que o pool PHP-FPM esteja executando a versão que suporta MySQLi.

Após qualquer alteração, reinicie o servidor web e o PHP-FPM:

sudo systemctl restart nginx sudo systemctl restart php8.1-fpm

Leia mais: Apache vs Nginx: Qual é o melhor para hospedar o WordPress?

Método 9: Entre em contato com seu provedor de hospedagem para obter assistência

Se algum dos métodos acima parecer muito técnico, seu provedor de hospedagem é o caminho mais rápido para a solução. A maioria dos serviços de hospedagem WordPress gerenciada resolve problemas com extensões PHP em minutos, como parte do suporte padrão.

Ao entrar em contato com o suporte, inclua:

• A mensagem de erro exata que você está vendo.

• A versão do PHP que seu site usa atualmente (obtida do phpinfo ou do cPanel).

• Quando o erro surgiu pela primeira vez, após uma atualização, migração ou manutenção do servidor.

Os provedores que oferecem hospedagem gerenciada de WordPress cuidam das configurações de PHP no nível do servidor, incluindo o suporte a extensões de PHP, em seu nome.

Em hospedagem compartilhada, a equipe de suporte pode habilitar o MySQLi no servidor sem que você precise fazer nada.

Solução de problemas avançada para o erro de extensão MySQL ausente no WordPress

Se os métodos padrão acima não resolverem o erro, essas técnicas avançadas podem ajudar a identificar o problema.

Analise o seu arquivo wp-config.php. Mesmo com o MySQLi instalado, credenciais de banco de dados incorretas no arquivo wp-config.php impedirão a conexão. Abra o arquivo wp-config.php e verifique as seguintes configurações de banco de dados:

define( 'DB_NAME', 'nome_do_seu_banco_de_dados' ); define( 'DB_USER', 'nome_de_usuário_do_seu_banco_de_dados' ); define( 'DB_PASSWORD', 'senha_do_seu_banco_de_dados' ); define( 'DB_HOST', 'localhost' );

Um valor incorreto em qualquer um desses campos, especialmente em DB_HOST, pode gerar erros que, à primeira vista, parecem ser erros de extensão ausente.

Alguns provedores de hospedagem usam um nome de host específico em vez de localhost, e usar o valor errado bloqueia a conexão mesmo quando o MySQLi está instalado corretamente.

Ative o modo de depuração do WordPress. Adicione estas linhas ao seu wp-config.php para ativar a geração de relatórios de erros detalhados. A variável de ambiente WP_DEBUG_LOG salva todos os erros em um arquivo, em vez de exibi-los publicamente.

define( 'WP_DEBUG', true ); define( 'WP_DEBUG_LOG', true ); define( 'WP_DEBUG_DISPLAY', false );

O arquivo WP_DEBUG_LOG é salvo em wp-content/debug.log. Procure por mensagens relacionadas a extensões PHP ou erros de inicialização do PHP neste arquivo. Linhas que mencionam mysqli_connect, "Call to undefined function"ou nomes de módulos ausentes apontam diretamente para o problema com a extensão.

Analise os logs de erros do servidor. O Apache armazena os logs de erros em /var/log/apache2/error.log. O Nginx usa /var/log/nginx/error.log. Esses logs de erros do servidor geralmente registram o motivo exato pelo qual uma extensão PHP não carregou, como uma biblioteca compartilhada ausente, um extension_dir ou um problema de permissão de arquivo que impede a leitura da extensão.

Verifique se há softwares de segurança conflitantes. Firewalls de aplicativos da Web (WAFs), ferramentas antivírus de nível de servidor e plugins de segurança agressivos do WordPress podem ocasionalmente interferir no carregamento de extensões PHP ou bloquear solicitações de handshake do banco de dados. Desative-os temporariamente e teste novamente. Se o erro desaparecer, a ferramenta de segurança era a causa. Reative-a e adicione a porta de conexão com o banco de dados à lista de permissões (normalmente 3306) para restaurar a proteção sem o conflito.

Teste em um ambiente de homologação. Nunca teste alterações no servidor diretamente em um site em produção. Use um ambiente de homologação para aplicar e verificar as correções antes de implementá-las em produção. A maioria dos provedores de hospedagem gerenciada inclui ambientes de homologação em seus planos.

Melhores práticas para evitar erros de extensão MySQL no WordPress

Prevenir é sempre mais barato e menos estressante do que remediar. Essas práticas reduzem a probabilidade de esse erro aparecer no seu site WordPress.

• Mantenha o PHP atualizado e em conformidade com os requisitos do WordPress. Sempre utilize uma versão do PHP que atenda às recomendações atuais do WordPress (PHP 8.1 ou superior a partir de 2024–2025). Ao atualizar o PHP, verifique se todas as extensões necessárias, MySQLi e PDO_MySQL estão explicitamente incluídas na nova instalação. Consulte a página oficial de requisitos do PHP para WordPress antes de cada atualização.

• Teste as atualizações do PHP em um ambiente de teste. Antes de atualizar o PHP no seu site em produção, execute a nova versão em um ambiente de teste. Realize um teste de compatibilidade do PHP com o WordPress usando ferramentas como o plugin PHP Compatibility Checker. Confirme se o MySQLi carrega corretamente e se todos os plugins e temas permanecem compatíveis antes de enviar as alterações para produção.

• Utilize hospedagem WordPress gerenciada. Os provedores de hospedagem gerenciada cuidam da configuração do PHP no nível do servidor automaticamente. Eles mantêm o PHP e suas extensões atualizados e configurados corretamente, reduzindo bastante sua exposição a esse tipo de erro.

• Faça backups regulares do site. Mantenha sempre backups atualizados dos seus arquivos do WordPress e do seu banco de dados. Se uma alteração no servidor causar esse erro, um backup permitirá que você restaure um estado funcional enquanto corrige a causa raiz.

• Monitore seu site com o monitoramento de tempo de atividade. O monitoramento de tempo de atividade do WordPress em tempo real alerta você no momento em que seu site fica offline. Um alerta de inatividade significa que você detecta um erro de extensão do MySQL em minutos, em vez de horas. Minimizar o tempo de inatividade protege seus visitantes, seu posicionamento nos mecanismos de busca e sua receita.

• Documente a infraestrutura do seu servidor. Se você gerencia seu próprio servidor, mantenha registros detalhados de todas as extensões e configurações do PHP em uso. Essa documentação facilita muito a replicação do ambiente após migrações ou grandes atualizações.

• Siga uma rotina regular de manutenção do WordPress. Uma rotina de manutenção estruturada, incluindo atualizações do núcleo, plugins e temas, verificação da versão do PHP e otimização do banco de dados do WordPress, evita desvios de configuração e detecta problemas de compatibilidade antes que eles causem erros no site em produção. Agende uma revisão mensal da sua configuração do PHP juntamente com suas tarefas de manutenção habituais.

Considerações finais

O erro “Sua instalação do PHP parece estar sem a extensão MySQL” é incômodo, mas solucionável. Na maioria dos casos, o problema se resume a uma extensão MySQLi desativada ou ausente na sua configuração do PHP, um problema com a extensão do banco de dados PHP e não com o WordPress.

Comece pelo caminho mais simples: verifique se o MySQLi está habilitado no painel de controle da sua hospedagem e habilite-o, caso contrário. Se isso não resolver o problema, siga os métodos na ordem indicada, verificando sua versão do PHP, editando o arquivo php.ini com a linha extension=mysqlie reinstalando o PHP, se necessário.

Quando as alterações no nível do servidor estão fora da sua área de especialização, seu provedor de hospedagem geralmente consegue resolvê-las em poucos minutos.

Mais importante ainda, crie as condições adequadas para evitar que esse erro se repita. Mantenha o PHP atualizado, utilize hospedagem WordPress gerenciada e comprometa-se com uma rotina de manutenção regular. Um site WordPress bem mantido evita a maioria desses erros antes que eles atinjam seus visitantes e se recupera rapidamente quando ocorrem.

Perguntas frequentes sobre como corrigir o erro "Sua instalação do PHP parece estar sem a extensão MySQL"