php 8.4预加载修改后不生效，因preload.php仅在服务启动时执行一次，必须重启php-fpm（非重载）；需确认opcache.preload路径正确、opcache.enable=1、preload.php无语法错误且权限可读，并通过错误日志和opcache_get_status()验证。
PHP 8.4 预加载（preload）修改后不生效，不是“没加载”，而是预加载内容已固化进 PHP-FPM 进程内存，**改了 preload.php 文件本身不会自动重载**——它只在 PHP 服务启动时执行一次。必须重启服务才能让新 preload 生效。
确认预加载是否真正启用
先排除配置未生效的低级错误：
- 访问 phpinfo() 页面，搜索 opcache.preload，确认其值为绝对路径（如
/www/wwwroot/myapp/preload.php），且未被注释或设为空字符串 - 检查 opcache.enable=1 是否开启（预加载依赖 OPcache 启用）
- 运行
php -v确认版本 ≥ 7.4（PHP 8.4 满足），再执行php --ri opcache，查看输出中是否有Preloaded scripts行及对应文件数 - 若无该行或数量为 0，说明 preload.php 根本没被执行——常见原因是路径写错、文件权限不足（PHP 进程不可读）、或 preload.php 中存在语法错误导致中断
验证 preload.php 是否按预期加载类
preload.php 只负责 include_once 或 require_once 类文件，不执行逻辑。排查重点是“是否真包含了”：
- 在 preload.php 开头加一行
error_log("preload loaded at " . date('Y-m-d H:i:s'));，然后查 PHP 错误日志（如/www/wwwlogs/php_error.log）——重启后应有且仅有一条该日志 - 在 preload.php 中对每个
require_once后加error_log("Loaded: MyClass");，确认每行都被记录 - 若某类未出现在日志里，检查该文件路径是否为绝对路径、是否存在、是否被其他 require 提前加载过（preload 不会重复加载已存在的类）
修改 preload.php 后必须完整重启 PHP-FPM
reload 不行，systemctl reload php8.4-fpm 或宝塔点“重载配置”完全无效——因为预加载发生在进程初始化阶段，只有新进程才会重新执行 preload.php：
- 正确操作：执行
sudo systemctl restart php8.4-fpm（注意版本号匹配，宝塔用户可在【软件管理】→PHP 8.4→【重启】） - 验证是否成功：重启后再次查错误日志，确认新时间戳的日志出现；再用
opcache_get_status()['preloaded_scripts']查看数组长度或具体文件名是否更新 - 切勿只改了 CLI 的 php.ini（
php --ini显示路径）而忽略 FPM 的配置（phpinfo()中的 Loaded Configuration File）
警惕 preload 中的副作用和加载顺序陷阱
preload.php 被设计为“纯声明式”，任何运行时行为都会破坏稳定性：
- 禁止在 preload.php 中调用
new、class_exists()、function_exists()、echo、file_get_contents()等——这些会导致 PHP 启动失败或静默跳过后续加载 - 如果项目使用 Composer，可安全 include
vendor/autoload.php，但需确保该文件本身不含 new / echo 等（现代 Composer 默认满足） - 若 preload.php 中包含多个类文件，且它们之间有依赖（如 A 类 extends B 类），必须保证 B 在 A 之前被 require_once，否则报
Class not found
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
