Roots/Trellis项目中Nginx与PHP的SERVER_NAME传递问题解析

在Roots/Trellis项目部署WordPress多域名站点时，开发者可能会遇到一个隐蔽但影响较大的配置问题：当站点配置了多个规范域名(canonical domains)时，PHP环境中的$_SERVER['SERVER_NAME']变量无法正确获取当前请求的域名，而是返回Nginx配置中第一个列出的服务器名称。

问题本质分析

这个问题源于Nginx与PHP-FPM之间的参数传递机制。在默认配置中，Nginx通过fastcgi_param指令将$server_name变量传递给PHP，而$server_name在Nginx中的行为特性导致了这个问题：

1. $server_name始终返回Nginx配置中server_name指令列出的第一个域名
2. 即使请求的是其他规范域名，这个值也不会变化
3. 这与开发者期望的"获取当前请求的实际域名"行为不符

技术细节对比

Nginx提供了多个与主机名相关的变量，但它们的含义和用途各不相同：

• $host变量：动态反映实际请求中的主机名，优先级顺序为：
  1. 请求行中的主机名
  2. "Host"请求头字段
  3. 匹配请求的服务器名
• $http_host变量：直接对应HTTP请求头中的"Host"值
• $server_name变量：静态返回Nginx配置中定义的第一个服务器名

问题影响范围

这个配置问题会导致多个功能异常：

1. WordPress多站点网络中的域名识别错误
2. 依赖$_SERVER['SERVER_NAME']的插件功能异常（如某些重定向插件）
3. 动态生成的链接可能指向错误的规范域名
4. 缓存机制可能无法正确区分不同域名的内容

解决方案实施

正确的解决方案是修改Nginx配置，在包含默认的fastcgi_params文件后，显式覆盖SERVER_NAME参数：

include fastcgi_params;
fastcgi_param SERVER_NAME $host;

这种做法的优势在于：

1. 保留了默认配置文件的完整性
2. 明确覆盖了特定的参数设置
3. 确保在所有环境下都能获取正确的请求域名
4. 与Nginx的变量处理机制保持一致

最佳实践建议

对于Roots/Trellis项目用户，在处理多域名配置时还应注意：

1. 主配置文件中应明确定义所有规范域名
2. 重定向规则应基于$host而非$server_name
3. WordPress配置中应正确设置WP_HOME和WP_SITEURL
4. 定期验证各域名的参数传递是否正常

这个问题的修复虽然只是简单的一行配置变更，但对于确保多域名站点的正常运行至关重要，特别是对于那些依赖正确域名识别的功能和插件。