• Pagina inicial
  • Artigos
  • Tema
  • Como corrigir o erro: “Sua instalação do PHP parece estar faltando a extensão MySQL que é exigida pelo WordPress”

Como corrigir o erro: “Sua instalação do PHP parece estar faltando a extensão MySQL que é exigida pelo WordPress”

Publicados: 2022-11-01

A mensagem de erro “Sua instalação do PHP parece estar faltando a extensão MySQL exigida pelo WordPress” pode ser confusa para iniciantes no WordPress e usuários experientes. Embora possa parecer que tudo o que você precisa fazer é instalar a extensão MySQL do WordPress ausente, a instalação e configuração do PHP no lado do servidor é muito mais complicada. Além disso, existem alguns drivers de banco de dados diferentes disponíveis para PHP, cada um servindo ao mesmo propósito.

Neste guia abrangente para corrigir o erro “Sua instalação do PHP parece estar faltando a extensão MySQL que é exigida pelo WordPress”, você aprenderá como o WordPress se comunica com seu banco de dados e como garantir que sua instalação do PHP tenha a extensão MySQL correta instalada para ele .


Como o WordPress se comunica com seu banco de dados?

Seu site WordPress é um aplicativo web dinâmico e orientado a banco de dados. Isso significa essencialmente duas coisas: a grande maioria de todo o conteúdo do site é armazenada no banco de dados do WordPress, e o WordPress depende absolutamente da capacidade de se comunicar com seu banco de dados para funcionar corretamente. Cada vez que você carrega qualquer página em seu site, o WordPress realiza uma série de manipulações nos bastidores.

Como todas as postagens, páginas e outras informações importantes são armazenadas no banco de dados, em oposição aos arquivos no servidor, que veríamos em um site estático. O WordPress PHP precisa recuperar o conteúdo solicitado enviando consultas SQL e mesclá-lo com arquivos de modelo para criar uma página HTML que será enviada ao visitante do site. Em outras palavras, o WordPress analisa o endereço que você abre no navegador para formar um conjunto de parâmetros de consulta, que serão usados ​​para consultar o banco de dados.

Então, qual é o papel do PHP neste processo? Uma instalação do WordPress, ou o núcleo do WordPress, é um conjunto de scripts PHP que, juntos, constroem um site dinâmico. O PHP como linguagem de programação se torna a peça central da arquitetura do WordPress, o que significa que sua instalação do PHP deve ser configurada corretamente para se comunicar com o banco de dados do WordPress. Um dos principais aspectos disso é ter as extensões PHP necessárias instaladas e habilitadas.

Extensões PHP MySQL para WordPress

O PHP usa uma extensão especial, ou um driver de banco de dados, para garantir que o WordPress possa estabelecer uma conexão com seu banco de dados usando as credenciais fornecidas no arquivo wp-config.php. Mas o que é exatamente essa extensão? Você provavelmente já deve ter visto diferentes versões dele: mysql, mysqli, mysqlnd, pdo_mysql, libmysql e ainda mais. É fácil ficar confuso, então vamos resolver isso de uma vez por todas.

A partir da versão 5.3, o PHP usa o MySQL Native Driver para se comunicar com o servidor de banco de dados. O MySQL Native Driver também pode ser chamado de mysqlnd e é um substituto para a MySQL Client Library (libmysql) distribuída pelo MySQL. As três extensões MySQL – mysql, mysqli e pdo_mysql – são compiladas para usar o MySQL Native Driver e são amplamente utilizadas com sites construídos em PHP.

O PHP preteriu a extensão mysql na versão 5.5 e removeu o suporte para ela no PHP 7+ em favor do mysqli. Alinhando seu caminho com essa decisão, o WordPress usa a extensão mysqli da versão 3.9. Como pdo_mysql não é suportado pelo WordPress, o driver de banco de dados mencionado na mensagem de erro “Sua instalação do PHP parece estar faltando a extensão MySQL que é exigida pelo WordPress” é a extensão PHP mysqli.

Sua instalação PHP parece estar faltando a extensão MySQL

