phpEnv是Windows原生图形化PHP集成环境,支持Apache/Nginx、多PHP版本切换及可视化管理;而phpenv是类Unix命令行版本管理器,二者不兼容,Windows用户应选phpEnv。

Windows 用户直接用 phpEnv(注意大小写)图形界面工具,比 phpenv(纯命令行、Linux/macOS 主流)省事得多——但两者完全不是同一个东西,混用会彻底搞乱环境路径和 PHP 版本识别。
确认你真正需要的是 phpEnv 而非 phpenv
很多搜索“phpenv 安装”的人,实际想要的是 Windows 上开箱即用的 phpEnv 集成环境(官网 phpenv.cn),它自带 Apache/Nginx、MySQL、PHP 多版本切换按钮和图形面板。而 phpenv 是类 Unix 系统下的命令行版本管理器,无法在原生 Windows(非 WSL)上直接运行。
- 如果你用的是 Windows 10/11,目标是快速跑 WordPress 或 ThinkPHP,选
phpEnv - 如果你用的是 macOS 或 Linux,且需要精细控制 PHP 编译参数、多项目隔离,才考虑
phpenv - 看到错误提示
phpenv: command not found却在 Windows 上折腾,基本就是下错了工具
phpEnv 下载与安装(Windows 原生版)
去官网 phpenv.cn/download.html 下载「安装版」,不是 GitHub 上的源码仓库。截至 2026 年 4 月,最新稳定版是 8.9.5,内置 PHP 7.4 / 8.2 / 8.3 可一键切换。
- 安装时勾选「添加到系统 PATH」,否则后续命令行调用
php会失败 - 默认装在
C:\phpEnv,不建议改路径——部分内置脚本硬编码了该路径 - 安装完先别急着启动,右键「以管理员身份运行」
phpEnv.exe,否则 MySQL 启动可能被防火墙拦截 - 首次启动后,在「应用软件 → 设置」中开启 CDN 加速,能显著提升插件和 PHP 版本下载速度
验证服务是否真正常,别只看图标变绿
点击「启动服务」后 Nginx 和 MySQL 图标变绿,只代表进程起来了,不代表 PHP 解析或 MySQL 连接可用。
立即学习“PHP免费学习笔记(深入)”;
- 打开浏览器访问
http://localhost,应显示 PHP 探针页(含phpinfo()输出),否则检查C:\phpEnv\www\index.php是否被误删 - 执行
mysql -uroot -proot(默认密码是root),能进 MySQL CLI 才算数据库就绪 - 如果
php -v报错或显示系统原有 PHP(如 XAMPP 的),说明 PATH 冲突——删掉其他环境的 bin 目录,或把C:\phpEnv\php\php-8.2.12这类路径手动移到 PATH 最前面
创建站点并对接 ThinkPHP/WordPress 的关键两步
phpEnv 的「网站 → 创建项目」只是生成虚拟主机配置,不等于项目能跑起来,尤其对 ThinkPHP 8 或 WordPress 这类需要重写规则和入口路径的框架。
- ThinkPHP 8 必须把站点根目录指向
public/子目录(例如D:\phpEnv\www\tp8.com\public),否则路由 404 - WordPress 不要直接解压到
www根目录,而是新建子文件夹(如www\blog),再通过浏览器访问http://localhost/blog启动安装向导 - 修改 hosts 文件不是必须操作——除非你要用
www.tp.com这类域名,否则localhost完全够用 - 如果页面空白但无报错,打开
php.ini(路径类似C:\phpEnv\php\php-8.2.12\php.ini),确认display_errors = On且error_reporting = E_ALL
最容易被忽略的是:phpEnv 每次更新 PHP 版本后,已创建的站点不会自动继承新版本,必须手动在站点设置里重新选择 PHP 版本并保存——界面上没提示,但实际已回退到旧版本。



















