解决 PHP JIT 因扩展冲突被禁用：Xdebug 卸载后的排查与修复

php jit (just in time) 编译器是 php 8.0 引入的一项重要性能优化特性，它通过将热点代码编译成机器码来显著提升执行效率。然而，当某些第三方扩展，特别是那些会覆盖 zend_execute_ex() 函数的调试或分析工具（如 xdebug），被加载时，jit 机制可能会被禁用，并抛出类似 "php warning: jit is incompatible with third party extensions that override zend_execute_ex(). jit disabled." 的警告。即使您已尝试通过包管理器卸载并重新安装 php，此问题仍可能持续存在，这通常意味着冲突的扩展配置未能被完全清除。

JIT 禁用原因分析

JIT 的工作原理依赖于对 PHP 引擎内部执行流程的深度介入。当一个扩展通过覆盖 zend_execute_ex() 等核心函数来改变 PHP 的执行行为时，JIT 为了避免潜在的冲突和不稳定性，会选择自我禁用。Xdebug 就是这类扩展的典型代表，它需要监控和修改代码执行路径以提供调试功能。

当通过 apt-get remove --purge php-xdebug 等命令卸载 Xdebug 时，虽然二进制文件可能被移除，但相关的 PHP 配置文件（.ini 文件）有时会残留，或者在其他地方存在引用，导致 PHP 在启动时仍然尝试加载该扩展，从而触发 JIT 禁用警告。

诊断与修复步骤

要彻底解决 JIT 被禁用问题，核心在于识别并移除所有加载冲突扩展（如 Xdebug）的配置。

1. 检查当前加载的 PHP 模块

首先，我们需要确认 PHP 当前实际加载了哪些模块。这可以通过 php -m 命令来完成。

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

php -m

执行此命令后，您会看到一个按字母顺序列出的已加载 PHP 模块列表。仔细检查此列表，看是否仍存在 xdebug 或其他您不希望加载的调试/分析扩展。如果 xdebug 仍然出现在列表中，则表明它仍在某个地方被 PHP 加载。

2. 定位 PHP 配置文件

接下来，我们需要找出 PHP 正在使用哪些配置文件。这些文件是 PHP 配置的来源，包括扩展的加载指令。使用 php --ini 命令可以列出所有相关的 .ini 文件。

php --ini

该命令的输出通常会包含以下几部分信息：

• Configuration File (php.ini) Path: PHP 主配置文件的路径。
• Loaded Configuration File: 实际加载的主 php.ini 文件路径。
• Scan for additional .ini files in: PHP 扫描额外配置文件的目录。
• Additional .ini files parsed: 列出在该扫描目录中找到并解析的所有额外 .ini 文件。

您需要关注 Loaded Configuration File 和 Additional .ini files parsed 列出的所有文件。

因赛AIGC

因赛AIGC解决营销全链路应用场景

73

查看详情

3. 检查并移除冲突配置

根据 php --ini 的输出，逐一检查列出的所有 .ini 文件。通常，Xdebug 的加载配置可能存在于以下位置：

• 主 php.ini 文件: 检查 Loaded Configuration File 指向的 php.ini 文件，搜索 zend_extension=xdebug.so 或 extension=xdebug.so 等行。
• 模块配置目录: 在 Additional .ini files parsed 中列出的文件中，特别留意那些位于 conf.d 或 mods-available 目录下的文件，例如 /etc/php/8.0/mods-available/xdebug.ini 或 /etc/php/8.0/fpm/conf.d/20-xdebug.ini。

操作步骤：

1. 打开相关 .ini 文件: 使用文本编辑器（如 nano 或 vim）打开您怀疑包含 Xdebug 配置的文件。

   sudo nano /path/to/your/xdebug.ini
   # 例如：sudo nano /etc/php/8.0/mods-available/xdebug.ini

   登录后复制
2. 查找并注释/删除加载指令: 搜索包含 xdebug 关键字的行，特别是以 zend_extension 或 extension 开头的行。

   ;zend_extension=xdebug.so  ; 注释掉这行
   ;xdebug.mode=develop       ; 如果有其他xdebug配置，也一并注释或删除

   登录后复制

   如果您确定不再需要 Xdebug，可以直接删除整个 xdebug.ini 文件（如果它是一个独立的模块配置文件）。

   sudo rm /etc/php/8.0/mods-available/xdebug.ini
   # 如果有符号链接，可能还需要移除符号链接
   sudo rm /etc/php/8.0/fpm/conf.d/20-xdebug.ini

   登录后复制

   请注意，PHP 可能会有多个 SAPI (Server API) 版本（如 php8.0-fpm、php8.0-cli、apache2），每个 SAPI 可能有自己的 php.ini 或模块配置目录。确保检查并修改所有相关 SAPI 的配置。例如，对于 FPM 模式，通常在 /etc/php/8.0/fpm/ 目录下；对于 CLI 模式，在 /etc/php/8.0/cli/ 目录下。

4. 重启 PHP 服务

在修改任何 PHP 配置文件后，必须重启相应的 PHP 服务，以使更改生效。

• 对于 PHP-FPM:

  sudo systemctl restart php8.0-fpm

  登录后复制

  （请根据您的 PHP 版本调整服务名称，例如 php7.4-fpm 或 php-fpm）

• 对于 Apache 模块:

  sudo systemctl restart apache2

  登录后复制
• 对于 Nginx + PHP-FPM: 仅需重启 php-fpm 服务。

5. 验证 JIT 状态

重启服务后，再次运行 php -m 确认 xdebug 已不在加载模块列表中。 更重要的是，检查您的 PHP 错误日志或运行一个简单的 PHP 脚本来验证 JIT 是否已恢复正常。例如，创建一个 info.php 文件：

<?php
phpinfo();
?>

通过浏览器访问此文件，搜索 "JIT" 关键字。如果 JIT 正常工作，您应该能看到 JIT 相关的配置信息，并且不再出现 JIT 禁用警告。

注意事项与总结

• 全面性检查: PHP 环境可能复杂，不同的 SAPI（CLI、FPM、Apache 模块）可能加载不同的配置文件。务必对所有您使用的 PHP 环境进行彻底检查。
• 其他冲突扩展: 虽然 Xdebug 是最常见的罪魁祸首，但其他一些可能覆盖 zend_execute_ex() 的扩展（如某些性能监控或代码覆盖工具）也可能导致 JIT 禁用。如果问题依然存在，请扩展排查范围。
• 备份: 在修改任何配置文件之前，建议先进行备份，以防意外情况发生。
• 版本兼容性: 确保您安装的所有 PHP 扩展都与您的 PHP 版本兼容。

通过以上详细的诊断和修复步骤，您应该能够成功解决 PHP JIT 因扩展冲突而被禁用的问题，从而充分利用 PHP 8.0+ 带来的性能优势。关键在于理解 PHP 配置文件的加载机制，并细致地排查每一个可能的加载源。

以上就是解决 PHP JIT 因扩展冲突被禁用：Xdebug 卸载后的排查与修复的详细内容，更多请关注php中文网其它相关文章！