O que significa o erro “Sua instalação do PHP parece estar faltando a extensão MySQL que é exigida pelo WordPress”?

O erro “Sua instalação do PHP parece estar faltando a extensão MySQL exigida pelo WordPress” significa que a versão do PHP usada pelo seu site WordPress não possui a extensão mysqli instalada ou configurada corretamente. Isso faz com que o WordPress não consiga se comunicar com seu banco de dados, o que, por sua vez, resulta na visualização dessa variação da mensagem de erro de conexão do banco de dados do WordPress em seu site.

Erros de conexão do banco de dados WordPress

O WordPress pode mostrar erros de conexão de banco de dados por vários motivos. A mensagem de erro que o WordPress escolhe para exibir depende do estágio em que encontrou problemas durante uma tentativa de conexão. É importante entender a diferença entre os dois principais erros relacionados à sua incapacidade de se comunicar com o banco de dados do WordPress.

A mensagem “Erro ao estabelecer uma conexão com o banco de dados” aparecerá em seu site se as informações do banco de dados no arquivo wp-config.php estiverem incorretas, se o usuário do banco de dados não tiver privilégios suficientes, se o banco de dados estiver corrompido ou se o servidor MySQL/MariaDB for rejeitado a conexão. Nesse caso, o WordPress pode usar a extensão mysqli, mas se depara com alguns problemas em um estágio posterior.

Se você vir a mensagem de erro “Sua instalação do PHP parece estar faltando a extensão MySQL exigida pelo WordPress” em seu site, a extensão PHP mysqli não está instalada ou não foi carregada pela sua instalação PHP. Um driver de banco de dados garante que o WordPress possa usar sua classe global wpdb(), que é o primeiro passo para estabelecer uma conexão de banco de dados.

3 principais razões por trás do erro ausente da extensão MySQL do WordPress

Ao instalar o WordPress pela primeira vez ou mover seu site WordPress para uma nova infraestrutura de hospedagem, você precisa ter certeza de que todos os serviços estão configurados corretamente. Ele inclui seu servidor web que aceitará solicitações HTTP, seu manipulador PHP que controlará a execução do código PHP e seu MySQL/MariaDB que aceitará e processará solicitações de banco de dados.

Painéis de controle de hospedagem na web modernos permitem que você tenha várias versões do PHP instaladas no servidor ao mesmo tempo. Não é o caso da abordagem tradicional de instalação do PHP, quando para usar uma nova versão do PHP, você precisa remover totalmente a anterior. Você também pode instalar todas as extensões PHP necessárias a partir da interface gráfica do usuário sem precisar fazer isso na linha de comando.

Você pode escolher a versão do PHP que deseja usar para o seu site WordPress e até mesmo um manipulador de PHP, se se inscreveu em VPS ou hospedagem dedicada. Essa liberdade simplifica o processo de execução de um site e o torna muito mais complicado para alguém que não está familiarizado com a maneira como o PHP funciona no lado do servidor.

Abaixo, revisaremos as situações comuns que farão com que o PHP não consiga se comunicar com seu servidor MySQL/MariaDB. Aqui estão as três principais razões por trás da mensagem de erro “Sua instalação do PHP parece estar faltando a extensão MySQL que é exigida pelo WordPress” em seu site:

  • A extensão PHP mysqli está faltando na versão PHP usada pelo seu site.
  • A extensão PHP mysqli não está configurada corretamente.
  • Você está usando uma versão desatualizada do WordPress com PHP 7+.

Razão 1: A extensão PHP mysqli está ausente da versão PHP usada pelo seu site

É possível que a extensão mysqli não esteja instalada, especialmente se você acabou de disponibilizar uma nova versão do PHP. Se o WordPress não puder usar a extensão mysqli, ele tentará usar a extensão mysql antiga em versões do PHP inferiores a 7.0. O principal é ter o MySQL Native Driver instalado e configurado para a versão PHP escolhida.

Como endereçar

Instale o MySQL Native Driver a partir do painel de controle de sua hospedagem na web ou usando a interface de linha de comando para ativar a extensão mysqli do WordPress. Para PHP 8.1, o pacote será chamado php81-php-mysqlnd ou ea-php81-php-mysqlnd.x86_64 se você estiver usando cPanel.

