Como corrigir o erro “PHP Missing MySQL Extension” no WordPress

Recentemente, um usuário encontrou o erro “sua instalação do PHP parece não ter a extensão MySQL, que é exigida pelo WordPress” e nos perguntou se havia uma maneira de corrigi-lo.

Quando esse erro aparece, ele impede que os usuários visualizem seu site. Se isso ocorrer com frequência, pode ser ruim para a experiência do usuário do seu site.

Neste artigo, mostraremos a você como corrigir o erro de extensão MySQL ausente no PHP no WordPress.

O que é o erro PHP Missing MySQL Extension?

Quando estiver trabalhando na criação de um site WordPress ou visitando uma página da Web, você poderá se deparar com o erro “sua instalação do PHP parece não ter a extensão MySQL, que é exigida pelo WordPress”.

Esse erro geralmente significa que algo deu errado com o código do seu site e está impedindo que o WordPress se conecte ao banco de dados MySQL.

O erro PHP missing MySQL extension geralmente aparece quando você atualiza ou instala o WordPress, migra um site, altera as configurações do servidor ou muda de sistema operacional que não tem uma extensão MySQL (como o Linux).

Dito isso, vamos ver as causas desse erro.

Quais são as causas do erro de extensão MySQL ausente no PHP?

Há vários motivos pelos quais pode ocorrer um erro de extensão MySQL ausente no PHP.

Uma delas é que você está usando uma versão desatualizada do WordPress com a versão mais recente do PHP. Se estiver usando o PHP 7.0 ou superior, você deve saber que ele descontinuou a extensão MySQL.

Portanto, se você tiver uma versão mais antiga do WordPress que esteja funcionando com PHP 7.0 ou superior, ele não encontrará a extensão MySQL e causará esse erro.

Outro motivo pelo qual você pode ver esse erro é que a extensão MySQL está ausente ou não está configurada corretamente. Mesmo que você esteja usando o PHP 5.6 ou inferior, o erro PHP missing MySQL extension ainda pode ocorrer devido a uma extensão MySQL desatualizada.

Agora, vamos ver algumas maneiras de corrigir o erro “sua instalação do PHP parece não ter a extensão MySQL, que é exigida pelo WordPress”.

Você pode usar os links abaixo para conferir qualquer uma das dicas que desejar:

Como corrigir o erro de extensão PHP Missing MySQL no WordPress

Agora que você sabe o que causa esse erro do WordPress, aqui estão algumas maneiras de corrigi-lo.

1. Verifique a versão do PHP que você está usando

A primeira coisa que você pode fazer é verificar a versão do PHP do seu site. Um conflito entre o WordPress e a versão do PHP geralmente resulta no erro PHP missing MySQL extension.

Para começar, você pode ir para a página Ferramentas ” Saúde do site no painel do WordPress. A partir daí, basta alternar para a guia “Info”.

Depois disso, role para baixo até a seção “Server” (Servidor) e clique para expandi-la. Aqui, você verá as informações do servidor do seu site.

Vá em frente e veja a versão do PHP nos detalhes.

Se a versão PHP do seu site começar com 7 ou menos, isso significa que você precisará atualizá-la. Isso pode resolver o erro de extensão MySQL ausente no PHP, pois ele seria compatível com a versão mais recente do WordPress.

É altamente recomendável usar o PHP 8.0 ou a versão mais recente, pois isso protegerá seu site contra ameaças à segurança. Além disso, ele também otimizará o desempenho do seu site e corrigirá todas as vulnerabilidades e bugs de segurança.

Você pode saber mais seguindo nosso guia sobre como atualizar sua versão do PHP no WordPress.

2. Atualize o WordPress para a versão mais recente

Depois de verificar a versão do PHP, você também pode ver qual versão do WordPress está usando.

Se for uma versão mais antiga e você estiver executando a versão mais recente do PHP, considere atualizar o WordPress para resolver o erro de extensão MySQL ausente no PHP.

