composer 无法自动刷新 opcache，因其属 php 运行时机制；必须显式调用 opcache_reset() 或重启 php-fpm。因 opcache 不监听文件变更，且默认不校验时间戳，导致 composer install 后仍加载旧类映射，引发 class not found 等问题。
不能直接用 Composer 命令自动刷新 OPcache，因为 OPcache 是 PHP 运行时机制，不在 Composer 控制范围内；必须靠脚本触发 opcache_reset() 或重启 PHP-FPM。
为什么 composer install 后 OPcache 不自动刷新
Composer 安装依赖、生成 autoload_static.php 等文件后，PHP-FPM 进程仍缓存着旧的 opcode 和 autoload 映射。OPcache 不监听文件系统变更，也不会因 composer install 自动失效对应条目——它只按 opcache.revalidate_freq 间隔检查时间戳（默认 2 秒或更长），且生产环境常设为 0（永不校验）。
常见现象：类文件已更新、vendor/composer/autoload_static.php 时间戳最新，但请求仍报 Class not found 或加载旧版本。
-
opcache.enable=1且opcache.enable_cli=0（CLI 下关着不影响，但 Web 请求走 FPM） -
opcache.revalidate_freq设为 60 或更大值，导致修改后等很久才重载 -
opcache.validate_root未启用，或路径映射未覆盖vendor/目录
在 post-install-cmd 中调用 opcache_reset() 的前提条件
该方式仅适用于开发环境，且需确保：opcache_reset() 函数未被禁用、执行脚本有权限、且运行在 Web SAPI（而非 CLI）下——但 Composer 脚本默认跑在 CLI，所以不能直接调用生效。
可行做法是：让 Composer 在安装后，通过一个可被 Web 请求访问的 PHP 文件触发重置（例如部署后访问 /admin/opcache-reset.php），或改用更可控的方案：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在项目根目录放一个
reset-opcache.php，内容为<?php opcache_reset();，部署后 curl 触发 - 若用 Laravel / ThinkPHP 等框架，可在
post-install-cmd中执行php artisan optimize:clear（部分版本会连带清 OPcache，但不保证） - 真正可靠的是在部署脚本里加一行：
curl -X POST http://localhost/reset-opcache.php（需 Nginx 允许本地访问）
生产环境更稳妥的做法：重启 PHP-FPM 而非依赖 opcache_reset()
opcache_reset() 在多进程 PHP-FPM 下只重置当前 worker 进程的缓存，其他进程仍用旧映射；而 systemctl restart php-fpm 会拉起全新进程，所有 OPcache 条目重建，效果彻底。
推荐在 CI/CD 部署流程末尾执行：
-
sudo systemctl restart php8.2-fpm（版本按实际改） - 或
sudo service php7.4-fpm reload（reload 可能不丢连接，但不一定清 OPcache；restart 更稳） - 若用 Docker，应在 entrypoint 或 deploy hook 中
kill -USR2 $(cat /var/run/php-fpm.pid)或直接supervisorctl restart php-fpm
注意：Nginx 本身不参与 OPcache 管理，但若配了 fastcgi_cache，需同步加 fastcgi_cache_bypass 规则，避免缓存住 500 错误页。
验证 OPcache 是否真刷新成功
别只看浏览器是否不报错，要确认缓存条目已更新：
- 访问
opcache_get_status()输出页面（或 CLI 执行php -r "print_r(opcache_get_status()['scripts']);"） - 搜索
vendor/autoload.php和vendor/composer/autoload_static.php，确认hits从 0 开始上升 - 检查
last_used时间戳是否为当前秒级时间 - 临时在入口加
opcache_invalidate('vendor/composer/autoload_static.php', true)（仅调试用，勿留线上）
最易被忽略的一点：OPcache 缓存的是文件内容哈希，不是路径。如果 autoload_static.php 因权限问题没写入新内容（比如 vendor/ 目录属主不对），即使重启 FPM，加载的仍是旧映射——得先确认文件内容已更新。
