PHP 8.5.5 JIT编译有效开启方法

先泼盆冷水：PHP 8.5.5 根本不存在——官方从未发布过 PHP 8.5 或其任何子版本。目前最新稳定版是 PHP 8.3，PHP 8.4 还处在 alpha 阶段。所以那些盯着“8.5.5 JIT”配置的，其实都是在 PHP 8.0–8.3 的 JIT 机制上打转。版本号抄错、文档找错、编译参数用错——这三件事是 JIT 白忙活最常见的原因。

需要再次强调：PHP 8.5.5 并未发布，当前最新稳定版本为 PHP 8.3，8.4 仍处于 alpha 阶段。所有以“8.5.5 JIT”为关键词进行配置的操作，本质上都在调整 PHP 8.0–8.3 的 JIT 机制。版本号填写错误、文档查阅错误、编译参数遗漏——这三个问题只要触发其中任意一个，JIT 配置即会失效。

opcache.jit=1205 这类数值如何设置才能生效

opcache.jit 是一个位掩码整数，并非简单的开关。若将其设为 On、1 或 tracing（旧文档遗留写法），INI 解析器会直接将其转为 0，导致 JIT 实际未启用。

• 必须使用十进制整数：推荐常用值包括 1205（含函数内联 + 热点检测）、1255（增加循环展开，但 PHP 8.1–8.2 下部分复杂循环可能触发 LLVM 崩溃）、1235（激进模式，启用全部优化，适合 CLI 长时计算场景）
• 切勿轻信“opcache.jit=tracing”——PHP 8.0 以上版本已移除该字符串模式，仅支持数字
• 验证是否生效：执行 var_dump(opcache_get_status()['jit'])，若返回数组且 enabled === true 则表示真正启用；返回 null 或空数组则说明配置失败

opcache.jit_buffer_size=256M 为什么不能沿用默认值

默认 opcache.jit_buffer_size=16M，中型项目几秒内即可耗尽，直接报错 Failed to allocate JIT memory，JIT 会自动降级为解释执行。

• 缓冲区不足时，opcache_get_status()['jit']['buffer_size'] 显示为 0，memory_used 接近上限但不再增长
• Web 场景建议起步设为 64M，CLI 跑数学密集型或 AI 推理任务建议设为 256M
• 注意：该值仅在 opcache.enable=1 且编译时携带 --enable-opcache-jit 的前提下才生效；否则设置再大也是无效

Linux 编译时 --enable-opcache-jit 必须显式添加

JIT 并非 OPcache 的默认组件，而是可选子功能。编译时若未开启，运行时无论如何配置都不会生效。

• --enable-opcache 必须存在（否则整个 OPcache 被禁用，opcache.jit 直接忽略）
• --enable-opcache-jit 必须显式添加；默认关闭，不加则等同于无 JIT
• Windows VC 编译环境默认不支持 JIT（缺少 libjit 或 LLVM 后端），仅 Linux/macOS 下 GCC/Clang 编译实测可用
• Docker 用户需注意：php:8.4-cli-alpine 等精简镜像通常缺少 --enable-opcache-jit，建议改用非 Alpine 镜像或自行编译

CLI 模式下 opcache.enable_cli=1 容易遗漏

Web 请求中 OPcache 默认启用，但 CLI 脚本默认禁用，导致 php your_script.php 完全不走 JIT 路径。

• 方法一：在 php.ini 中添加 opcache.enable_cli=1
• 方法二：运行时强制覆盖：php -d opcache.enable=1 -d opcache.enable_cli=1 -d opcache.jit=1235 -d opcache.jit_buffer_size=256M script.php
• CLI 下 JIT 触发需要“同一函数被调用超过数千次”，短脚本或单次调用不会编译，切勿用 echo "hello" 测试 JIT 效果

真正阻碍配置生效的往往不是参数名——编译开关缺失、平台不支持、CLI 默认关闭、缓冲区耗尽却不报错，这些步骤若未逐一验证，opcache.jit 只会是 INI 文件中一行安静的数字。