phpenv是类Unix系统下命令行多版本PHP管理器，需通过git clone安装、配置PATH和init初始化，支持global/local/shell三级版本切换及.php-version文件自动识别；phpEnv则是Windows图形化集成环境，安装路径须纯英文无空格，端口冲突和目录权限是常见故障点。
phpEnv 不是 phpenv —— 这是两个完全不同的工具，装错就白忙活。 前者是 Windows 图形化集成环境（Apache + MySQL + PHP 打包版），后者是类 Unix 下的命令行多版本 PHP 管理器（类似 pyenv/rbenv）。你在 Win10 上点开 exe 安装、看控制面板、配站点，用的是 phpEnv；而敲 phpenv install 8.3.13、写 .php-version 文件，那是 phpenv（需 Git Bash / WSL）。混淆两者会导致路径错乱、服务起不来、甚至改了 hosts 也打不开 localhost。
phpEnv 安装时路径不能含中文或空格
安装向导里默认可能建议装进 C:\Program Files\phpEnv 或 D:\my env\，这会直接导致 Apache 启动失败，错误日志里常出现 ServerRoot must be a valid directory 或 Cannot load modules/mod_so.so。原因是 Windows 服务在加载模块时对路径空格和 Unicode 处理不健壮。
- ✅ 正确做法：安装路径选纯英文、无空格、非系统盘，例如
D:\phpEnv或E:\dev\phpenv - ⚠️ 避免：
C:\Program Files\、D:\php 环境\、D:\My Tools\phpEnv - ? 若已装错：卸载后删干净残留文件夹，再重装；不要试图手动改配置里的路径，
httpd.conf里有至少 5 处硬编码路径（ServerRoot、DocumentRoot、PHPIniDir等），极易漏改
启动失败常见于 80 和 3306 端口被占
phpEnv 控制面板上 Apache 和 MySQL 显示红色“停止”，点启动没反应或秒退，大概率是端口冲突。Win10 默认会跑 IIS、Skype、Zoom、甚至某些杀软自带的 Web 服务，都会抢 80（HTTP）和 3306（MySQL）。
- ? 快速检测：管理员身份运行 cmd，执行
netstat -ano | findstr :80和netstat -ano | findstr :3306，记下 PID，去任务管理器“详细信息”页找对应进程 - ? 修改方式：phpEnv 控制面板 → “配置” → “端口检测” → 手动把 Apache 改成
8080，MySQL 改成3307（别用 3306 以外的高位端口如 40000，部分 MySQL 客户端不认） - ? 后续访问注意：改端口后，浏览器地址要写
http://localhost:8080，PHP 项目连 MySQL 也要把 host 从127.0.0.1改成127.0.0.1:3307
添加站点后访问 403 或 404？检查 DocumentRoot 和目录权限
在 phpEnv 里点“创建站点”，填了域名（如 demo.test）和根目录（如 D:\www\demo），但浏览器打开提示 Forbidden 或 Not Found，问题通常不在 DNS，而在 Apache 的目录配置。
立即学习“PHP免费学习笔记（深入）”；
- ? 关键配置在
D:\phpEnv\Apache24\conf\extra\httpd-vhosts.conf：确认生成的虚拟主机块里DocumentRoot和<directory></directory>路径**完全一致**，且末尾**没有反斜杠**（D:\www\demo✅，D:\www\demo\❌） - ? Windows 权限陷阱：如果站点目录在
C:\Users\xxx\Documents\下，Apache 服务（以 Local System 身份运行）默认无权读取该位置，会静默返回 403。解决方法是把项目挪到非用户目录（如D:\www），或右键目录 → 属性 → 安全 → 编辑 → 添加SYSTEM用户并赋予“读取和执行”权限 - ⚙️ 别忘了改
hosts：phpEnv 不自动写 hosts，得手动用记事本（管理员模式）打开C:\Windows\System32\drivers\etc\hosts，加一行127.0.0.1 demo.test
真正卡住人的地方，往往不是“怎么装”，而是“装完之后哪条路径没对齐”——httpd-vhosts.conf 里的路径、Windows 文件系统实际路径、hosts 解析、浏览器访问地址，四者必须严丝合缝。少一个冒号、多一个空格、缺一次管理员重启，都可能让页面停在 403 里不动。
