当 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() 文件
- 创建文件： 在您的网站根目录（或任何可通过浏览器访问的目录）下，创建一个名为 info.php 的新文件。
- 添加代码： 将以下 PHP 代码复制并粘贴到 info.php 文件中：
<?php phpinfo(); ?>
- 保存并访问： 保存文件后，通过您的网络浏览器访问 http://您的域名/info.php。
如何解读 phpinfo() 输出
在打开的 phpinfo() 页面中，您需要查找 json 和 mbstring 扩展的信息：
- 搜索功能： 使用浏览器的搜索功能（通常是 Ctrl+F 或 Cmd+F）来搜索 “json” 和 “mbstring”。
- 验证状态：
- 如果这些扩展已成功加载，您将看到各自的配置段落，其中包含版本信息和相关设置。例如，json 扩展通常会显示其版本，而 mbstring 会显示其各种字符集处理设置。
- 如果搜索不到这些扩展的任何信息，或者它们显示为禁用状态（尽管这种情况较少见），则明确表明当前运行的 PHP 解释器未能加载它们。
根本解决：重启相关服务
即使您在 cPanel 或其他管理界面中启用了 PHP 扩展，这些更改也可能不会立即生效。PHP 解释器（或其后端服务，如 PHP-FPM）通常需要重启才能应用新的配置。
立即学习“PHP免费学习笔记（深入）”；
重启步骤
根据您的服务器环境和权限，重启方法有所不同：
-
Cpanel 用户：
- 登录您的 cPanel 账户。
- 导航至 “软件” 或 “PHP 版本” 部分。
- 通常，您会找到一个选项来选择或切换 PHP 版本。有时，仅仅重新选择当前正在使用的 PHP 版本并保存，或者点击“设置”/“应用”按钮，就会触发 PHP 服务的重启。
- 如果 cPanel 没有提供直接的 PHP 服务重启按钮，您可能需要联系您的主机提供商寻求帮助，或者在某些情况下，重启整个 Web 服务器（如果您的权限允许）。
-
- 通过 SSH 连接到您的服务器。
- 重启 Web 服务器：
- 重启 PHP-FPM 服务（如果您的 PHP 配置使用 FPM）：
重启后验证
- 服务重启完成后，再次访问您之前创建的 http://您的域名/info.php。
- 确认 “json” 和 “mbstring” 扩展现在已在 phpinfo() 输出中正确显示。
- 安全提示： 为了避免泄露服务器配置信息，在确认问题解决后，务必删除您创建的 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 等扩展缺失时，即使您已在控制面板中启用它们，这通常是由于服务器环境未能正确加载或应用配置更改所致。解决此问题的关键在于：
- 使用 phpinfo() 进行诊断： 通过生成 phpinfo() 文件来验证扩展的实际加载状态。
- 重启相关服务： 根据您的服务器环境，重启 Web 服务器（Apache 或 Nginx）和/或 PHP-FPM 服务，以确保新的配置生效。
- 注意环境细节： 仔细检查 PHP 版本匹配、PHP Handler 类型，并在共享主机环境下联系服务商寻求帮助。
遵循这些步骤，您将能够有效地排查并解决 PHP 扩展缺失的问题，确保您的应用程序正常运行。