Em um servidor CentOS sem painel de controle, execute yum install php81-php-mysqlnd na interface da linha de comando. Para servidores Ubuntu, você apt-get para instalar o mysqlnd. O sistema habilitará automaticamente o suporte para mysqli e pdo_mysql.

Razão 2: A extensão PHP mysqli não está configurada corretamente

Depois que o driver nativo PHP MySQL for instalado, mysqli e pdo_mysql devem estar habilitados e disponíveis para uso do WordPress. Para ter a extensão carregada com a versão do PHP que você está usando, um arquivo PHP especial é criado no diretório de configuração global do PHP. Se por algum motivo a extensão mysqli não puder ser carregada para a versão PHP escolhida, o WordPress exibirá a mensagem de erro “Sua instalação do PHP parece estar faltando a extensão MySQL que é exigida pelo WordPress”.

Como endereçar

Verifique se o MySQL Native Driver, ou mysqlnd, está instalado corretamente e se o PHP adicionou arquivos .ini para mysqlnd e mysqli. Em servidores cPanel, você pode encontrar os arquivos de configuração 30-mysqli.ini e 20-mysqlnd.ini no diretório /opt/cpanel/ea-php81/root/etc/php.d, onde PHP 8.1 é a versão do PHP usada por seu site WordPress. Os arquivos devem conter as linhas abaixo para que as extensões sejam carregadas corretamente.

Razão 3: Você está usando uma versão desatualizada do WordPress com PHP 7+

É improvável, mas você ainda pode estar usando uma versão muito desatualizada do WordPress com versões mais recentes do PHP. O uso de versões de software desatualizadas não apenas aumenta a probabilidade de encontrar vários problemas do WordPress, mas também abre possibilidades quase ilimitadas para hackers obterem acesso ao seu site e realizarem ações maliciosas.

Como endereçar

Adquira o hábito de manter todos os softwares que você está usando atualizados para a versão mais recente. Atualize o WordPress, o tema ativo e todos os plugins. Sempre use a versão mais recente do PHP para evitar problemas decorrentes de incompatibilidade de código e vulnerabilidades de segurança não corrigidas.

Como você não tem acesso ao painel de administração do WordPress, use a Interface de linha de comando do WordPress para realizar todas as atualizações. Você pode usar os seguintes comandos:

  • atualização do núcleo wp. Atualize o núcleo do WordPress.
  • atualização do plugin wp <nome do plugin>. Atualize um determinado plug-in ou use o sinalizador — all para atualizar todos os plug-ins de uma só vez.
  • atualização do tema wp <nome do tema ativo>. Atualize seu tema ativo.

Se o WordPress mostrar a mensagem de erro da extensão MySQL ausente, é um sinal para levar seu site WordPress mais a sério. Adote uma abordagem proativa para gerenciar todos os aspectos, especialmente quando se trata de segurança. iThemes Security Pro e BackupBuddy, as soluções líderes do setor para segurança e proteção de dados do WordPress, podem tornar o processo fácil e sem dor de cabeça.

Usar o iThemes Security Pro é como ter um especialista em segurança em sua equipe que monitorará seu site WordPress 24 horas por dia, 7 dias por semana, permitindo que você se concentre no crescimento de seus negócios. Protegendo mais de um milhão de sites WordPress em todo o mundo, o BackupBuddy faz o backup automático do seu site em intervalos regulares para armazenar uma cópia dele em um local seguro para restaurações com um clique sempre que você precisar. Dessa forma, você pode se recuperar facilmente de todos os erros do WordPress e infecções por malware, mas lembre-se – a prevenção de ataques é sempre melhor do que lidar com as consequências.

O recurso Site Scan verifica as áreas críticas do seu site e aplica correções automaticamente para manter seu site livre de plugins e temas desatualizados que o colocam em grande risco. Com o iThemes Security Site Scan, você pode reduzir significativamente a superfície de ataque e manter seu site protegido contra ataques de rede de todos os tipos.