Uma maneira simples de verificar a versão do WordPress é acessar Dashboard ” Updates no painel de administração do WordPress. Aqui, procure a informação “Versão atual”.

Se a versão do WordPress for 3.9 ou inferior, recomendamos atualizá-la para corrigir o erro de extensão MySQL ausente.

A melhor coisa é que o WordPress vem com um gerenciador de atualizações integrado. Você pode atualizar para a versão mais recente com o clique de um botão.

Para saber mais, consulte nosso guia sobre como atualizar o WordPress com segurança.

3. Verifique se você tem a extensão MySQL instalada

Agora que você atualizou a versão do PHP e do WordPress em seu site e ainda está enfrentando o erro “PHP missing MySQL extension”, é necessário verificar se a extensão MySQL está instalada corretamente em seu site.

Você pode fazer isso acessando a página Ferramentas ” Saúde do site no painel do WordPress. Em seguida, você precisará mudar para a guia “Info”.

Depois disso, vá até a seção “Database” (Banco de dados) e clique para expandi-la.

No campo Extensão, procure por mysqli ou mysql.

Se o campo estiver em branco ou não estiver visível, isso significa que você não tem a extensão MySQL.

Agora, o processo de instalação da extensão dependerá de seu provedor de hospedagem WordPress. Você pode simplesmente entrar em contato com eles para obter ajuda ou pedir à equipe de suporte que a instale para você.

4. Verifique sua configuração de PHP

Outra maneira de corrigir o erro de extensão MySQL ausente no PHP é verificar as configurações de PHP do seu site.

Às vezes, você pode estar carregando o arquivo php.ini errado ou usando o caminho de arquivo errado. Isso leva a problemas de configuração do PHP e a erros de extensão do MySQL ausentes.

O arquivo php.ini é um arquivo de configuração padrão para PHP e afeta o funcionamento do seu site. O upload do arquivo incorreto geralmente acontece se você estiver usando um sistema operacional diferente. Por exemplo, você pode estar carregando o arquivo php.ini destinado ao Windows em um servidor Linux.

Para localizar o caminho do seu arquivo php.ini no arquivo phpinfo.php, digite o seguinte endereço da Web no navegador:

www.example.com/phpinfo.php

Apenas certifique-se de substituir www.example.com pelo nome de seu domínio.

Em seguida, você verá detalhes da sua instalação do PHP.

A partir daí, você pode rolar para baixo e procurar os campos “Configuration File Path” (Caminho do arquivo de configuração) ou “Loaded Configuration File” (Arquivo de configuração carregado).

Depois de localizar o arquivo php.ini, basta conectar-se a um cliente FTP, acessar o caminho do arquivo e excluí-lo para ver se isso corrige o erro de extensão MySQL ausente no PHP.

Antes de excluir, recomendamos criar um backup do arquivo existente, baixando-o em seu computador. Dessa forma, se algo der errado, você poderá restaurar o arquivo php.ini e acessar seu site.

Recursos de bônus para correção de erros do WordPress

Agora que você já sabe sobre o erro de extensão MySQL ausente no PHP, confira também nossos guias sobre a resolução de outros erros do WordPress:

• Como corrigir o erro crítico no WordPress (passo a passo)
• Como corrigir o erro interno do servidor 500 no WordPress
• Como corrigir o erro de servidor DNS que não está respondendo no WordPress (5 maneiras)
• Como ativar facilmente o modo de depuração do WordPress para corrigir erros do site
• Como corrigir o erro de falha no pós-processamento de imagem no WordPress

Esperamos que este artigo tenha ajudado você a aprender como corrigir o erro de extensão PHP missing MySQL no WordPress. Talvez você também queira ver nossas dicas para acelerar o desempenho do WordPress ou nosso guia completo de solução de problemas do WordPress.

Se você gostou deste artigo, inscreva-se em nosso canal do YouTube para receber tutoriais em vídeo sobre o WordPress. Você também pode nos encontrar no Twitter e no Facebook.