直接安装官方windows版phpenv即可,它是图形化集成环境(含apache、mysql、php一键启停),与linux/macos下命令行版本管理工具phpenv(小写)完全不同;需从https://www.phpenv.cn/下载最新.exe安装包,安装路径避免中文、空格及c盘,勾选创建桌面快捷方式,安装前关闭杀毒软件;启动失败时优先使用“端口检测”排查80/3306占用,并可修改为8080/3307;新增站点需开启“自动写入hosts”和“自动重启服务”,且任何配置更改后必须手动点击“重启所有服务”。

直接装官方 Windows 版 phpEnv 就行,别碰 Linux/macOS 的 phpenv(小写、Git 管理型),两者完全不是同一个东西——前者是图形化集成环境(Apache+MySQL+PHP 一键启停),后者是命令行版本管理工具,混用必踩坑。
下载安装:认准官网,避开中文路径和 C 盘
去 https://www.phpenv.cn/ 下最新 Windows 安装包(.exe),别从第三方渠道下。安装时注意三点:
- 安装路径不能含中文、空格或特殊符号,例如
D:\phpEnv可以,C:\Program Files\phpEnv或D:\我的开发环境会触发权限/路径解析异常 - 勾选“创建桌面快捷方式”,后续点图标就能打开控制面板
- 安装前临时关闭杀毒软件(尤其是 360、火绒),它们常把 Apache 启动进程误判为风险行为
启动服务失败?先查端口占不占用
首次打开 phpEnv 控制面板,Apache 和 MySQL 显示红色(停止状态)很常见,多数是端口冲突。不要急着重装:
- 点击顶部菜单「配置」→「端口检测」,它会自动扫描
80(Apache)、3306(MySQL)是否被 Skype、IIS、其他本地服务占用 - 若被占,直接在「配置」→「Apache 设置」里把端口改成
8080,MySQL 改成3307,保存后重启服务 - 改完端口记得同步更新浏览器访问地址:原来是
http://localhost,现在得输http://localhost:8080
新增站点后打不开?hosts 和自动重启必须开
在控制面板点「新增站点」后,如果浏览器访问 http://myproject.test 报错“无法连接”,大概率是两个开关没打开:
- 进「开始」→「软件设置」→「高级设置」,确保勾选:
新增站点后自动写入hosts和新增/保存站点后自动重启服务 - 这两个开关关着时,
myproject.test不会写进系统C:\Windows\System32\drivers\etc\hosts,DNS 解析就失败 - 不自动重启,Apache 就加载不到新站点的虚拟主机配置,自然 404 或 503
最易被忽略的是:改完任何配置(端口、站点、PHP 版本)后,必须手动点一次「重启所有服务」按钮——界面上的「启动」只对当前停止的服务生效,不会重载已运行服务的新配置。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











