phpEnv是面向Windows的GUI集成环境（非官方PHP项目），官网https://www.phpenv.cn/下载最新exe安装包；安装路径须纯英文无空格，需勾选桌面快捷方式；Apache端口冲突时通过控制面板修改；VS Code需手动配置php.executablePath为C:\phpenv\php\php.exe；不支持.php-version及多版本切换。
phpEnv 不是官方 PHP 项目，也不是 PHP 官方推荐的多版本管理工具；它是一个面向 Windows 用户的集成环境 GUI 工具（含 Apache + MySQL + PHP），和 phpenv（Linux/macOS 的命令行版本管理器）完全无关，混用会导致路径、命令、配置全部失效。
怎么下载 phpEnv 安装包
官网地址是 https://www.phpenv.cn/，不是 GitHub 或 GitCode 上的开源仓库。所有 Windows 用户应从此站下载最新 exe 安装包（2026 年当前最新版约 45MB）。不要从第三方镜像、论坛附件或搜索广告链接下载，那些常捆绑静默安装器或旧版。
安装时注意两点：
- 安装路径必须是纯英文、无空格、无中文（例如
C:phpenv合理，C:Program Filesphpenv或D:我的开发环境会失败） - 务必勾选“创建桌面快捷方式”，后续启停服务、打开控制面板都依赖它
安装后 Apache 启动失败怎么办
首次点击“启动”Apache 显示红色（未运行），最常见原因是端口被占：Windows 自带的 IIS、Skype、甚至某些国产软件会默认监听 80 端口。
立即学习“PHP免费学习笔记（深入）”；
解决方法直接在 phpEnv 控制面板操作：
- 点击右上角“配置” → “端口检测”，它会扫描并高亮冲突端口
- 点击“配置” → “Apache 配置”，把
Listen 80改成Listen 8080（或其他未被占用的端口） - 保存后重启 Apache；之后访问
http://localhost:8080即可
别手动去改 C:phpenvpacheconfhttpd.conf —— phpEnv 的配置界面已封装该文件，直接改会导致下次点“应用配置”时被覆盖。
如何让 VS Code 正确识别 phpEnv 的 PHP 解释器
phpEnv 自带的 PHP 二进制位于 C:phpenvphpphp.exe（路径固定，不随版本切换变化），但 VS Code 的 PHP 插件默认不会自动发现它。
需要手动指定：
- VS Code 打开设置（
Ctrl+,），搜php.executablePath - 把值设为
C:\phpenv\php\php.exe（注意双反斜杠） - 重启 VS Code，再按
Ctrl+Shift+P输入PHP: Select Interpreter，应能显示该路径
不要试图用 phpenv global 或 phpenv local 命令来切换——那是 Linux/macOS 的 phpenv（命令行工具），和 Windows 的 phpEnv（图形软件）毫无关系，强行套用只会报 command not found。
为什么 .php-version 文件在 phpEnv 里没用
因为 phpEnv 是单 PHP 版本集成环境，不支持 per-project 版本切换。它没有 shims、不读取 .php-version、也不提供 phpenv local 功能。
如果你真需要多版本共存（比如同时跑 PHP 7.4 和 8.2 的项目），有且只有两个选择：
- 卸载 phpEnv，改用 WSL2 +
phpenv+php-build（适合熟悉命令行的用户） - 保留 phpEnv 作为主环境，另装
phpstudy或XAMPP的某个旧版做辅助，通过不同端口隔离
试图给 phpEnv 打补丁、写脚本模拟版本切换，最终都会卡在 Apache 模块兼容性上——它的 php7apache2_4.dll 是编译死的，换 PHP 版本必须重装整个 phpEnv。
