phpEnv 是 Windows 下开箱即用的图形化 PHP 集成环境，内置 PHP 7.4、MySQL 5.7 和 Apache/Nginx 双引擎，安装需避开 C 盘根目录，必须启用自动写入 hosts 和自动重启服务两项高级设置，并通过 .php-version 文件实现站点级 PHP 版本切换。
phpEnv 是 Windows 下开箱即用的 PHP 集成环境，不是命令行工具（别和 phpenv 混淆），安装后直接图形界面操作，无需手动配 PATH、编译 PHP 或折腾 Apache 配置。
phpEnv 官方下载地址和安装路径选择
官网是 https://www.phpenv.cn，下载页在 https://www.phpenv.cn/download.html。最新稳定版截至 2026 年 4 月是 8.9.5，内置 PHP 7.4、MySQL 5.7、Apache/Nginx 双引擎。
安装时强烈避开 C 盘根目录（比如 C:\phpenv），原因有三：
- Windows Defender 和部分杀软会拦截 C 盘根目录下的服务进程，导致 Apache 启动失败，报错类似
httpd.exe has stopped working - 路径含空格或中文（如
C:\Program Files\phpenv）会导致站点管理器无法写入hosts或重启服务 - 后续用 VS Code 打开项目时，如果工作区路径太深（如嵌套在 C:\Users\XXX\AppData\Local\...），某些插件会读取失败
推荐装到 D:\phpenv 或 E:\dev\phpenv 这类干净路径。
立即学习“PHP免费学习笔记（深入）”；
安装后必须打开的两个高级设置开关
首次启动 phpEnv，点击左下角「开始」→「软件设置」→「高级设置」，以下两项必须勾选：
-
新增站点后自动写入 hosts：否则你添加
test.local站点后，在浏览器输http://test.local会提示 DNS 错误 - 新增、保存站点后自动重启服务：否则改了端口、PHP 版本或根目录，不手动点「重启 Apache」就看不到效果
这两个开关关着，等于白装——很多用户卡在“为什么我建了站打不开”，其实就差这一步。
VS Code 联动 phpEnv 浏览网页的关键配置
phpEnv 自带「一键在浏览器中打开」按钮，但 VS Code 编辑器要真正联动，得确认两件事：
- 你的项目文件夹必须放在 phpEnv 的默认站点根目录下（通常是
D:\phpenv\www或你安装时自定义的www子目录），不能放桌面或文档里 - VS Code 中打开的文件路径，必须是该站点目录下的 PHP 文件，比如
D:\phpenv\www\test\index.php；如果打开的是D:\tmp\index.php，右键「Open in Default Browser」会 404 - phpEnv 的「网站管理」里，对应站点的「根目录」路径必须和你在 VS Code 中打开的实际路径一致，大小写和末尾斜杠都要对上（
D:\phpenv\www\test\≠D:\phpenv\www\test）
常见错误现象：ERR_CONNECTION_REFUSED，大概率是 Apache 没起来，先看 phpEnv 主界面右下角状态栏是否显示「Apache: Running」；如果不是，点「重启服务」再试。
多版本 PHP 共存但不生效？检查 .php-version 文件位置
phpEnv 支持为每个站点单独指定 PHP 版本（如一个站用 7.4，另一个用 8.2），但这个功能依赖站点根目录下的 .php-version 文件，内容只能是一行纯版本号，例如：
8.2.12
注意三点：
- 这个文件必须放在你「网站管理」里配置的「根目录」最外层，不是 VS Code 工作区根目录，也不是子文件夹
- 文件名是
.php-version，不是php-version或.php_version，Windows 资源管理器默认隐藏点开头文件，建议用 VS Code 或命令行创建 - 改完后必须保存站点设置并触发「自动重启服务」，否则 PHP 版本不会切换
容易被忽略的是：phpEnv 的「PHP 版本」下拉菜单只控制「全局默认版本」，单个站点是否生效，全看那个小小的 .php-version 文件在不在、对不对、有没有被识别。
