phpEnv是Windows平台PHP集成环境，提供图形化控制面板，支持Apache/Nginx、多PHP版本共存及站点级版本绑定；phpenv则是类rbenv的命令行PHP版本管理工具，适用于Linux/macOS。
phpEnv 不是 phpenv —— 这是两个完全不同的工具，混用会导致命令无效、路径错乱、版本切换失效。
确认你真正需要的是哪个工具
如果你的目标是「在 Windows 上快速搭起 Apache + MySQL + 多个 PHP 版本的集成环境」，比如运行 ThinkPHP、Laravel 本地项目或测试不同 PHP 版本兼容性，那你该用的是 phpEnv（官网 phpenv.cn，Windows 图形界面，带控制面板）。
如果你实际想管理 Linux/macOS 下多个编译安装的 PHP 版本（类似 pyenv/rbenv），用命令行切换全局/项目级 PHP 解释器，那才是 phpenv（GitHub 上的开源项目，无 GUI，纯 shell 工具）。
常见错误现象：phpenv install 8.2 在 Windows 的 phpEnv 控制台里报错；或者在 macOS 终端里双击运行 phpEnv.exe —— 这些都说明工具和场景彻底错配。
立即学习“PHP免费学习笔记（深入）”；
phpEnv（Windows 集成环境）下载与安装要点
官网地址固定为 https://www.phpenv.cn/，其他镜像或第三方打包站可能含捆绑软件或旧版。
- 下载后直接运行
phpEnv_Setup.exe，全程图形向导，无需命令行 - 安装路径必须不含中文、空格、特殊符号，推荐
D:\phpEnv；装在C:\Program Files\下大概率因 UAC 权限导致服务无法启动 - 安装时勾选「创建桌面快捷方式」和「开机自启（可选）」，方便后续快速调出控制面板
- 首次启动会自动检测并下载缺失组件（如 PHP 8.2、MySQL 8.0、Apache 2.4），网络慢时别关窗口，它会在后台重试
phpEnv 中切换 PHP 版本的实际操作路径
它不靠 .php-version 文件或 phpenv local 命令，而是通过控制面板+站点绑定实现多版本共存。
- 启动 phpEnv 控制面板 → 点击「软件管理」→ 安装你需要的 PHP 版本（如
PHP 8.1、PHP 8.3），每个版本独立解压到D:\phpEnv\php\下对应子目录 - 点击「网站」→ 「添加站点」→ 在「PHP 版本」下拉框中为该站点单独指定一个已安装的版本
- 保存后，phpEnv 会自动修改该站点对应的
httpd-vhosts.conf和php.ini路径，重启 Apache 即生效 - 验证方式：访问站点下的
phpinfo()页面，看Loaded Configuration File路径是否指向你选的那个 PHP 版本目录
容易被忽略的权限与端口问题
很多“启动失败”“页面空白”“500 错误”其实和 PHP 版本无关，而是底层环境卡住：
- Apache 启动失败？先点「配置」→「端口检测」，检查 80 端口是否被 Skype、IIS 或另一个 phpEnv 实例占用；改端口后记得在 hosts 里同步更新访问域名（如
127.0.0.1 www.test83.com） - MySQL 启动失败？右键 phpEnv 快捷方式 → 「以管理员身份运行」，否则 Windows 会拦截服务注册
- 修改过
php.ini但不生效？确认你编辑的是当前站点绑定的那个 PHP 版本下的php.ini，不是别的版本目录里的同名文件 - ThinkPHP 报
Class 'PDO' not found？进「软件管理」→ 找到对应 PHP 版本 → 点「扩展管理」→ 勾选pdo_mysql并重启 Apache
复杂点在于：phpEnv 的每个 PHP 版本都有自己的扩展目录、ini 文件、甚至 OpenSSL 配置。切版本 ≠ 切二进制，而是整套运行时环境切换，扩展启用状态、时区、内存限制都得跟着重配一遍。
