Apache多站点配置关键在于启用并正确编辑httpd-vhosts.conf，绑定hosts域名，且每个VirtualHost需配独立Directory权限段；缺一不可。
Apache虚拟主机配置必须改httpd-vhosts.conf
PHP本地环境（如XAMPP、WAMP、MAMP或手动安装的Apache）要跑多个站点，核心不是改htdocs目录，而是启用并编辑httpd-vhosts.conf。这个文件默认通常被注释掉，不主动开启，VirtualHost配置完全无效。
操作路径示例（以XAMPP为例）：
– 打开 C:\xampp\apache\conf\extra\httpd-vhosts.conf
– 确保主配置httpd.conf中这行已取消注释：Include conf/extra/httpd-vhosts.conf
- 每新增一个站点，就写一组
-
ServerName必须唯一，比如local.project-a.test和local.project-b.test -
DocumentRoot路径末尾不要加斜杠，Windows下反斜杠要写成正斜杠或双反斜杠：C:/dev/project-a/public或C:\\dev\\project-a\\public - 务必配上
> Require all granted，否则403 Forbidden
hosts文件必须手动绑定域名到127.0.0.1
浏览器访问local.project-a.test这种地址，DNS不会自动解析。必须修改系统hosts文件，硬编码映射到本地IP。
Windows路径：C:\Windows\System32\drivers\etc\hosts
macOS/Linux路径：/etc/hosts
- 用管理员权限（Windows）或
sudo（macOS/Linux）打开编辑 - 追加行，格式严格为：
127.0.0.1 local.project-a.test（前后无空格，无www.前缀除非你真要配） - 每行一个域名，不能用逗号或空格分隔多个域名
- 改完保存后，命令行执行
ping local.project-a.test确认返回127.0.0.1，否则Apache收不到请求
PHP-FPM或mod_php影响的是脚本执行，不是多站点路由
多站点根目录本身和PHP运行模式无关——mod_php（Apache模块）或PHP-FPM（FastCGI）只决定PHP代码怎么被执行，不影响VirtualHost对HTTP请求的分发逻辑。
- 如果你用的是XAMPP/WAMP，默认是
mod_php，无需额外配置PHP部分 - 若切换为
PHP-FPM（比如配合Nginx或新版XAMPP），只需确保每个VirtualHost里ProxyPassMatch或SetHandler指向正确的PHP socket或端口，例如：SetHandler "proxy:unix:/usr/local/var/run/php-fpm.sock|fcgi://localhost" - 不同站点共用同一PHP版本时，
php.ini是全局生效的；如需 per-site 配置（比如不同upload_max_filesize），得用php_admin_value写在mod_php）
常见404/403错误直接查这三个位置
配完访问报错，别急着重装环境。90%问题出在以下三处：
立即学习“PHP免费学习笔记（深入）”；
127.0.0.1 local.project-a.test 127.0.0.1 local.project-b.test
对应检查顺序：
-
hosts是否生效：浏览器访问
http://local.project-a.test，看地址栏是否保持原样（不是跳转成http://127.0.0.1/...）；命令行nslookup local.project-a.test应返回127.0.0.1 -
DocumentRoot路径是否存在且可读：Apache用户（Windows是SYSTEM，macOS/Linux通常是
_www或daemon）必须有该目录的rx权限；Windows注意路径大小写不敏感但空格和中文可能引发意外 -
Apache是否加载了vhost配置：重启Apache后，运行
httpd -S（或apache2ctl -S）查看输出，确认你的ServerName出现在VirtualHost列表中，且port 80状态为is a NameVirtualHost
最易忽略的是httpd-vhosts.conf里漏写了Require all granted写成Require all denied——这种错不会报错日志，只会静默返回403。
