PHP本地多域名绑定需hosts映射、Web服务器虚拟主机配置及PHP代码识别HTTP_HOST；三者域名必须完全一致，否则导致502/404。
PHP本地环境绑定多域名，本质是让不同域名都指向本地的同一套代码（或不同目录），关键不在PHP本身，而在Web服务器（Apache/Nginx）和系统hosts文件的配合。PHP只是被调用的后端，不参与域名解析。
修改 hosts 文件添加本地域名映射
这是所有多域名访问的前提。Windows在 C:\Windows\System32\drivers\etc\hosts，macOS/Linux在 /etc/hosts。需用管理员/root权限编辑，追加行：
127.0.0.1 local.test 127.0.0.1 api.local.test 127.0.0.1 admin.local.test
注意：
- 每行一个IP+空格+域名，不能有tab混用
- 不要写 http:// 或端口号
- 修改后需刷新DNS缓存：Windows运行 ipconfig /flushdns，macOS运行 sudo dscacheutil -flushcache
Apache：用
在 httpd.conf 或 extra/httpd-vhosts.conf 中启用虚拟主机，并为每个域名单独定义：
ServerName local.test DocumentRoot "/Users/you/project/web" AllowOverride All Require all granted
ServerName api.local.test DocumentRoot "/Users/you/project/api" AllowOverride All Require all granted
必须确保：
- Listen 80 已启用
- Include conf/extra/httpd-vhosts.conf 未被注释
- Apache重启后生效：sudo apachectl restart
Nginx：用 server 块区分域名
在 nginx.conf 的 http 块内添加多个 server：
立即学习“PHP免费学习笔记（深入）”；
server {
listen 80;
server_name local.test;
root /Users/you/project/web;
index index.php;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
server {
listen 80;
server_name admin.local.test;
root /Users/you/project/admin;
index index.php;
…… 其他配置同上
}
常见疏漏：
- 忘记给每个 server 配 root，导致404
- fastcgi_pass 地址与PHP-FPM监听地址不一致（如PHP-FPM实际监听 sock 文件，却写了 127.0.0.1:9000）
- 修改后没执行 sudo nginx -t && sudo nginx -s reload
PHP代码里识别当前域名？用 $_SERVER['HTTP_HOST'] 而非 $_SERVER['SERVER_NAME']
$_SERVER['SERVER_NAME'] 来自Nginx/Apache配置中的 server_name 或 ServerName，不可靠；而 $_SERVER['HTTP_HOST'] 是浏览器实际请求的Host头，真实反映用户访问的是哪个域名。
例如判断当前是否为API域名：
if ($_SERVER['HTTP_HOST'] === 'api.local.test') {
// 加载API专用配置
define('APP_ENV', 'api');
} elseif ($_SERVER['HTTP_HOST'] === 'admin.local.test') {
define('APP_ENV', 'admin');
}注意：
- HTTP_HOST 可被客户端伪造，仅用于本地开发环境路由分发，生产环境需额外校验
- 如果启用了HTTPS且本地用自签证书，浏览器可能拦截，此时可临时改用HTTP测试，或把证书加入系统信任链
真正卡住人的往往不是配置本身，而是三处不一致：hosts里写的域名、虚拟主机里配的 ServerName/server_name、浏览器地址栏输入的域名——只要有一个拼错或大小写不匹配，就502或404。建议统一用小写字母+短横线，全程复制粘贴避免手误。
