phpEnv（Windows GUI版）是集成Apache/Nginx/MySQL的图形化PHP环境，按站点绑定PHP版本并自动生成vhost和hosts；而phpenv（类Unix命令行工具）通过shim管理多版本，二者不可混用。
phpEnv（注意大小写）不是 phpenv —— 这是两个完全不同的工具，混用会导致命令找不到、服务起不来、路径错乱等一连串问题。前者是 Windows 下的集成环境 GUI 软件（类似 XAMPP），后者是类 Unix 系统下的命令行 PHP 版本管理器。你如果在 Windows 上双击安装了 phpEnv.exe，那接下来所有操作都得按它的界面逻辑走，而不是敲 phpenv install。
确认你用的是哪个 phpEnv
打开任务管理器或资源监视器，看进程名是不是 phpEnv.exe；或者直接在开始菜单里搜“phpEnv”，点开是图形界面就对了。如果是终端里输入 phpenv --version 有输出，那你其实用的是 phpenv（小写开头），和这个 Windows 工具无关。很多新手卡在这一步，装了 GUI 版却去查命令行文档，越查越懵。
在 phpEnv（Windows GUI 版）中添加多个网站
它的多站点管理依赖于「新增站点」功能，不是靠配置文件或命令行切换。核心动作都在软件主界面的「站点管理」页签里：
- 点击「新增站点」按钮，填入域名（如
site-a.local）、根目录（如D:\phpEnv\www\site-a）、PHP 版本（下拉选择已安装的版本） - 勾选「自动写入 hosts」——它会帮你把
127.0.0.1 site-a.local加进C:\Windows\System32\drivers\etc\hosts - 根目录必须是空文件夹或只含合法 Web 文件（不能有中文路径、不能有空格、不能在 OneDrive 或 iCloud 同步目录下）
- 每个站点独占一个 Apache 虚拟主机配置，保存后会自动生成
D:\phpEnv\apache\conf\vhost\site-a.local.conf
添加完记得点「重启 Apache」，否则新站点不生效。浏览器访问 http://site-a.local 才能加载对应目录内容。
立即学习“PHP免费学习笔记（深入）”；
phpEnv 中 PHP 版本不是全局切换，而是按站点绑定
你不能像 phpenv global 8.3 那样一键切全系统 PHP 版本。phpEnv 的 PHP 是以「组件」形式安装的，每个站点创建时单独指定：
- 先去「软件管理」→「PHP」里勾选并安装你需要的多个版本（如 PHP 7.4、8.1、8.3）
- 新建站点时，在「PHP 版本」下拉框里选对应项；已有站点可右键「编辑」修改
- 不同站点可以跑不同 PHP 版本，互不影响——这是它和纯 CLI 工具最实用的差异点
- 注意：某些扩展（如
redis、opcache）需在「软件管理」里为每个 PHP 版本单独启用，不是装一次就全站可用
常见失败点：hosts 写入失败、端口冲突、路径权限
新增站点后打不开？先看这三项：
-
hosts文件被杀毒软件或管理员策略锁定：手动用记事本（以管理员身份运行）打开C:\Windows\System32\drivers\etc\hosts，确认是否有你刚加的行；没有就手补一行，保存时可能提示“需要管理员权限” - Apache 启动失败报「Address already in use: AH00072」：说明 80 端口被占用，去「配置」→「端口检测」查冲突进程（通常是 Skype、IIS、另一套集成环境），或直接改 phpEnv 的 Apache 端口为 8080
- 根目录访问显示 403 Forbidden：检查路径是否含中文/空格/特殊符号；右键文件夹 →「属性」→「安全」→ 确认 Users 组有「读取和执行」权限
这些不是配置技巧，而是 Windows 下绕不开的底层限制。GUI 工具省去了编译和 PATH 配置，但没绕过系统级权限和网络栈规则。
