必须确认三件事：一是使用Windows版phpEnv（非类Unix的phpenv）；二是PHP包为NTS版本；三是已安装对应VC运行库。
phpEnv 手动添加 PHP 版本前必须确认的三件事
Windows 下的 phpEnv（注意大小写，不是 phpenv）和类 Unix 系统的 phpenv 是两个完全不同的工具——前者是 Windows 图形化本地环境套件（类似 XAMPP），后者是命令行多版本管理器。你问的是前者的手动添加方式，即把编译好的 PHP 二进制“塞进去”并让界面识别。
操作前务必确认：
• 当前用的是 Windows 版 phpEnv（官网或百度搜索“phpEnv for Windows”可验证）
• 下载的 PHP 包是 NTS（Non-Thread-Safe）版本，不是 TS
• 已安装对应 VC 运行库（如 PHP 8.2 需要 VC16，即 Visual C++ 2019 Redistributable）
解压命名必须严格遵循 phpEnv 的识别规则
phpEnv 不会扫描任意文件夹，它只认固定格式的目录名。把下载好的 php-8.2.15-nts-Win32-vs16-x64.zip 解压后，必须重命名为：php-8.2（短版本号，不含补丁号、架构、编译器标识）。
常见错误命名（全部不识别）：
• php-8.2.15
• php-8.2-nts
• php82
• php-8.2-x64
立即学习“PHP免费学习笔记（深入）”；
正确路径示例：C:\phpEnv\php\php-8.2\php.exe —— 该路径下必须存在 php.exe 和 php.ini。
php.ini 至少要改这两个路径，否则网站直接 500
复制 php.ini-development 并重命名为 php.ini 后，必须手动编辑以下两项，且必须用绝对路径（反斜杠或正斜杠均可，但不能用环境变量）：
upload_tmp_dir = "C:/phpEnv/temp/php/upload"session.save_path = "C:/phpEnv/temp/php/session"
如果漏掉任一项目，Apache/Nginx 启动后访问页面大概率报 500 Internal Server Error，错误日志里会出现 Failed to initialize storage module 或 open_basedir restriction in effect 类提示。
重启服务后仍不显示新版本？检查 .phpenv-version 文件残留
phpEnv 界面读取版本列表时，会扫描 C:\phpEnv\php\ 下所有符合命名规则的子目录，但有一个隐藏干扰项：
如果你之前在某个网站根目录下执行过 phpenv local 7.4（这是类 Unix 的 phpenv 命令，误用），可能生成了 .phpenv-version 文件，而 Windows 版 phpEnv 会错误地尝试解析它，导致版本列表加载失败。
解决方法：
• 全局搜索 .phpenv-version 文件，全部删除
• 关闭 phpEnv 主程序，再打开任务管理器结束所有 httpd.exe、nginx.exe、mysqld.exe 进程
• 再次启动 phpEnv
真正容易被忽略的点：Windows 版 phpEnv 不支持通过命令行 phpenv install 添加版本——那个命令属于另一个工具，混用会导致配置错乱。所有添加动作必须手动完成，且每一步命名、路径、ini 配置都不可跳过校验。
