小皮面板v8升级PHP版本本质是安装新版本并切换站点使用，而非覆盖式升级；通过软件管理安装或手动导入NTS/TS版本，再在网站配置中指定PHP版本即可完成切换。
小皮面板 v8 升级 PHP 版本，本质不是“升级”现有版本，而是安装新版本 + 切换站点使用。面板本身不提供直接覆盖式升级（比如把 PHP 7.4 直接升为 8.2），而是通过多版本共存机制实现平滑过渡。
安装新 PHP 版本（推荐方式）
这是最稳妥、最常用的方法，适合绝大多数场景：
- 登录小皮面板，左侧导航进入【软件管理】→【PHP版本】
- 在列表中找到目标版本（如 PHP 8.2.9、8.3.36 或 8.4.20），确认后缀是 nts（Nginx 环境）或 ts（Apache 环境），日常开发基本选 nts
- 点击右侧【安装】按钮，等待自动完成（通常 1–3 分钟）
- 安装成功后，该版本会出现在已安装列表中，可随时用于站点配置
手动添加官方新版（如 PHP 8.4）
当软件商店暂未上架最新版（例如 PHP 8.4 官方已发布但小皮尚未同步），可手动导入：
- 去 PHP 官网 Windows 下载页，下载对应架构的 NTS（非线程安全） zip 包（如
php-8.4.20-nts-Win32-vs17-x64.zip） - 解压到小皮 PHP 目录：
D:\phpstudy_pro\Extensions\php\，新建文件夹并规范命名（如php8.4.20nts） - 确保
php.exe在该文件夹根目录，不嵌套；复制php.ini-development并重命名为php.ini - 编辑
php.ini：设置绝对路径的extension_dir，并启用必要扩展（curl、mbstring、gd、fileinfo等）
为站点切换 PHP 版本
安装/手动添加完成后，需为具体网站指定新版本：
立即学习“PHP免费学习笔记（深入）”；
- 左侧进入【网站】，找到目标站点，点击【管理】
- 选择【PHP版本】，下拉菜单中会出现所有已安装版本（含手动添加的）
- 选中新版本（如
php8.4.20nts），保存后重启该站点的 Web 服务（Nginx 或 Apache） - 验证：在网站根目录建
phpinfo.php，内容为<?php phpinfo(); ?>，访问后查看 PHP Version 和 Loaded Configuration File
注意事项与常见问题
避免踩坑的关键细节：
- NTS/TS 必须匹配 Web 服务器：Nginx 用 NTS，Apache 用 TS；选错会导致服务启动失败或 502 错误
- 手动添加时，
php.exe不能在子文件夹里（如不能是php8.4.20nts/php/php.exe） - PHP 8.3+ 对语法更严格，老项目（如 ThinkPHP 5.x、FastAdmin）需提前做兼容性测试
- 验证完务必删除
phpinfo.php，防止环境信息泄露 - 旧版本不用删，多版本可长期共存，切换仅需下拉选择
