新装PHP版本后站点不会自动切换，需手动修改各站点PHP版本设置并重载配置；切换前须停用OPcache、切换后清空缓存；注意扩展启用、函数禁用及回滚三步操作。
新装PHP版本后，站点默认不会自动切换
宝塔面板安装新PHP版本只是添加一个运行环境，所有站点仍绑定在旧版本上。必须手动修改每个站点的PHP版本设置，否则新装的PHP完全不生效。
操作路径：网站 → 选择站点 → 设置 → PHP版本 → 下拉选择新版本 → 保存。注意保存后需点击“重载配置”（Nginx）或“重启PHP服务”（Apache），否则改动不生效。
- 新PHP版本安装完成后，在「软件商店」→「PHP管理」里确认状态为“已安装”，而非“正在安装”或“失败”
- 若下拉菜单中看不到新版本，检查是否勾选了“显示已安装版本”（右上角筛选按钮）
- 部分老版本宝塔（如7.9.x）在安装PHP 8.2+时可能因依赖缺失失败，建议先升级宝塔至最新版再操作
切换前必须关闭OPcache并清空缓存
PHP版本切换后，旧OPcache缓存仍可能被复用，导致500错误或页面白屏——尤其常见于Laravel、ThinkPHP等框架站点。
操作顺序不能错：先停用OPcache → 切换PHP版本 → 清空OPcache → 重载Web服务。
立即学习“PHP免费学习笔记（深入）”；
- 在「PHP设置」→「禁用函数」旁点击「配置修改」，搜索
opcache.enable，临时改为0并保存 - 切换完PHP版本后，进入该PHP版本的「禁用函数」页，点击「重载配置」按钮（不是重启PHP）
- 再进「PHP信息」页，点「清除OPcache」；若无此按钮，可临时加一行
opcache_reset();到站点根目录的info.php中访问触发
切换后立即验证的关键点：MySQL连接、file_get_contents和curl
PHP 8.0+ 默认禁用 allow_url_fopen，且MySQL扩展从 mysql_* 彻底移除、mysqli 和 PDO_mysql 需显式启用。很多老站一换就报“Call to undefined function mysql_connect()”或“file_get_contents(): failed to open stream”。
验证方式不是只看首页，而是直连关键功能路径：
- 访问后台登录页，抓包看是否返回
500 Internal Server Error或空白响应头 - 执行
php -m | grep -E 'mysqli|pdo_mysql|curl|openssl'确认扩展已加载（在对应PHP版本的命令行下运行） - 新建
test_db.php，内容为<?php var_dump(new PDO('mysql:host=127.0.0.1;dbname=xxx', 'user', 'pass'));，直接CLI执行比Web访问更早暴露扩展缺失问题
回滚不是点“切回旧版”就完事
宝塔界面点“切换回旧PHP版本”仅改nginx/Apache配置，但若新PHP已执行过数据库迁移、日志写入或session文件生成，直接切回可能导致session丢失、日志错乱甚至数据写入中断。
稳妥回滚必须分三步走：
- 先停掉当前新PHP的进程：
pkill -f 'php-fpm: master process.*<code>新版本号'（例如82） - 再在站点设置里切回旧版本，并确认
php-fpm对应旧版本进程已启动（ps aux | grep php-fpm） - 最后清空
/www/wwwlogs/站点名/php_session/目录（如果用了文件session）和/tmp/下相关缓存文件
最易忽略的是：某些站点启用了“PHP守护进程”或自定义的 supervisord 管理脚本，这些不会随面板切换自动重启，得手动 reload。
