PHP本地环境怎么绑定多域名访问_PHP本地环境绑多域名访问技巧【绑定】_技术教程

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：

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');
}