用 NGINX 打造高性能 FastCGI 加速 `ngx_http_fastcgi

用 NGINX 打造高性能 FastCGI 加速 `ngx_http_fastcgi_module`

news2025/5/11 16:29:07

一、安装与启用

# 在编译 NGINX 源码时加上：
./configure --with-http_fastcgi_module
make && sudo make install

# 或确保你使用的二进制已内置（大多数发行版都默认包含）
nginx -V | grep fastcgi

二、基础转发配置

http {
  server {
    listen 80;
    server_name example.com;

    root /var/www/html;

    location ~ \.php$ {
      fastcgi_pass            unix:/run/php/php8.1-fpm.sock;
      fastcgi_index           index.php;
      include                 fastcgi_params;

      fastcgi_param SCRIPT_FILENAME  $document_root$fastcgi_script_name;
      fastcgi_param QUERY_STRING     $query_string;
      fastcgi_param REQUEST_METHOD   $request_method;
      fastcgi_param CONTENT_TYPE     $content_type;
      fastcgi_param CONTENT_LENGTH   $content_length;
      fastcgi_param REDIRECT_STATUS  200;
    }
  }
}

fastcgi_pass：指定后端地址（TCP 或 Unix Socket）。
fastcgi_index：URI 以 / 结尾时，追加该脚本名。
fastcgi_param：设置环境变量传给后端。

三、缓冲与临时文件

3.1.打开／关闭缓冲

fastcgi_buffering on;   # 默认 on
# or
fastcgi_buffering off;  # 实时转发，不做缓冲

3.2.缓冲区大小与数量

fastcgi_buffer_size        16k;        # 初始 header 缓冲
fastcgi_buffers            8 32k;      # 读 body 时的内存缓冲
fastcgi_busy_buffers_size  64k;        # 正在向客户端发送时可占用的内存

3.3.临时文件设置

fastcgi_temp_path       /var/cache/nginx/fastcgi_temp 1 2;  
fastcgi_max_temp_file_size 512m;
fastcgi_temp_file_write_size 32k;

fastcgi_temp_path：超出内存缓冲时写入磁盘。
fastcgi_max_temp_file_size：允许写入最大临时文件大小（0=禁用写盘）。
fastcgi_temp_file_write_size：每次写盘的块大小。

四、二级缓存（FastCGI Cache）

4.1.定义缓存路径

fastcgi_cache_path /var/cache/nginx/php_cache levels=1:2 \
    keys_zone=php_cache:128m inactive=30m max_size=5g;

4.2.在 Location 中启用

location ~ \.php$ {
  fastcgi_cache           php_cache;
  fastcgi_cache_key       $scheme$host$request_uri;
  fastcgi_cache_valid     200 301 302 10m;
  fastcgi_cache_valid     404      1m;
  fastcgi_cache_methods   GET HEAD;
}

4.3.背景更新与过期使用

fastcgi_cache_use_stale       error timeout updating http_500 http_503;
fastcgi_cache_background_update on;

use_stale updating：当条目在后台更新时，仍可返回旧缓存。
background_update：只触发后台刷新，不阻塞用户请求。

4.4.缓存锁

fastcgi_cache_lock          on;
fastcgi_cache_lock_timeout  5s;
fastcgi_cache_lock_age      5s;

避免缓存击穿：同一缓存键仅一条请求打到后端，其它请求排队等待或超时。

五、超时与失败切换

fastcgi_connect_timeout   5s;
fastcgi_read_timeout      60s;
fastcgi_send_timeout      60s;

fastcgi_next_upstream     error timeout invalid_header http_500 http_503;
fastcgi_next_upstream_tries   3;
fastcgi_next_upstream_timeout 30s;

连接/读取/发送超时：防止挂起。
fastcgi_next_upstream：列出哪些场景下切换后端。
tries / timeout：限制切换次数与时长。

六、参数传递与路径拆分

6.1.PATH_INFO 支持

location ~ ^(.+\.php)(/.*)$ {
  fastcgi_split_path_info  ^(.+\.php)(/.*)$;
  fastcgi_param SCRIPT_FILENAME  $document_root$1;
  fastcgi_param PATH_INFO        $2;
  include fastcgi_params;
  fastcgi_pass   php-fpm;
}

fastcgi_split_path_info：正则拆分 URI，支持框架路由。

七、动态存储（fastcgi_store）

location ~ \.php$ {
  # 反向缓存／保存原始文件
  fastcgi_store             on;
  fastcgi_store_access      user:rw group:r all:r;
  fastcgi_temp_path         /var/cache/nginx/php_store_temp;
  alias                     /var/www/html/;
}

fastcgi_store：将后端响应写入本地文件系统，适合缓存不变资源。

八、限速与连接管理

fastcgi_limit_rate         100k;     # 每请求最大读取速率
fastcgi_socket_keepalive   on;       # 与后端开启 TCP keepalive
fastcgi_bind               192.168.1.10 transparent;