应下载官网phpenv.cn提供的windows安装版phpenv_setup_2.5.1.exe,它是集成apache/mysql的图形化环境;勿混淆github上同名命令行工具phpenv(小写p),其不支持windows且无web服务。

直接装官方 Windows 版 PHPEnv 就行,别折腾源码版 phpenv —— 两者名字像但完全不是一回事:前者是图形化集成环境(Apache+MySQL+多PHP版本一键切换),后者是类 rbenv 的命令行多版本管理工具,只管 PHP 二进制,不带 Web 服务。
Windows 下该下哪个 PHPEnv?认准官网 phpenv.cn
搜索 “phpenv.cn” 进入官网,下载页面明确标注 “Windows 安装版”,文件名类似 PHPEnv_Setup_2.5.1.exe(截至 2026 年 4 月最新稳定版)。不要从 GitHub 或镜像站找源码仓库,那属于另一个项目 phpenv(小写 p),它不提供图形界面、不集成 Apache/MySQL,也不支持 Windows 原生运行。
- 安装路径必须避开中文、空格和系统保护目录(如
C:\Program Files),推荐C:\PHPEnv或D:\dev\PHPEnv - 务必勾选“创建桌面快捷方式”,后续启停服务全靠它
- 首次运行会自动检测并安装基础组件(PHP 7.4 / 8.1 / 8.2 等),若卡在下载,可暂时关闭杀毒软件或换网络重试
启动失败?先查端口占不占用
点控制面板上的“启动”按钮后仍是红色,大概率是 80(Apache)或 3306(MySQL)被占用了。常见抢端口的程序有 IIS、Skype、某些国产安全软件、甚至已残留的 WAMP/XAMPP 服务。
- 点击“配置 → 端口检测”,它会扫描并高亮冲突端口
- 修改方式:点“配置 → Apache 配置”,把
Listen 80改成Listen 8080;同理 MySQL 配置里改port=3306为port=3307 - 改完必须点“保存配置”再点“重启服务”,否则不生效
怎么让项目跑起来?别漏掉 hosts 和站点绑定
PHPEnv 启动成功只是第一步,访问 http://localhost 能看到欢迎页,但你的项目还不能通过域名访问——它默认不自动写入 hosts,也不自动绑定域名到目录。
- 手动编辑
C:\Windows\System32\drivers\etc\hosts,追加一行:127.0.0.1 myapp.test - 在 PHPEnv 控制面板点“新增站点”,填域名
myapp.test、根目录选你的项目文件夹(如D:\projects\myapp)、PHP 版本选对应项 - 勾选“新增站点后自动写入 hosts”和“保存站点后自动重启服务”(在“软件设置 → 高级设置”里),以后就省事了
真正容易被忽略的是:PHPEnv 的“PHP 版本切换”只影响 Apache 处理的请求,不影响你在终端里执行的 php -v —— 那还是系统 PATH 里的 PHP。如果要用命令行跑测试或 Composer,得单独配好 phpenv(小写)或者把 PHPEnv 自带的 PHP 路径加进系统环境变量。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











