phpEnv下Apache虚拟主机生效需三要素：必须将配置文件置于conf/vhost/目录而非httpd-vhosts.conf；DocumentRoot路径须全用正斜杠、无空格中文、末尾不加斜杠；每个<Directory>块内必须含Require all granted。
phpEnv 下配 Apache 虚拟主机，httpd-vhosts.conf 默认不生效，DocumentRoot 路径含空格或反斜杠必报 403，Require all granted 缺失直接拒绝访问——这三处不修正，其他配置全白搭。
确认 phpEnv 是否真走标准 httpd-vhosts.conf
phpEnv 的 Apache 配置行为和 XAMPP/WAMP 不同：它默认忽略 conf/extra/httpd-vhosts.conf，哪怕你往里写了完整 <VirtualHost> 块也完全没用。实际生效的入口是 phpenv\apache\conf\vhost\ 目录下的所有 .conf 文件。
实操建议：
- 别碰
httpd.conf里的Include conf/extra/httpd-vhosts.conf行——删了或留着都一样，phpEnv 启动时根本不读这个文件 - 进
phpenv\apache\conf\vhost\，新建一个如myapp.test.conf的文件 - 内容必须以
<VirtualHost *:80>开头，且ServerName和后续hosts条目严格一致（比如不能写myapp.test.多个点）
DocumentRoot 路径写错导致 403 或 Invalid command
Windows 路径在 phpEnv 的 Apache 2.4.x 中极其敏感：D:\my app\public、D:/my app\public、D:/my project/public/ 全部触发错误——前者因空格，中间因混用斜杠，末尾斜杠则让 .htaccess 重写失效。
立即学习“PHP免费学习笔记（深入）”；
正确写法只有一种：
- 全部用正斜杠：
DocumentRoot "D:/my_project/public" - 路径不含中文、空格、括号（如
(dev)）、特殊符号 - 末尾不加斜杠，且必须指向框架的
public目录（不是项目根目录） - 确保该路径下存在
index.php或index.html，否则 Apache 默认禁止列目录，直接返回 403
Directory 权限块必须含 Require all granted
phpEnv 自带的示例配置或网上抄来的旧模板常保留 Order allow,deny + Allow from all，这是 Apache 2.2 语法。phpEnv 默认用 Apache 2.4+，遇到这种写法会启动失败或返回 403，且 error_log 里只报“AH00526: Syntax error”，不指明哪行错。
每个 <VirtualHost> 内的 <Directory> 块必须包含且仅需这三行：
Options Indexes FollowSymLinks-
AllowOverride All（Laravel/ThinkPHP 等依赖此读.htaccess） -
Require all granted（唯一有效的放行指令；Require all denied才是拒绝）
注意：<Directory> 路径必须和 DocumentRoot 完全一致，大小写、斜杠方向都不能差。
PHP 文件显示源码或 500 报 proxy connection refused
phpEnv 默认启用 Apache + PHP-FPM 模式（非 mod_php），所以光有 DocumentRoot 和 <Directory> 不够。若没显式转发 .php 请求，Apache 就不会调用 PHP 解析器——结果就是下载源码，或 500 错误并提示 proxy: fcgi://127.0.0.1:9000 connection refused（说明 PHP-FPM 进程根本没被触达）。
必须在 <VirtualHost> 块内加这段：
<FilesMatch \.php$>
SetHandler "proxy:fcgi://127.0.0.1:9000"
</FilesMatch>
关键点：
- 不要用
ProxyPass或ProxyPassMatch—— phpEnv 的 PHP-FPM 默认监听127.0.0.1:9000，SetHandler更轻量且兼容 - 确保 phpEnv 控制面板里 PHP-FPM 是「运行中」状态（图标绿色），端口未被其他进程占用
- 多个虚拟主机共用同一个 PHP-FPM 实例，无需为每个站单独开进程
最后一步永远是改 C:\Windows\System32\drivers\etc\hosts，加一行 127.0.0.1 myapp.test，然后点 phpEnv 界面的「Restart Apache」——不是重载，是彻底 stop 再 start。
