解决 PHP 扩展缺失问题：json 和 mbstring 未加载的排查与修复

当 php 脚本报告 `json` 或 `mbstring` 等扩展缺失，即使您已在 cpanel 等控制面板中启用它们时，问题往往在于服务器环境未能识别这些配置变更。本教程将指导您如何使用 `phpinfo()` 验证扩展的实际激活状态，并通过重启 web 服务器或 php-fpm 服务来彻底解决此问题。

在部署 PHP 应用程序时，开发者经常会遇到“PHP 扩展缺失”的错误提示，例如 ERROR: The requested PHP extension json is missing from your system. 和 ERROR: The requested PHP extension mbstring is missing from your system.。尽管许多用户在 cPanel 或其他主机管理界面中确认已启用这些扩展，但错误依然存在。这通常表明 PHP 运行环境尚未正确加载或识别这些配置更改。

核心诊断：利用 phpinfo() 验证扩展状态

解决此类问题的首要步骤是确认当前运行的 PHP 解释器是否真的加载了所需的扩展。phpinfo() 是一个强大的 PHP 内置函数，它能输出 PHP 环境的详细配置信息，包括所有已加载的扩展模块。

如何生成 phpinfo() 文件

1. 创建文件： 在您的网站根目录（或任何可通过浏览器访问的目录）下，创建一个名为 info.php 的新文件。
2. 添加代码： 将以下 PHP 代码复制并粘贴到 info.php 文件中：

   <?php
   phpinfo();
   ?>

   登录后复制
3. 保存并访问： 保存文件后，通过您的网络浏览器访问 http://您的域名/info.php。

如何解读 phpinfo() 输出

在打开的 phpinfo() 页面中，您需要查找 json 和 mbstring 扩展的信息：

1. 搜索功能： 使用浏览器的搜索功能（通常是 Ctrl+F 或 Cmd+F）来搜索 "json" 和 "mbstring"。
2. 验证状态：
   • 如果这些扩展已成功加载，您将看到各自的配置段落，其中包含版本信息和相关设置。例如，json 扩展通常会显示其版本，而 mbstring 会显示其各种字符集处理设置。
   • 如果搜索不到这些扩展的任何信息，或者它们显示为禁用状态（尽管这种情况较少见），则明确表明当前运行的 PHP 解释器未能加载它们。

根本解决：重启相关服务

即使您在 cPanel 或其他管理界面中启用了 PHP 扩展，这些更改也可能不会立即生效。PHP 解释器（或其后端服务，如 PHP-FPM）通常需要重启才能应用新的配置。

立即学习“PHP免费学习笔记（深入）”；

重启步骤

根据您的服务器环境和权限，重启方法有所不同：

绘蛙AI修图

绘蛙平台AI修图工具，支持手脚修复、商品重绘、AI扩图、AI换色

129

查看详情

1. Cpanel 用户：

   • 登录您的 cPanel 账户。
   • 导航至 "软件" 或 "PHP 版本" 部分。
   • 通常，您会找到一个选项来选择或切换 PHP 版本。有时，仅仅重新选择当前正在使用的 PHP 版本并保存，或者点击“设置”/“应用”按钮，就会触发 PHP 服务的重启。
   • 如果 cPanel 没有提供直接的 PHP 服务重启按钮，您可能需要联系您的主机提供商寻求帮助，或者在某些情况下，重启整个 Web 服务器（如果您的权限允许）。

2. VPS/独立服务器用户（通过 SSH 访问）：

   • 通过 SSH 连接到您的服务器。
   • 重启 Web 服务器：
     • 对于 Apache：sudo systemctl restart apache2 或 sudo service apache2 restart
     • 对于 Nginx：sudo systemctl restart nginx 或 sudo service nginx restart
   • 重启 PHP-FPM 服务（如果您的 PHP 配置使用 FPM）：
     • PHP-FPM 服务的名称可能因 PHP 版本而异。您可以使用 ps aux | grep php-fpm 命令来查找当前运行的 PHP-FPM 版本，例如 php7.4-fpm、php8.1-fpm。
     • 重启命令示例：sudo systemctl restart php7.4-fpm 或 sudo service php7.4-fpm restart

重启后验证

1. 服务重启完成后，再次访问您之前创建的 http://您的域名/info.php。
2. 确认 "json" 和 "mbstring" 扩展现在已在 phpinfo() 输出中正确显示。
3. 安全提示： 为了避免泄露服务器配置信息，在确认问题解决后，务必删除您创建的 info.php 文件。

注意事项与常见问题

• 多 PHP 版本环境： 确保您启用的扩展是针对您的网站实际使用的 PHP 版本。在 cPanel 等环境中，您可以为不同的域名或子域名配置不同的 PHP 版本。
• PHP Handler 类型： 检查您的 PHP Handler（如 mod_php、FPM、CGI）。不同的 Handler 可能有不同的配置加载方式和重启机制。例如，使用 mod_php 的 Apache 通常在重启 Apache 后生效，而使用 PHP-FPM 则需要重启 PHP-FPM 服务。
• 共享主机限制： 在某些共享主机环境中，您可能没有直接重启服务的权限。在这种情况下，联系您的主机提供商是解决问题的最佳途径。
• 错误日志： 如果在执行上述步骤后问题依然存在，请检查 Web 服务器（Apache/Nginx）和 PHP 的错误日志文件。这些日志通常位于 /var/log/ 目录下，它们可能会提供更详细的线索来诊断问题。

总结

当 PHP 应用程序报告 json 或 mbstring 等扩展缺失时，即使您已在控制面板中启用它们，这通常是由于服务器环境未能正确加载或应用配置更改所致。解决此问题的关键在于：

1. 使用 phpinfo() 进行诊断： 通过生成 phpinfo() 文件来验证扩展的实际加载状态。
2. 重启相关服务： 根据您的服务器环境，重启 Web 服务器（Apache 或 Nginx）和/或 PHP-FPM 服务，以确保新的配置生效。
3. 注意环境细节： 仔细检查 PHP 版本匹配、PHP Handler 类型，并在共享主机环境下联系服务商寻求帮助。

遵循这些步骤，您将能够有效地排查并解决 PHP 扩展缺失的问题，确保您的应用程序正常运行。

以上就是解决 PHP 扩展缺失问题：json 和 mbstring 未加载的排查与修复的详细内容，更多请关注php中文网其它相关文章！