O iThemes Security Version Management permite configurar atualizações automáticas para o núcleo, plugins e temas do WordPress para aproveitar novos recursos e ficar protegido contra vulnerabilidades conhecidas.
Manter o WordPress atualizado é extremamente importante e pode economizar muito tempo lidando com vários problemas do WordPress causados ​​por software desatualizado.

Outras razões

Assim como qualquer outro problema do WordPress, o erro “Sua instalação do PHP parece estar faltando a extensão MySQL exigida pelo WordPress” pode ser exibida em seu site por uma ampla variedade de motivos que vão além do que descrevemos acima. No entanto, na maioria das vezes eles estão relacionados a configurações incorretas de manipuladores de PHP ou ao uso do sistema operacional CloudLinux, que possui sua própria maneira de configurar o PHP no lado do servidor.

Seletor de PHP do CloudLinux

Usando o Cloudlinux, você pode aproveitar o CageFS, uma solução robusta para isolamento total do usuário, que evita ataques de links simbólicos entre contas e protege seus sites. Se você estiver usando o CageFS, precisará usar o CloudLinux PHP Selector, que geralmente apresenta complicações adicionais para usuários do cPanel que normalmente gerenciam o PHP do lado do servidor a partir do MultiPHP Manager. Consulte o guia do CloudLinux para usar o PHP Selector com cPanel ou entre em contato com seu provedor de hospedagem para obter assistência.

Como corrigir o erro “Sua instalação do PHP parece estar faltando a extensão MySQL que é exigida pelo WordPress”

Para corrigir o erro “Sua instalação do PHP parece estar faltando a extensão MySQL exigida pelo WordPress”, você precisará certificar-se de que sua instalação do PHP tenha o MySQL Database Driver (mysqlnd) e a extensão mysqli instalada e configurada corretamente. Só então você poderá restaurar a conexão normal entre o WordPress e o banco de dados do WordPress e fazer seu site funcionar novamente.

Siga as etapas abaixo para corrigir o erro de extensão ausente do WordPress MySQL:

  • Crie uma página de informações do PHP para revisar sua configuração do PHP.
  • Verifique se a extensão mysqli está instalada e configurada corretamente.
  • Restaure a capacidade do WordPress de se conectar ao seu banco de dados e evite erros futuros.

Etapa 1. Crie uma página de informações do PHP para revisar sua configuração do PHP

A maneira mais fácil de verificar a configuração de instalação do PHP é criando uma página de informações do PHP. Crie um arquivo chamado phpinfo.php no diretório raiz de documentos do seu site WordPress e insira o seguinte código nele: 

<?php
phpinfo( );
?>

Como alternativa, execute o seguinte se você estiver conectado ao seu site via SSH. Ele criará um arquivo phpinfo.php e ajustará suas permissões. 

echo "<?php phpinfo(); ?>" > phpinfo.php ; chown $(stat -c %U .). phpinfo.php

Abra a página phpinfo.php recém-criada no navegador digitando yourwebsite.com/phpinfo.php na barra de endereço. Substitua yourwebsite.com pelo nome de domínio real do seu site WordPress. Mesmo que nenhum conteúdo seja carregado devido ao erro de extensão MySQL ausente, você não terá problemas para abrir a página de informações do PHP.

Você deverá ver uma página semelhante à abaixo, que conterá todas as configurações da versão do PHP que você está usando para o seu site WordPress. Neste caso, é PHP 8.1. Ter uma página de informações do PHP é útil para solucionar vários erros do WordPress, incluindo a mensagem “Houve um erro crítico no seu site” no WordPress.

Na parte superior da página, você verá a versão do PHP usada pelo seu site WordPress. Aqui estão alguns dos aspectos mais importantes da sua instalação do PHP que você deve verificar primeiro:

  • Manipulador PHP. O manipulador PHP usado pelo seu site será exibido como a API do servidor. Na captura de tela acima, é FPM/FastCGI.
  • Arquivo de configuração carregado. O arquivo de configuração principal carregado para a versão PHP em uso.
  • Arquivos .ini adicionais analisados. Esta lista conterá todos os outros arquivos de configuração PHP carregados, incluindo aqueles que carregam o MySQL Native Driver (20-mysqlnd.ini) e a extensão mysqli (30-mysqli.ini).

