Nginx自定义头在PHP $_SERVER缺失但Laravel request()存在及IP设置疑问

1. 这种设置服务器真实IP的方式是否属于最佳实践？ #

完全不是最佳实践，而且你的配置方向本身就错了：

• 首先，add_header是nginx给客户端返回响应时添加的头，不是nginx向外发起请求时携带的头，所以这个配置根本无法让外部服务器拿到你指定的IP。
• 硬编码固定IP（1.2.3.4）也非常不灵活，一旦宿主机IP变动（比如动态公网IP、服务器迁移），配置直接失效。

针对你的场景，正确的做法分两种情况：

场景A：Laravel应用向外部服务器发请求，希望外部拿到宿主机IP #

• 若用Docker默认桥接网络，容器向外发请求时会自动通过NAT转换成宿主机IP，外部服务器应该能直接拿到，不需要额外配置；如果没拿到，检查Docker网络模式和宿主机的NAT规则。
• 若必须手动传递真实IP，别用自定义头，用行业标准的X-Forwarded-For头，并且通过环境变量配置IP（避免硬编码）。比如在Laravel的HTTP请求中添加：

  $response = Http::withHeaders([
      'X-Forwarded-For' => env('APP_HOST_IP')
  ])->get('外部服务器地址');
  

  然后在.env中设置APP_HOST_IP=你的宿主机真实IP。

场景B：外部用户访问你的Laravel应用，希望Laravel拿到用户真实IP（而非nginx容器IP） #

• 在nginx配置中用fastcgi_param给php-fpm传递用户真实IP，而不是add_header：

  location ~ \.php$ {
      # 其他fastcgi配置...
      fastcgi_param REMOTE_ADDR $remote_addr;
      fastcgi_param HTTP_X_FORWARDED_FOR $remote_addr;
  }
  

• 然后在Laravel的config/trustedproxy.php中添加nginx容器的IP到信任列表，Laravel会自动识别用户真实IP，不需要手动修改$_SERVER['REMOTE_ADDR']。

2. 为何$_SERVER中没有该键，而Laravel的request()函数中存在？ #

核心是PHP和Laravel处理请求头的规则不同：

• PHP的$_SERVER会标准化请求头名称：所有字母大写，把横线-替换成下划线_，再加上HTTP_前缀。比如请求头X-SERVER-REAL-IP会被转换成$_SERVER['HTTP_X_SERVER_REAL_IP']，你直接找$_SERVER['X-SERVER-REAL-IP']肯定找不到。
• Laravel的request()->header()做了兼容处理：它会忽略大小写、横线和下划线的差异，不管你用X-SERVER-REAL-IP还是x_server_real_ip都能匹配到对应的请求头，所以能拿到值。

另外要提醒：你用add_header添加的是响应头，正常请求中不会包含这个头。如果确实能通过request()拿到，大概率是测试时手动给请求加了这个头，或者混淆了请求头和响应头。

内容的提问来源于stack exchange，提问作者M a m a D