PHP本地多域名绑定需hosts映射、Web服务器虚拟主机配置及PHP代码识别HTTP_HOST；三者域名必须完全一致，否则导致502/404。
phpEnv 本身不直接管理域名绑定，它只是 Windows 下的 PHP 环境集成包（类似 phpStudy），真正起作用的是它内置的 Apache 或 Nginx 服务。多域名访问能否成功，取决于三件事是否对齐：系统 hosts 文件映射、Web 服务器虚拟主机配置、以及项目目录路径是否可访问。缺一不可，且任意一处域名拼写不一致（比如大小写、多余空格、带 www 不带 www），就会 404 或 502。
修改 hosts 文件是第一步，也是唯一需要操作系统参与的环节
这是 DNS 解析的本地捷径，必须先让系统知道“这个域名该找谁”。Windows 路径是 C:WindowsSystem32driversetchosts，需用管理员权限打开记事本编辑；macOS/Linux 是 /etc/hosts，需 sudo 权限。
在文件末尾追加行，格式严格：127.0.0.1 + 一个空格 + 域名（不能有 http://、不能有端口、不能用 tab）：
127.0.0.1 shop.test 127.0.0.1 api.shop.test 127.0.0.1 admin.shop.test
保存后必须刷新本地 DNS 缓存：
– Windows 执行 ipconfig /flushdns
– macOS 执行 sudo dscacheutil -flushcache
– Linux 执行 sudo systemd-resolve --flush-caches（或对应发行版命令）
Apache 虚拟主机配置要逐个写 <VirtualHost>，不能靠 phpEnv 界面“批量添加”
phpEnv 的图形界面（如“站点域名管理”）本质是帮你生成 Apache 的 httpd-vhosts.conf 片段，并不支持真正意义上的批量模板化添加。你看到的“添加多个域名”按钮，实际仍是单条记录一条 <VirtualHost> 块。
立即学习“PHP免费学习笔记（深入）”；
- 确认 Apache 已启用虚拟主机：检查
httpd.conf中Include conf/extra/httpd-vhosts.conf未被注释，且Listen 80存在 - 每个域名必须单独一个
<VirtualHost *:80>块，ServerName必须与hosts里写的完全一致（包括子域名） -
DocumentRoot要指向真实存在的目录，且 Apache 进程有读取权限（Windows 下注意路径斜杠方向，推荐正斜杠/或双反斜杠\） - 重启 Apache 后才生效：
httpd -k restart或通过 phpEnv 面板点“重启 Apache”
示例（放在 conf/extra/httpd-vhosts.conf 中）：
<VirtualHost *:80>
ServerName shop.test
DocumentRoot "D:/www/shop/public"
<Directory "D:/www/shop/public">
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
<VirtualHost *:80>
ServerName api.shop.test
DocumentRoot "D:/www/api/public"
<Directory "D:/www/api/public">
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
Nginx 模式下改 server_name，但 phpEnv 默认用 Apache
phpEnv 安装时若选了 Nginx，那就要去 nginx/conf/nginx.conf 的 http 块里手动加 server 块。和 Apache 类似，每个域名一个 server，server_name 必须与 hosts 一致。
关键点：
-
root路径必须存在且可读，Windows 下路径建议用正斜杠，如D:/www/shop/public -
fastcgi_pass要匹配你当前启用的 PHP-FPM socket 或端口（常见为127.0.0.1:9000或unix:/tmp/php-cgi.sock） - 修改后必须执行
nginx -t测试语法，再nginx -s reload重载，不能只重启 phpEnv 进程
示例片段：
server {
listen 80;
server_name shop.test;
root D:/www/shop/public;
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;
include fastcgi.conf;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}
PHP 层几乎不用改，但要注意 $_SERVER['HTTP_HOST'] 可信度
PHP 代码本身不参与域名路由，它只接收 Web 服务器传来的请求。所以 $_SERVER['HTTP_HOST'] 值来自请求头，不是绝对可信的——尤其当 Apache/Nginx 没配好、或用了代理时，可能为空或错乱。
如果你在代码里做域名判断（比如切换数据库、加载不同配置），建议：
- 优先用 Web 服务器配置隔离逻辑，而不是 PHP 层 if-else
- 若必须用
$_SERVER['HTTP_HOST']，先过滤：用filter_var($_SERVER['HTTP_HOST'], FILTER_SANITIZE_URL)或白名单校验 - 避免直接拼接进 SQL 或文件路径，防止 LFI 或注入
常见坑：$_SERVER['SERVER_NAME'] 是 Apache 配置里的 ServerName，比 HTTP_HOST 更稳定，但仅限 Apache；Nginx 下该值不可靠，别依赖。
最常被忽略的一点：所有环节的域名字符串必须字节级一致——shop.test 和 www.shop.test 是两个域名，Shop.test 在某些系统里可能解析失败，shop.test.（末尾带点）在 hosts 里会被当作 FQDN 处理而失效。动手前，先用 ping shop.test 确认能通，再查 Apache/Nginx 日志看有没有 404 或 “No matching virtual host” 提示。