Certifique-se de que a lista de arquivos .ini adicionais analisados ​​contenha os arquivos 20-mysqlnd.ini e 30-mysqli.ini necessários que garantem que a extensão MySQL do PHP WordPress MySQL necessária seja carregada corretamente e possa ser usada pelo seu site.

Etapa 2. Verifique se a extensão mysqli está instalada e configurada corretamente

Role para baixo na página de informações do PHP ou use a opção de pesquisa no navegador para revisar as seções mysqli e mysqlnd. Eles devem ir um após o outro.

Observe que a extensão mysqli é compilada para usar o MySQL Native Driver como a versão Client API Library nos mostra mysqlnd. As informações da extensão PHP nos mostram alguns detalhes adicionais, incluindo a porta MySQL/MariaDB.

Verifique quais extensões de API a seção mysqlnd do arquivo de informações do PHP lista. Na captura de tela acima, temos o mysqli e o pdo_mysql habilitados.

Etapa 3. Restaure a capacidade do WordPress de se conectar ao seu banco de dados

A página de informações do PHP mostrará se a versão do PHP que você usa para o seu site WordPress tem a extensão mysqli instalada e configurada. Se estiver faltando, instale-o a partir da interface de gerenciamento PHP fornecida pelo painel de controle de hospedagem na web ou usando a interface de linha de comando.

Verifique o 20-mysqlnd.ini e 30-mysqli.ini referenciados para ver se eles carregam a extensão corretamente. Se você estiver usando uma versão desatualizada do WordPress, atualize a instalação e todos os plugins e temas.

As etapas descritas neste guia devem ajudá-lo a restaurar a funcionalidade do seu site WordPress na grande maioria dos casos. No entanto, como mencionamos, pode haver outros problemas, incluindo configurações incorretas do manipulador PHP, que podem levar à exibição da mensagem de erro “Sua instalação do PHP parece estar faltando a extensão MySQL que é exigida pelo WordPress” em seu site. É melhor entrar em contato com sua equipe de suporte de hospedagem na web para obter mais assistência se não estiver claro o que está causando o problema.

Empacotando

O erro de extensão ausente do WordPress MySQL é um dos problemas do WordPress relacionados à sua capacidade de se comunicar com seu banco de dados. Ele indica que a extensão PHP mysqli necessária está ausente ou configurada incorretamente, o que faz com que o PHP não consiga enviar consultas SQL para seu banco de dados WordPress. A partir do PHP 7.0, a extensão mysql mais antiga foi removida em favor do mysqli, a nova extensão MySQL do WordPress compilada para usar o MySQL Native Driver.

Assim como qualquer outro erro crítico do WordPress, ver o erro “Sua instalação do PHP parece estar faltando a extensão MySQL exigida pelo WordPress” significa que você precisa revisar sua configuração do WordPress e garantir que as melhores práticas de segurança estejam em vigor.

Adotar uma abordagem proativa à administração e segurança do site WordPress ajudará você a evitar a maioria dos erros e reduzir significativamente a superfície de ataque. Configure monitoramento, atualizações automáticas de software e backups regulares para ter seu site protegido contra vulnerabilidades de segurança e ataques de rede Deixe o iThemes Security Pro e o BackupBuddy serem sua equipe de especialistas em segurança e recuperação de dados que garantirão que seu site nunca fique offline.

O melhor plug-in de segurança do WordPress para proteger e proteger o WordPress

Atualmente, o WordPress alimenta mais de 40% de todos os sites, por isso se tornou um alvo fácil para hackers com intenções maliciosas. O plug-in iThemes Security Pro elimina as suposições da segurança do WordPress para facilitar a segurança e a proteção do seu site WordPress. É como ter um especialista em segurança em tempo integral na equipe que monitora e protege constantemente seu site WordPress para você.

Obtenha o iThemes Security Pro