frankenphp 下 laravel 视图或路由修改不生效，主因是 opcache 未刷新；需通过 cli 执行 opcache_reset() 清除，禁用 web 调用，部署时自动集成该命令，并确保 cli 与 web php 配置一致。
FrankenPHP 下 Laravel 视图或路由改了不生效，大概率是 OPcache 没刷新——不是 Laravel 缓存的问题，也不是 FrankenPHP 配置错，而是 PHP 字节码缓存本身在“固执地”执行旧编译结果。
确认 OPcache 确实启用且没刷新
FrankenPHP 默认启用 OPcache（尤其在生产模式），但它的启动方式和传统 PHP-FPM 不同：它内嵌 PHP 运行时，不依赖系统级 service 管理，所以 systemctl reload php-fpm 这类命令完全无效。必须直接验证 OPcache 状态：
- 在项目根目录放一个
opcheck.php，内容为<?php var_dump(opcache_get_status(false)); ?> - 访问
https://yoursite.com/opcheck.php，看opcache_get_status返回中opcache_enabled是否为true，以及num_cached_scripts是否 > 0 - 重点检查
directives.opcache.validate_timestamps和directives.opcache.revalidate_freq：若前者为false或后者值过大（如 600），就注定改完代码要等很久才生效
用 opcache_reset() 强制刷新，但要注意 FrankenPHP 的限制
FrankenPHP 不支持通过 HTTP 请求触发 opcache_reset() —— 它默认禁用该函数的 Web 调用（出于安全），直接访问 clear-opcache.php 会报 Call to undefined function opcache_reset() 或 500 错误。正确做法是：
- SSH 登录服务器，进入 FrankenPHP 进程所在目录（通常是项目根或
/usr/local/bin/frankenphp启动点） - 运行
php -r "opcache_reset();"—— 这是在 CLI 模式下调用，不受 Web 安全限制 - 如果提示
opcache_reset()不存在，说明当前 CLI 使用的 PHP 配置没启用 OPcache：执行php --ini查路径，确认opcache.so已加载且opcache.enable=1 - FrankenPHP 本身无 reload 命令，
opcache_reset()是唯一可靠的运行时刷新手段
部署后自动清 OPcache 的脚本怎么写
不能靠人工每次 SSH 手动敲命令。推荐在部署流程末尾加一步 CLI 调用：
- 在部署脚本（如 GitHub Actions、Deployer 或 shell 脚本）里追加：
php -r "if (function_exists('opcache_reset')) { opcache_reset(); echo 'OPcache cleared\n'; } else { echo 'opcache_reset not available\n'; }" - 注意：FrankenPHP 的 CLI PHP 和 Web PHP 必须是同一套配置，否则 CLI 清的是另一份缓存——用
php -i | grep opcache和 Web 端opcheck.php输出比对opcache.file_cache和opcache.memory_consumption是否一致 - 避免用
opcache_invalidate()单文件清理：FrankenPHP 下它常失效，opcache_reset()全局重置更稳
长期规避：开发/预发环境关掉 OPcache 时间戳校验
生产环境不能关 OPcache，但预发布或 CI 测试环境可以接受性能微损来换确定性。编辑 FrankenPHP 使用的 php.ini（路径由 php --ini 确认）：
- 设
opcache.validate_timestamps=On（必须开启才能让下一项生效） - 设
opcache.revalidate_freq=0—— 每次请求都检查文件修改，改完保存立刻生效 - 不要设
opcache.enable=0：FrankenPHP 启动时若发现 OPcache 关闭，可能跳过部分优化路径，反而影响稳定性 - 这个组合只适用于非高流量环境；生产环境仍应保持
revalidate_freq=2或更高，并靠部署脚本主动opcache_reset()
最常被忽略的一点：FrankenPHP 的 OPcache 是进程级的，重启 FrankenPHP 进程（比如 kill -SIGTERM 主进程再拉起）确实能清掉缓存，但代价是连接中断和冷启动延迟——不如 opcache_reset() 精准、无感。别把它当成“重启大法”的替代方案，而要当作必须纳入部署流水线的固定动作。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
