宝塔面板不支持PHP 7.4原地升级到8.2，必须通过“安装PHP 8.2 + 切换网站绑定 + 验证适配”三步完成；旧版保留可回切，需勾选必要扩展、检查监听隔离、更新.user.ini并排查日志。
升级和切换是两个不同层面的操作：升级指把某个PHP版本本身更新到更高小版本（比如从8.1.0升到8.1.12），属于“同一版本线内的补丁更新”；切换则是让网站改用另一个已安装的、不同主版本或构建类型的PHP（比如从PHP 7.4换成PHP 8.2，或从nts换成ts），属于“运行时环境的替换”。
升级PHP版本（同版本线内更新）
通常用于修复安全漏洞、获取小版本新特性或解决已知bug，不改变主版本号。小皮面板官方提供的PHP安装包一般已是稳定小版本，但有时官网会发布更新包（如8.3.36），而面板尚未同步。这时可手动下载zip包，解压进PHP目录并重命名（如php8.3.36nts），它本质上是“新增一个版本”，而非覆盖旧版——所以严格来说，小皮面板本身并不支持传统意义的“就地升级”，而是靠“新增+切换”来实现效果。
- 操作路径：下载PHP官方zip → 解压到小皮PHP目录根层 → 重命名便于识别 → 面板中为站点选择该新文件夹
- 不改动原有PHP安装，不影响其他站点
- 需注意NTS/TS匹配Web服务器类型（Nginx用NTS，Apache用TS）
- 手动添加后需检查php.ini，启用必要扩展（如opcache、mysqli）
切换PHP版本（跨版本或跨类型变更）
这是小皮面板最常用的功能，核心目的是让不同网站按需使用不同PHP环境。例如老WordPress站点锁在7.4，新Laravel项目用8.2，两者可共存且互不干扰。切换动作本身不安装新PHP，只修改站点配置指向已存在的PHP实例。
- 操作路径：网站列表 → 管理 → PHP版本 → 下拉选择已安装项 → 提交 → 重启对应服务
- 切换后必须重启Nginx/Apache或PHP-FPM，否则不生效
- 可随时切回，无需卸载，适合兼容性测试和灰度验证
- 若切换后报500或空白页，优先检查nts/ts是否选错、php.ini是否缺失关键配置
什么时候该升级，什么时候该切换？
看目标需求：
立即学习“PHP免费学习笔记（深入）”；
- 项目报“Deprecated: mysql_connect() is deprecated”这类警告？→ 不是升级PHP，而是代码要适配，可能需切换到更高主版本并调整语法
- 发现CVE-2026-XXXX漏洞公告影响当前PHP小版本？→ 手动添加新版（如8.1.12），再切换过去，即“升级效果”
- 新装的ThinkPHP8项目提示“Attribute requires PHP 8.1+”？→ 直接切换到已安装的PHP 8.1或更高版本即可
- 想保留PHP 7.4跑老站，同时给新站用PHP 8.3？→ 先安装8.3，再分别切换，这就是多版本共存的典型场景
