宝塔面板升级旧站点PHP版本本质是安装新版本+切换绑定+验证兼容性；需先手动安装PHP 8.2并确保php-fpm运行，确认站点使用php-fpm而非mod_php，检查扩展依赖、socket路径匹配及代码兼容性，再切换并查日志定位502等问题。
宝塔面板里“升级”旧站点的 PHP 版本，本质不是覆盖旧环境，而是安装新版本 + 切换绑定 + 验证兼容性。直接在站点设置里点选 PHP 8.2，大概率会白屏或报 502——因为缺扩展、socket 路径不匹配、或代码调用了已被移除的函数。
确认 PHP 8.2 已安装且 php-fpm 正在运行
宝塔不会自动装新 PHP，下拉菜单为空或灰显，90% 是这步没做。别跳过。
- 进「软件商店」→ 搜索
PHP 8.2→ 点「安装」（推荐选「编译安装」，极速安装常缺redis、fileinfo等关键扩展） - 安装完去「软件管理」列表，确认
PHP-82状态是「正在运行」，不是「已停止」或「安装失败」 - 如果状态异常，点右侧「设置」→「服务」→ 手动「启动」；再看日志：
/www/wwwlogs/php82.log，常见错误如unable to load dynamic library 'redis'
检查站点是否走 php-fpm（否则切换无效）
Nginx 站点默认走 php-fpm，能自由切换；Apache + mod_php 站点则根本不会出现 PHP 版本下拉框，切了也白切。
- 进「网站」→ 点目标站点 →「设置」→「配置文件」，搜索
SetHandler或php_admin_value - 如果找到，说明当前用的是 Apache mod_php，必须改回 php-fpm：删掉相关行，改为标准 fastcgi 配置（或新建站点时直接选 Nginx）
- 确认 Nginx 配置里有类似
include enable-php-82.conf;的行，路径为/www/server/panel/vhost/nginx/你的域名.conf
切换前必须验证代码兼容性
PHP 8.2 移除了 create_function()、禁止动态属性、严格校验类型声明。WordPress 插件、ThinkPHP 3.x、老版帝国CMS 很可能直接 Fatal error。
立即学习“PHP免费学习笔记（深入）”；
- 先在子目录建测试站（如
/test82），把代码复制过去，用php82 -v和php82 -m确认基础可用 - 检查是否依赖已废弃扩展：
mysql（应改用mysqli或pdo_mysql）、mcrypt（PHP 7.2+ 已移除）、ext-mongo - 打开「网站」→「设置」→「PHP 版本」，选
82后别急着保存，先点右上角「测试配置」，看是否提示 nginx 语法错误
切换后 502/空白页的三秒定位法
这不是“没切成功”，而是请求发出去了但没人接——95% 是 socket 路径不一致或 php-fpm 没监听。
- 查错误日志：
/www/wwwlogs/你的域名.error.log，重点搜connect() to unix:/tmp/php-cgi-82.sock failed - 确认 php-fpm-82 实际监听路径：进「PHP-82 设置」→「PHP-FPM」→ 看「监听地址」，常见值是
unix:/tmp/php-cgi-82.sock或127.0.0.1:9002 - 对比 Nginx 配置中
fastcgi_pass值是否完全一致（注意路径大小写、结尾斜杠、sock 文件是否存在） - 临时删掉网站根目录下的
.user.ini（它可能硬锁了php_version=74这类旧指令）
最易被忽略的一点：切换后 CLI 模式下的 php 命令未必同步变更为 8.2，计划任务、Composer、定时脚本若写了 /usr/bin/php，仍会调用旧版本。得手动软链或改脚本路径为 /www/server/php/82/bin/php。
