phpEnv是Windows专用图形化集成环境，非Linux/macOS的phpenv；需从phpenv.cn下载.exe安装包，避开C盘及中文路径，切换PHP版本须点击“应用”并重启Apache，命令行php -v无效因不修改系统PATH。
phpEnv 不是 phpenv —— 这是两个完全不同的工具，混用会导致命令失效、服务起不来、版本切换完全没反应。 很多人搜“phpEnv下载安装”，结果按 phpenv 的 Linux/macOS 教程在 Windows 上敲 git clone 和 eval "$(phpenv init -)"，最后连 phpenv 命令都找不到，就是因为搞错了项目主体。
Windows 用户直接下 phpEnv 安装包，别碰 Git 克隆
phpEnv 是面向 Windows 的图形化集成环境（含 Apache + MySQL + PHP + Nginx 切换界面），官网提供的是带界面的 .exe 安装程序。它不依赖 shell、不读 .bashrc、也不生成 shim 文件。
- 去官方渠道下载：搜索 “phpEnv 官网” 或访问
phpenv.cn（截至 2026 年 4 月仍为有效域名），下载页面明确标注 “Windows 版安装包” - 安装包大小约 200MB，双击即运行，不是源码压缩包
- 安装路径必须避开
C:\Program Files和任何含中文/空格的目录，推荐D:\phpEnv - 安装时勾选“创建桌面快捷方式”，否则后续找控制面板很麻烦
启动失败？先查端口和杀毒软件
点“启动 Apache”或“启动 MySQL”后图标仍是红色，大概率不是配置错，而是端口被占或被拦截。
- 默认 Apache 占 80 端口、MySQL 占 3306 端口 —— 运行
netstat -ano | findstr :80查看谁在用 - 常见冲突进程：
skype.exe、World Wide Web Publishing Service、其他集成环境（如 XAMPP）残留服务 - 杀毒软件（尤其 360、腾讯电脑管家）常静默拦截 phpEnv 的服务注册，安装前务必临时关闭
- 端口改完后，必须点控制面板右上角“重启服务”，不能只点“启动”
PHP 版本切换不生效？你可能在用 phpenv 的思维操作 phpEnv
phpEnv 控制面板里有“PHP 版本”下拉菜单，选完要点击旁边的“应用”按钮（不是回车，也不是双击），且需重启 Apache 才会真正加载新版本的 php.ini 和扩展。
立即学习“PHP免费学习笔记（深入）”；
- 切换后验证方式只有两种：
http://localhost/phpinfo.php页面查看，或进D:\phpEnv\php\目录看当前软链接指向哪个子目录（如php -> php-8.3.13） - 它不识别项目根目录下的
.php-version文件 —— 那是 phpenv 的机制，phpEnv 完全不读这个 - 如果你需要 per-project 版本隔离，phpEnv 做不到；得换 WSL + phpenv，或者用 Docker
- 扩展开关在控制面板“PHP 设置”页签里勾选，改完同样要重启 Apache
为什么 php -v 还是旧版本？因为系统 PATH 没动
phpEnv 启动的服务用的是它自己目录里的 PHP，但你在命令行敲 php -v 调用的是系统 PATH 里第一个找到的 php.exe —— 这俩根本不是一回事。
- 想让终端也用 phpEnv 的 PHP，手动把类似
D:\phpEnv\php\php-8.3.13加到系统环境变量PATH最前面 - 加完必须新开一个命令行窗口，老窗口的 PATH 不会自动刷新
- 验证：运行
where php，第一行输出应是你刚加的路径 - 不建议长期这么干 —— 本地 CLI 和 Web 服务用不同 PHP 版本是常态，强行统一反而容易出问题
最常被忽略的一点：phpEnv 的“PHP 设置”里修改 memory_limit 或 upload_max_filesize 后，只改了 php.ini 文件，但 Apache 不会自动重载配置。必须点“重启 Apache”，否则所有修改都是假的。
