配置Nginx+FPM环境下老旧PHP网站遇FastCGI报错求排查方案

Hey there, let's work through this issue together. I've run into similar PHP notice errors on legacy sites running Nginx+PHP-FPM before, so here's a structured approach to fix it:

1. 先搞懂错误的本质 #

The "Undefined index: HTTP_REFERER" notice is not an Nginx problem — it's PHP telling you that your code is trying to access the $_SERVER['HTTP_REFERER'] variable, but that variable doesn't exist in the current request.

HTTP_REFERER is an optional request header: it only gets sent when a user clicks a link from another page. If someone types your URL directly into the address bar, uses a bookmark, or visits from a client that blocks referer headers (like privacy-focused browsers), this variable will be missing entirely.

Your echo $path line is triggering this because $path is almost certainly defined using $_SERVER['HTTP_REFERER'] somewhere in your code, without checking if the variable exists first.

2. 定位问题代码 #

First, find where $path is being set. Add a quick debug snippet right before the echo $path line to confirm:

// Debug check
var_dump(isset($_SERVER['HTTP_REFERER'])); // Will output bool(false) when the header is missing
var_dump($path); // Will show NULL or an undefined value if the variable relies on HTTP_REFERER

This will confirm that $path is dependent on the missing HTTP_REFERER variable.

3. Fix the PHP code (the root solution) #

Legacy PHP code often skips variable existence checks. Update the code that defines $path to handle cases where HTTP_REFERER is missing:

• If $path is directly assigned from HTTP_REFERER:

  // Replace your existing assignment with this
  $path = isset($_SERVER['HTTP_REFERER']) ? $_SERVER['HTTP_REFERER'] : '';
  // If your server runs PHP 7 or newer, you can use the cleaner null coalescing operator:
  $path = $_SERVER['HTTP_REFERER'] ?? '';
  

• If $path uses HTTP_REFERER in a more complex logic, add a check before accessing the variable to avoid the notice.

4. Tweak logging (optional, to clean up Nginx logs) #

The "FastCGI sent in stderr" message is just Nginx forwarding PHP's notice output to its own error log. If you want to stop seeing these notices in Nginx logs:

• Edit your php.ini file and adjust the error reporting level:

  error_reporting = E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED
  

• If you can't modify the global php.ini, add this line at the top of your PHP script (or in a shared config file):

  error_reporting(E_ALL ^ E_NOTICE);
  

• Note: Disabling notices hides the symptom, not the problem. It's better to fix the code first, then adjust logging if needed.

5. Verify Nginx variable passing (optional sanity check) #

Double-check your Nginx config to ensure it's correctly forwarding the referer header to PHP-FPM. Look for this line in your fastcgi configuration block:

fastcgi_param HTTP_REFERER $http_referer;

Even if this is set correctly, Nginx will pass an empty value (not an undefined variable) when the client doesn't send a referer. So this isn't the root cause, but it's good to confirm it's configured properly.

内容的提问来源于stack exchange，提问作者Klevin Kona