小皮面板不显示手动添加的PHP版本，主因是路径错误、文件夹嵌套或权限不足；须将解压后的PHP文件夹（如php8.3.36nts）直接放入面板【设置→文件位置→PHP】指定目录，确保php.exe位于根目录且“Users”组有读取权限，最后完全退出并重启面板。
手动添加 PHP 版本后在小皮面板里不显示，通常不是安装失败，而是路径、命名或权限环节出了偏差。重点检查三件事：文件夹是否放对位置、名称是否规范、php.exe 是否在根目录。
确认 PHP 文件夹已正确放入小皮的 PHP 目录
小皮只识别特定目录下的 PHP 版本。必须通过面板【设置】→【文件位置】→【PHP】打开的那个文件夹，把解压后的 PHP 文件夹直接放进去。不能放在子目录，也不能放在其他自定义路径（比如桌面或 D 盘根目录）。
- 打开小皮面板 → 左侧【设置】→【文件位置】→ 点击【PHP】按钮，系统会自动跳转到真实 PHP 版本目录（如 D:\phpstudy_pro\Extensions\php\）
- 把下载解压好的 PHP 文件夹（例如 php-8.3.36-Win32-vs16-x64-nts）直接拖入该目录
- 重命名为简短易识别的名字，如 php8.3.36nts（去掉空格和特殊字符）
确保 php.exe 在文件夹最顶层
小皮扫描时只认根目录下有 php.exe 的文件夹。如果解压后多出一层同名文件夹（比如压缩包解压出来是 php-8.3.36-nts\php-8.3.36-nts\php.exe），就会被忽略。
- 双击刚放进去的文件夹，确认打开后第一眼就能看到 php.exe
- 如果看到的是一个子文件夹，说明嵌套了，请剪切里面的内容，粘贴到当前文件夹根目录，再删掉空的外层文件夹
- 可右键该文件夹 → 属性 → 安全 → 确保“Users”组有读取权限（Windows 下常见限制）
重启小皮面板并刷新界面
小皮不会实时扫描新增文件夹，必须重启主程序才能重新加载版本列表。
立即学习“PHP免费学习笔记（深入）”；
- 完全退出小皮面板（右下角托盘图标右键 → 退出，不要点关闭窗口）
- 重新启动小皮，等待服务全部就绪
- 进入【网站】→【管理】→【PHP 版本】下拉框，此时应出现你刚添加的版本名
- 若仍不显示，可尝试在命令行运行一次：D:\phpstudy_pro\Extensions\php\php8.3.36nts\php.exe -v，验证能否正常输出版本号
旧版小皮面板存在兼容性问题
部分低版本（如 7.x 系列）对新版 PHP（尤其是 8.3+）识别能力弱，即使文件结构正确也可能不显示。
- 面板右上角查看当前版本号，低于 v11.0 建议升级（官网 xp.cn 获取最新 install.sh）
- 升级前做好站点配置快照备份，避免配置丢失
- 升级后首次启动可能需要几分钟重建环境索引，耐心等待即可
