WordPress MySQL Extension Missing 错误背后的 3 个主要原因

今天北京六翼信息技术有限公司的工程师主要和大家分享的是WordPress定制开发过程中常遇见的问题之一——“WordPress MySQL Extension Missing 错误背后的 3 个主要原因”。当您第一次安装WordPress或将您的WordPress 网站移动到新的托管基础设施时，您需要确保所有服务都已正确配置。它包括将接受HTTP 请求的 Web 服务器、将控制 PHP 代码执行的 PHP 处理程序以及将接受和处理数据库请求的 MySQL/MariaDB。

现代网络托管控制面板允许您同时在服务器上安装多个PHP 版本。传统的 PHP 安装方法并非如此，为了使用新版本的 PHP，您需要完全删除以前的版本。您还可以从图形用户界面安装所有必需的 PHP 扩展，而无需从命令行执行。

如果您注册了VPS 或专用主机，您可以选择要用于 WordPress 网站的 PHP 版本，甚至是 PHP 处理程序。这种自由既简化了运行网站的过程，也使不熟悉 PHP 在服务器端工作方式的人变得更加复杂。

下面，我们将回顾导致PHP 无法与您的 MySQL/MariaDB 服务器通信的常见情况。以下是您网站上出现“您的 PHP 安装似乎缺少 WordPress 所需的 MySQL 扩展”错误消息背后的三个主要原因：

l 您网站使用的PHP 版本中缺少 PHP mysqli 扩展。

l PHP mysqli 扩展未正确配置。

l 您正在使用带有PHP 7+ 的过时版本的 WordPress。

原因一：您网站使用的PHP版本缺少PHP mysqli扩展

有可能根本没有安装mysqli 扩展，特别是如果您刚刚提供了一个新的 PHP 版本。如果 WordPress 不能使用 mysqli 扩展，它将尝试在低于 7.0 的 PHP 版本上使用旧的 mysql。关键是为所选的 PHP 版本安装和配置 MySQL 本机驱动程序。

如何解决

从您的虚拟主机控制面板或使用命令行界面安装MySQL 本机驱动程序以启用 WordPress mysqli 扩展。对于 PHP 8.1，如果您使用的是 cPanel，则该包将被称为 php81-php-mysqlnd 或 ea-php81-php-mysqlnd.x86_64。

在没有控制面板的CentOS 服务器上，从命令行界面运行yum install php81-php-mysqlnd。对于Ubuntu 服务器，您可以安装 mysqlnd。系统将自动启用对 mysqli 和 pdo_mysql 的支持。

原因二：PHP mysqli 扩展配置不正确

一旦安装了所需的PHP MySQL 本机驱动程序，mysqli 和 pdo_mysql 都应启用并可供 WordPress 使用。要使用您正在使用的 PHP 版本加载扩展，需要在 PHP 全局配置目录中创建一个特殊的 PHP 文件。如果由于某种原因无法为所选 PHP 版本加载 mysqli 扩展，WordPress 将显示“您的 PHP 安装似乎缺少 WordPress 所需的 MySQL 扩展”错误消息。

如何解决

确认MySQL 本机驱动程序或 mysqlnd 已正确安装，并且 PHP 已为 mysqlnd 和 mysqli 添加了 .ini 文件。在cPanel服务器上，可以在/opt/cpanel/ea-php81/root/etc/php.d目录下找到30-mysqli.ini和20-mysqlnd.ini配置文件，其中PHP 8.1是使用的PHP版本您的 WordPress 网站。这些文件必须包含以下行才能正确加载扩展。

原因 3：您使用的是过时版本的 WordPress 和 PHP 7+

这不太可能，但您可能仍在使用非常过时的WordPress 版本和较新的 PHP 版本。使用过时的软件版本不仅更容易遇到各种 WordPress 问题，而且还为黑客提供了几乎无限的可能性来访问您的网站并执行恶意操作。

如何解决

养成将您使用的所有软件更新到最新版本的习惯。更新WordPress、活动主题和所有插件。始终使用最新的PHP 版本，以避免因代码不兼容和未修补的安全漏洞而导致的任何问题。

由于您无权访问WordPress 管理仪表板，请使用 WordPress 命令行界面执行所有更新。您可以使用以下命令：

l wp 核心更新。 更新WordPress 核心。

l wp 插件更新 <插件名称>。 更新某个插件或使用–all标志一次更新所有插件。

l wp theme update . 更新您的活动主题。

如果WordPress 向您显示缺少 MySQL 扩展的错误消息，则表明您需要更认真地对待您的 WordPress 网站。采取积极主动的方法来管理它的所有方面，尤其是在安全方面。使 WordPress 保持最新状态非常重要，可以为您节省大量时间来处理由过时软件引起的各种 WordPress 问题。

其他原因

就像任何其他WordPress 问题一样，错误“您的 PHP 安装似乎缺少 WordPress 所需的 MySQL 扩展”可能会出于我们上面概述的各种原因而显示在您的网站上。然而，大多数情况下，它们与 PHP 处理程序配置错误或使用 CloudLinux 操作系统有关，后者在服务器端有自己的配置 PHP 的方式。