No WordPress, você se deparará com o erro 'sua instalação PHP parece estar faltando a extensão MySQL, que é exigida pelo WordPress' de vez em quando.
Quando este erro aparece, ele impede que os usuários visualizem seu site. Se ele ocorrer com frequência, pode ser ruim para a experiência do usuário do seu site.
Ao longo dos anos, experimentamos este erro em várias ocasiões no WPBeginner e em alguns de nossos outros sites de marca.
Com base em nossa experiência, aprendemos que você pode corrigir este erro verificando a versão do PHP e atualizando o WordPress. Você também pode verificar as configurações do PHP e garantir que a extensão MySQL esteja instalada.
Neste artigo, mostraremos como corrigir o erro de extensão MySQL ausente do PHP no WordPress.
O Que é o Erro de Extensão MySQL Ausente do PHP?
Ao trabalhar na construção de um site WordPress ou ao visitar uma página da web, você pode encontrar o erro 'sua instalação PHP parece estar faltando a extensão MySQL, que é exigida pelo WordPress'.
Este erro geralmente significa que algo deu errado com o código do seu site e está impedindo o WordPress de se conectar ao seu banco de dados MySQL.
O erro de extensão MySQL ausente do PHP geralmente aparece quando você atualiza ou instala o WordPress, migra um site, altera configurações do servidor ou muda sistemas operacionais que não possuem uma extensão MySQL (como Linux).
Dito isso, vamos ver as causas deste erro.
O Que Causa o Erro de Extensão MySQL Ausente do PHP?
Existem várias razões pelas quais um erro de extensão MySQL ausente no PHP pode ocorrer.
Uma delas é que você está usando uma versão desatualizada do WordPress com a versão mais recente do PHP. Se você estiver usando PHP 7.0 ou superior, saiba que ele depreciou a extensão MySQL.
Portanto, se você tiver uma versão mais antiga do WordPress que está funcionando com PHP 7.0 ou superior, ela não encontrará a extensão MySQL e causará esse erro.
Outra razão pela qual você pode ver esse erro é que a extensão MySQL está ausente ou não está configurada corretamente. Mesmo que você esteja usando PHP 5.6 ou inferior, o erro de extensão MySQL ausente no PHP ainda pode ocorrer devido a uma extensão MySQL desatualizada.
Agora, vamos ver algumas maneiras de corrigir o erro 'sua instalação PHP parece estar faltando a extensão MySQL, que é necessária pelo WordPress'.
Você pode usar os links abaixo para conferir qualquer uma das dicas que desejar:
- Verifique a versão do PHP que você está usando
- Atualize o WordPress para a versão mais recente
- Certifique-se de ter a extensão MySQL instalada
- Verifique sua configuração PHP
- Bônus: Recursos para corrigir erros do WordPress
Corrigindo o erro de extensão MySQL ausente no PHP 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 a versão do WordPress e a versão do PHP geralmente resulta no erro de extensão MySQL ausente no PHP.
Para começar, você pode ir para a página Ferramentas » Saúde do Site no painel do WordPress. A partir daqui, basta alternar para a guia 'Informações'.
Depois disso, você pode rolar para baixo até a seção ‘Servidor’ e clicar para expandi-la. Aqui, você verá as informações do servidor do seu site.
Vá em frente e veja os detalhes da versão do PHP.
Se a versão do PHP do seu site começar com 7 ou inferior, isso significa que você precisará atualizá-la. Isso pode resolver o erro de extensão MySQL ausente do PHP, pois seria compatível com a versão mais recente do WordPress.
Recomendamos fortemente o uso do PHP 8.0 ou a versão mais recente, pois isso protegerá seu site contra ameaças de segurança. Além disso, otimizará o desempenho do seu site e corrigirá quaisquer vulnerabilidades de segurança e bugs.
Você pode aprender mais seguindo nosso guia sobre como atualizar sua versão do PHP no WordPress.
2. Atualize o WordPress para a Versão Mais Recente
Após verificar a versão do PHP, você também pode ver qual versão do WordPress está usando.
Se for uma versão 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 do PHP.
Uma maneira simples de verificar a versão do WordPress é indo em Painel » Atualizações no painel de administração do WordPress. Aqui, procure as informações de '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 um clique.
Para saber mais, consulte nosso guia sobre como atualizar o WordPress com segurança.
3. Certifique-se de ter a Extensão MySQL Instalada
Agora que você atualizou a versão do PHP e o WordPress em seu site e ainda está enfrentando o erro ‘PHP missing MySQL extension’, você precisa verificar se a extensão MySQL está corretamente instalada em seu site.
Você pode fazer isso acessando a página Ferramentas » Saúde do Site no painel do WordPress. Em seguida, você precisará alternar para a guia ‘Informações’.
Depois disso, vá para a seção ‘Banco de Dados’ e clique para expandi-la.
No campo Extensão, procure por mysqli ou mysql.
Se você vir o campo em branco ou não visível, isso significa que você está com a extensão MySQL faltando.
Agora, o processo de instalação da extensão dependerá do seu provedor de hospedagem WordPress. Você pode simplesmente contatá-los para obter ajuda ou pedir à equipe de suporte para instalá-la para você.
4. Verifique sua configuração de PHP
Outra maneira de corrigir o erro de extensão MySQL faltando no PHP é verificar as configurações de PHP do seu site.
Às vezes, você pode estar enviando o arquivo php.ini errado ou usando o caminho de arquivo incorreto. Isso leva a problemas de configuração de PHP e erros de extensão MySQL faltando.
O arquivo php.ini é um arquivo de configuração padrão para PHP e afeta como seu site funciona. Enviar o arquivo incorreto geralmente acontece se você estiver usando um sistema operacional diferente. Por exemplo, você pode estar enviando o arquivo php.ini destinado ao Windows em um servidor Linux.
Para encontrar o caminho do seu arquivo php.ini no arquivo phpinfo.php, você pode digitar o seguinte endereço web no navegador:
www.example.com/phpinfo.php
Apenas certifique-se de substituir www.example.com pelo nome do seu domínio.
Em seguida, você verá os detalhes da sua instalação de PHP.
A partir daqui, você pode rolar para baixo e procurar pelos campos ‘Caminho do Arquivo de Configuração’ ou ‘Arquivo de Configuração Carregado’.
Uma vez que você localizar o arquivo php.ini, basta conectar-se a um cliente FTP, ir para o caminho do arquivo e excluí-lo para ver se isso corrige o erro de extensão MySQL ausente do PHP.
Antes de excluir, recomendamos criar um backup do arquivo existente baixando-o para o seu computador. Dessa forma, se algo der errado, você poderá restaurar o arquivo php.ini e acessar seu site.
Bônus: Recursos para corrigir erros do WordPress
Agora que você sabe sobre o erro de extensão MySQL ausente do PHP, você também pode conferir nossos guias sobre como resolver outros erros do WordPress:
- Como Corrigir o Erro Crítico no WordPress (Passo a Passo)
- Como Corrigir o Erro 500 Internal Server Error no WordPress
- Como Corrigir o Erro de Servidor DNS Não Respondendo no WordPress
- Como Habilitar Facilmente o Modo de Depuração do WordPress para Corrigir Erros no 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 MySQL ausente no PHP no WordPress. Você também pode querer ver nosso guia sobre como corrigir o erro de pasta temporária ausente no WordPress e o que é o erro 414 Request URI Too Long e como corrigi-lo.
Se você gostou deste artigo, por favor, inscreva-se em nosso Canal do YouTube para tutoriais em vídeo do WordPress. Você também pode nos encontrar no Twitter e no Facebook.
Moinuddin Waheed
Obrigado por este tutorial sobre a extensão MySQL ausente da versão do PHP.
Normalmente, não damos atenção a esses detalhes sobre as versões que estamos usando e instalamos e começamos a usar o WordPress.
Na maioria das vezes, isso é cuidado pela configuração do servidor.
Gostaria de perguntar se precisamos verificar isso mesmo que não tenhamos nenhum problema?
ou existem diretrizes específicas sobre versões do PHP (versão mais recente e versão mais estável)?
WPBeginner Support
Se você não tiver o erro, normalmente não precisará verificar isso, a menos que haja um recurso que você precise e que exija uma versão mais recente do PHP.
Admin
Moinuddin Waheed
Obrigado pela sua resposta.
Eu costumava pensar sobre a versão estável e mais recente do PHP e muitas vezes me perguntava se deveria estar usando a versão mais recente ou a estável.
Obrigado, isso esclarece que, a menos que eu precise da versão mais recente, devo usar a versão estável padrão do PHP.
Kzain
Muito obrigado por isso. Embora as etapas gerais fornecidas no artigo sejam úteis, cada provedor de hospedagem pode ter sua própria maneira de gerenciar extensões PHP. Além disso, manter sua instalação do WordPress e seus plugins atualizados pode ajudar a prevenir que esse erro ocorra em primeiro lugar. Software desatualizado às vezes pode levar a problemas de compatibilidade.
Jiří Vaněk
Eu verifiquei minha versão do PHP agora e tenho a versão 8.0. Existe algum motivo, como velocidade ou a possibilidade de erros semelhantes, para que eu deva atualizar para uma versão mais alta do PHP (8.2 ou 8.3)? Ou a versão 8 (tanto PHP quanto MySQL) é suficiente para evitar este erro (com a versão atual do WordPress)?
WPBeginner Support
Não especificamente no momento, a menos que uma ferramenta que você esteja usando em seu site esteja exigindo uma versão mais alta do PHP
Admin
Jiří Vaněk
Obrigado pela sua resposta. Eu estava considerando se deveria atualizar a versão, mas tinha medo de que alguns componentes do site, como plugins ou trechos de código, não fossem compatíveis. Por enquanto, vou adiar a atualização e agradeço a tranquilidade de que tudo ficará bem como está por enquanto, e a atualização não é estritamente necessária.