如何修复 MultiPHP 更新后的错误
- 概述
- 可用的 PHP 版本
- 如何更新 PHP
- 修复 MultiPHP 错误
- php.ini
- 限制
- 查看设置
本文将介绍当您的 WordPress 网站遇到如下类似问题时的解决方案:
错误信息开头为:
"警告 : 使用未定义的常量 WP_CONTENT_DIR - 假定为 'WP_CONTENT_DIR'(在未来的 PHP 版本中这将抛出错误)于" 紧接着是 cPanel 目录中的位置,然后是: "您的 PHP 安装似乎缺少 WordPress 所需的 MySQL 扩展。" 此修复需要您使用文件管理器修改文件。如果您不熟悉操作,我们的支持团队可通过电话或聊天为您提供帮助。 以下是本文涉及的主题:
- 如何修复“缺少 MySQL 扩展”错误 ⤵
- 仍然遇到“缺少 MySQL 扩展”错误? ⤵
- 常见问题解答(FAQs) ⤵
- 相关文章 ⤵
如何修复“缺少 MySQL 扩展”错误
注意: 如果您之前使用 PHP Selector 管理网站的 PHP 版本,后来又使用新的 MultiPHP Manager 更新 PHP 版本,此解决方法适用。请注意,我们共享主机服务器的最低 PHP 版本为 8.1。 下面的视频将引导您识别“缺少 MySQL 扩展”错误及其解决步骤。
视频指南中的步骤如下:
- 登录 cPanel。
- 进入 文件 部分,然后点击 文件管理器 图标。

- 找到并打开您网站的文档根目录。(在本示例中,我们使用 public_html 文件夹。)

- 找到 .htaccess 文件,右键点击并选择 查看。
[点击此处了解如何定位您的 .htaccess 文件]
我们制作了视频教程,帮助您查找和编辑 .htaccess 文件。视频链接如下。
定位 .htaccess 文件步骤: - 登录 cPanel。
- 在 文件 部分点击 文件管理器。

- 点击右上角的 设置。

- 确保选中 显示隐藏文件(点文件)。

- 点击 保存。页面将刷新,所有以 "."(点) 开头的文件将显示。
- 现在选择您的域名文档根目录。在本示例中,我们使用 public_html 文件夹。
- 在 public_html 中查找 .htaccess 文件。

- 在您的 .htaccess 文件中,您应该能看到 PHP 处理程序条目。首先,您需要识别并删除 旧的 PHP 处理程序。
您需要删除的 旧 PHP 处理程序 可能类似于以下之一:
# Use PHP81 as default
AddHandler application/x-httpd-php81 .php
<IfModule mod_suphp.c>
suPHP_ConfigPath /opt/php71/lib
</IfModule>
或
# Use PHPedge as default
AddHandler application/x-httpd-php-edge .php
<IfModule mod_suphp.c>
suPHP_ConfigPath /opt/phpedge/lib
</IfModule>
如果您在 .htaccess 文件中未看到上述两种旧 PHP 处理程序条目,尝试点击顶部菜单的 上一级 链接,检查 public_html 以外的其他 .htaccess 文件。
您需要保留的 PHP 处理程序类似如下。您会注意到它标注为“cPanel-generated handler, do not edit”,由 MultiPHP Manager 创建。
# php -- BEGIN cPanel-generated handler, do not edit
# Set the “ea-php81” package as the default “PHP” programming language.
<IfModule mime_module>
AddHandler application/x-httpd-ea-php81 .php .php81 .phtml
</IfModule>
# php -- END cPanel-generated handler, do not edit
这些 PHP 处理程序相互冲突,导致您的网站出现错误。您需要删除旧的 PHP 处理程序,使 MultiPHP 处理程序代码生效。
6. 识别出这些 PHP 处理程序后,请先备份您的 .htaccess 文件,再进行修改。
[点击此处了解如何备份 .htaccess 文件]
备份 .htaccess 文件步骤:
- 在目录中找到 .htaccess 文件。

- 右键点击,选择 复制。
- 弹出窗口会显示备份存储路径的起始部分。输入文件名为 /public_html/.htaccess.bak,然后点击 复制文件。
- 您将在 public_html 中看到备份文件 .htaccess.bak。
- 右键点击 .htaccess 文件,选择 编辑。

或者,点击 .htaccess 文件后,点击页面顶部的 编辑 图标。 - 会弹出对话框,点击 编辑 继续。编辑器将在新窗口打开。

- 进行必要的修改。要禁用不需要的 PHP 处理程序,请在每行开头添加“#”,如下示例所示。
# Use PHPedge as default
#AddHandler application/x-httpd-php-edge .php
#<IfModule mod_suphp.c>
# suPHP_ConfigPath /opt/phpedge/lib
#</IfModule>
注意:您的 .htaccess 文件中可能有多个旧 PHP 处理程序条目。请继续为所有额外条目添加“#”。您最终应只保留一个以以下内容开始和结束的条目:
# php -- BEGIN cPanel-generated handler, do not edit
# php -- END cPanel-generated handler, do not edit
- 完成后,点击右上角的 保存更改。

- 点击 关闭 退出编辑器。
- 访问您的网站,检查错误是否已消失。
仍然遇到“缺少 MySQL 扩展”错误?
可能存在多个 .htaccess 文件需要编辑。如果您在编辑 public_html 文件夹中的 .htaccess 后仍遇此错误,请检查根目录。
请继续执行以下步骤:
- 通过点击左侧面板顶部以 (/home#/user) 开头的文件夹进入根目录,其中 user 是您的 cPanel 用户名。

- 在右侧面板向下滚动,找到另一个 .htaccess 文件。带有数字或字符字符串的 .htaccess 文件已被禁用并忽略。
- 打开该 .htaccess 文件,检查是否存在旧 PHP 处理程序。按上述步骤继续操作。
- 完成后,重新加载您的网站。
如果错误仍然存在,请进入 cPanel 的 MultiPHP Manager,选择您的网站名称,然后从下拉菜单中将 PHP 版本设置为 继承。

常见问题解答(FAQs)
查看和更新网站 PHP 版本的最简单方法是什么?
cPanel 提供 MultiPHP Manager,允许您查看和更新网站的 PHP 版本。请参阅本文了解更多信息:您正在使用哪个版本的 PHP?
我们也有关于 MultiPHP Manager 使用的视频指南。
我的文件管理器在哪里?
所有网站文件都存储在您的文件管理器中。要了解如何访问文件管理器,请访问本文:如何浏览文件管理器。
如何在文件管理器中编辑文件?
您可以在文件管理器中创建、修改或删除网站文件。请参阅文章《如何使用文件管理器创建/编辑/删除文件》,了解详细操作说明。
我完成了上述步骤,但网站现在显示不同的错误页面(403、404 或 405 错误)。如何解决?
网站显示错误页面的原因多种多样。故障排除取决于您看到的错误代码(403、404、500 等)。请访问以下相关文章,了解错误代码及解决方法:
- 403 禁止访问或无权限访问
- 404 错误页面
- 500 内部服务器错误帮助
- 错误页面代码
相关文章
- 默认文件 .htaccess 和 php.ini
- 如何更新 PHP 版本(本文中也包含“如何修复‘缺少 MySQL 扩展’错误”)
- 什么是 php.ini?
需要进一步帮助? HostGator 支持团队随时为您服务。请通过电话或聊天联系我们!