PHP版本切换后必须清理OPcache、框架缓存、Web服务器缓存及浏览器/CDN缓存，且PHP-FPM需执行带版本号的重启命令（如service php-fpm-81 restart），否则旧缓存会导致语法错误或功能异常。
不清理缓存，PHP版本切换就等于没切——新版本的OPcache、文件缓存、甚至Web服务器内部缓存都可能还在用旧版本生成的数据。
PHP-FPM服务重启必须带版本号
很多用户在phpStudy或宝塔里切换了PHP版本（比如从7.4切到8.1），却只点了“重启Apache/Nginx”，结果页面还是报错或行为异常。根本原因是：PHP-FPM进程没换过来。
- 在命令行中，必须执行带版本后缀的服务命令，例如：
service php-fpm-81 restart（不是service php-fpm restart） - phpStudy控制面板里切换后，要手动找到对应PHP版本的“启动/停止”按钮，或在服务列表中确认
php-fpm-81已运行、php-fpm-74已停止 - 宝塔面板中，进入「软件管理」→ 找到目标PHP版本 → 点击「重启」，这个操作本质就是调用带版本号的systemd或init脚本
OPcache缓存必须单独清除
即使PHP-FPM进程已更新，OPcache仍会把旧版本编译后的opcode缓存在内存里，导致语法错误、函数不存在等典型现象（比如PHP 8.1新增的str_ends_with()在页面里仍提示undefined function）。
- 进「PHP管理」→ 找到刚启用的版本（如PHP-8.1）→「设置」→ 拉到底点「清除OPcache缓存」
- 若无图形入口，可临时加一行代码到网站入口文件（如
index.php顶部）：opcache_reset();，访问一次后删掉 - 注意：
opcache_reset()仅对当前PHP-FPM worker进程有效；多worker场景下，需确保所有worker都执行过，最稳妥仍是重启php-fpm-xx
ThinkPHP/Laravel等框架缓存要分层清理
框架自身缓存（如路由、配置、视图）和PHP底层缓存是两套机制，版本切换后前者不会自动失效，尤其当storage/目录跨版本复用时。
立即学习“PHP免费学习笔记（深入）”；
- Laravel项目需运行：
php artisan cache:clear、php artisan config:clear、php artisan view:clear - ThinkPHP5.0中，若权限缓存用了前缀（如
auth_user_），应显式调用：Cache::clear('auth_user_')，而非依赖全局Cache::clear() - 注意Redis驱动兼容性：若生产环境禁用了
KEYS命令，Cache::clear($prefix)会静默失败，需改用SCAN+UNLINK逻辑或直接连Redis执行redis-cli --scan --pattern "auth_user_*" | xargs redis-cli unlink
浏览器与CDN缓存常被忽略
前端资源（JS/CSS/HTML）可能被浏览器或CDN缓存，导致你看到的“PHP版本未生效”，其实是静态响应没变。
- 刷新页面时强制清缓存：
Ctrl+Shift+R（Windows/Linux）或Cmd+Shift+R（macOS） - 检查响应头：
curl -I https://yoursite.com，确认X-Powered-By字段已变为新PHP版本 - 宝塔/Nginx启用proxy_cache时，需额外执行「全清Nginx缓存」或手动
rm -rf /www/server/nginx/proxy_cache_dir/*
最容易漏掉的是OPcache内存缓存和框架的storage/framework目录——它们不随PHP-FPM重启自动刷新，也不受浏览器控制，必须主动干预。尤其是多人共用开发机或测试服务器时，一个没清干净的bootstrap/cache/config.php可能让整个团队卡在“明明切了8.2却还报7.4语法错误”的死循环里。
