PHP多站点本地配置指南

本文详细解析了在PHP本地开发环境中（如XAMPP、WAMP、MAMP或手动搭建的Apache）高效配置多站点根目录的核心方法与避坑指南：关键在于启用并精准编辑`httpd-vhosts.conf`、严格绑定`hosts`文件域名映射、为每个站点独立配置`VirtualHost`及配套的`Directory`权限段（尤其不能遗漏`Require all granted`），同时厘清了PHP运行模式（mod_php或PHP-FPM）与多站点路由逻辑无关的本质——真正决定请求分发的是Apache虚拟主机机制本身；文末还直击403/404高频故障，归纳出hosts生效性、DocumentRoot路径权限和vhost加载状态三大排查黄金步骤，助开发者快速定位问题、告别无效重装。

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%问题出在以下三处：

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。

好了，本文到此结束，带大家了解了《PHP多站点本地配置指南》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！