PHP 7.4预加载归档是固化preload.php、OPcache配置及预加载结果的部署资产，需先验证Preloaded Scripts非空、关键类路径存在、无silent failure，再通过打包、清单生成或git子模块方式归档，并冻结可移植opcache配置快照。
PHP 7.4预加载笔记归档不是指备份文档，而是将实际生效的预加载配置、preload.php脚本、权限设置与验证结果打包固化为可复用的部署资产，确保下次部署时能跳过调试环节直接复现生产环境状态。
确认预加载已真实生效
运行 php --ri opcache，在输出末尾查找 Preloaded Scripts 区块；若为空或显示 0，说明 preload.php 根本没被加载——此时归档毫无意义，必须先解决根本问题。
执行 php -r "print_r(opcache_get_status()['preloaded_scripts'] ?? []);"，检查返回数组是否包含你期望加载的关键类文件路径，例如 /var/www/myapp/app/Http/Controllers/HomeController.php；【缺少关键控制器类，说明依赖顺序错误或路径过滤过严】。
查看 PHP-FPM 错误日志（如 /var/log/php74-fpm.log），搜索 preload 或 Segmentation fault；若存在 silent failure，大概率是 preload.php 中调用了 class_exists() 或 new 实例化语句。
立即学习“PHP免费学习笔记（深入）”；
归档 preload.php 及其上下文
方法一：直接打包核心三件套
进入项目根目录，执行：tar -czf php74-preload-archive-$(date +%Y%m%d).tar.gz php.ini preload.php /var/www/myapp/app/
注意：只打包 app/ 是因 Laravel 类通常集中在此，vendor 部分由 Composer 管理，不纳入归档范围。
方法二：生成可验证的归档清单
运行：php -r '$s=opcache_get_status();file_put_contents("preloaded-files-list.txt", implode("\n", array_keys($s[\"preloaded_scripts\"] ?? [])));'
该命令生成纯文本清单，内容即所有成功预加载的绝对路径，可直接用于 CI 流水线比对。
方法三：用 git 子模块固化 preload.php
在项目仓库中创建 ops/preload 目录，将 preload.php 放入，并执行：git submodule add -b main https://gitee.com/yourorg/php-preload-templates.git ops/preload
后续只需 git submodule update --remote 即可同步预加载模板更新，避免重复手写逻辑。
冻结 OPcache 配置快照
第一步：提取当前生效的 opcache 配置段
用 php --ini 找到 Loaded Configuration File 路径，然后执行：awk '/^\[opcache\]$/,/^$/{print}' /etc/php/7.4/fpm/php.ini > opcache-snapshot.ini
第二步：剥离动态值，保留可移植字段
手动编辑 opcache-snapshot.ini，删掉 opcache.preload=/var/www/... 这行（路径不可移植），改为注释：; opcache.preload=SET_THIS_BEFORE_DEPLOY
保留 opcache.enable=1、opcache.memory_consumption=256 等稳定参数。
第三步：校验配置语法无误php -c opcache-snapshot.ini -m | grep opcache 应输出 opcache；若报错，说明有非法字符或拼写错误，必须修正后再归档。
这一步操作起来很简单，直接把文件拖进去就行。
归档后验证脚本
新建 verify-preload.sh，内容如下：
#!/bin/bash<br>if ! php -r "opcache_get_status()['preloaded_scripts'] || die('FAIL: preloading not active');" 2>/dev/null; then<br> echo "❌ Preload disabled or failed"; exit 1<br>fi<br>EXPECTED=$(wc -l < preloaded-files-list.txt)<br>ACTUAL=$(php -r 'print count(opcache_get_status()["preloaded_scripts"]);')<br>if [ "$EXPECTED" != "$ACTUAL" ]; then<br> echo "❌ Expected $EXPECTED files, got $ACTUAL"; exit 1<br>fi<br>echo "✅ All preloaded files loaded successfully"
赋予执行权限：chmod +x verify-preload.sh；每次解压归档包后，直接运行它即可断言环境一致性。
