必须先确认目标PHP版本已安装并运行，再分别绑定至网站和CLI环境；网站切换需在“网站→设置→PHP版本”中选择带前缀的完整标识（如php-82）并保存，命令行切换需启用“PHP命令行版本开关”或调用绝对路径验证。
宝塔面板切换PHP版本不是“选一下就生效”的操作，必须分清网站运行环境和命令行环境，两个地方要分别处理，否则你会看到php -v是新版，但网站还是跑在旧版上。
网站怎么切到新PHP版本
这一步只影响单个站点，不影响其他网站或系统命令行。关键在于确认目标PHP已安装且正在运行，再手动绑定。
- 进「网站」→ 找到目标站点 → 点「设置」→ 切到「PHP版本」选项卡
- 下拉菜单里选的是带前缀的完整标识，比如
php-82，不是8.2或PHP 8.2 - 点「提交」后，面板会自动重载该站点的Nginx配置，并尝试重启对应版本的
php-fpm服务 - 验证必须用真实请求：在网站根目录放
info.php（内容为<?php phpinfo(); ?>），浏览器访问后看「PHP Version」和「Loaded Configuration File」是否匹配预期路径（如/www/server/php/82/etc/php.ini）
为什么php -v还是旧版本
因为宝塔默认不改/usr/bin/php软链接，命令行调用的PHP由PATH决定，和网站用的php-fpm完全隔离。
- 先执行
which php和php -v，确认当前CLI用的是哪个二进制文件 - 临时用新版：直接调用绝对路径，例如
/www/server/php/82/bin/php -v - 永久切换CLI默认版本：进「软件商店」→ 找到目标PHP版本（如PHP-8.2）→ 点「设置」→ 在「PHP命令行版本开关」处启用（此操作会更新
/usr/bin/php软链） - 不推荐手动
ln -sf硬改，某些宝塔插件或定时任务依赖原始路径，容易中断
切换后常见失效原因
版本看似切了，但页面空白、500或502，大概率是扩展、配置或路径没对齐。
立即学习“PHP免费学习笔记（深入）”；
-
502 Bad Gateway：检查/www/server/php/82/etc/php-fpm.d/www.conf里的listen =路径，是否和Nginx配置中fastcgi_pass指向一致（通常是/www/server/php/82.sock） - 白屏或
Class 'finfo' not found：编译安装时漏了fileinfo扩展；进该PHP版本的「设置」→ 「安装扩展」里补上 - Composer报错或镜像失效：每个PHP版本的CLI环境独立，必须用对应路径执行配置，例如
/www/server/php/82/bin/php /usr/bin/composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ -
.user.ini残留旧配置：若站点启用了防跨站，检查根目录下是否有.user.ini，里面若有php_version=74或open_basedir锁定旧路径，需手动清理或更新
最易被忽略的一点：切换完必须验证实际请求响应，而不是只信面板下拉框选中了——因为面板不会自动校验目标PHP是否真在运行、sock文件是否存在、扩展是否加载成功。任何一环断掉，都会导致“看起来切了，其实没生效”。
