nginx fastcgi模块ngx_http_fastcgi_module详细解析、使用手册、完整翻译

ngx_http_fastcgi_module 模块容许将请求传递给 FastCGI 服务器。

 

示例配置

location / { fastcgi_pass localhost:9000; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$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_bind

-	说明
语法	fastcgi_bind address [transparent] | off;
默认	——
上下文	http、server、location
提示	该指令在 0.8.22 版本中出现

经过一个可选的端口（1.11.2）从指定的本地 IP 地址发出到 FastCGI 服务器的传出链接。参数值能够包含变量（1.3.12）。特殊值 off（1.3.12）取消从上层配置级别继承到的 fastcgi_bind 指令做用，这容许系统自动分配本地 IP 地址和端口。

transparent 参数（1.11.0）容许从非本地 IP 地址（例如来自客户端的真实 IP 地址）的到 FastCGI 服务器的传出链接：

fastcgi_bind $remote_addr transparent; 

为了使这个参数起做用，有必要以超级用户权限运行 nginx 工做进程，并配置内核路由来拦截来自 FastCGI 服务器的网络流量。

fastcgi_buffer_size

-	说明
语法	fastcgi_buffer_size size;
默认	fastcgi_buffer_size 4k|8k;
上下文	http、server、location

设置读取 FastCGI 服务器收到的响应的第一部分的缓冲区的 size（大小）。该部分一般包含一个小的响应头。默认状况下，缓冲区大小等于一个内存页。为 4K 或 8K，因平台而异。可是，它能够设置得更小。

fastcgi_buffering

-	说明
语法	fastcgi_buffering on | off;
默认	fastcgi_buffering on;
上下文	http、server、location
提示	该指令在 1.5.6 版本中出现

启用或禁用来自 FastCGI 服务器的响应缓冲。

当启用缓冲时，nginx 会尽量快地收到接收来自 FastCGI 服务器的响应，并将其保存到由 fastcgi_buffer_size 和 fastcgi_buffers 指令设置的缓冲区中。若是内存放不下整个响应，响应的一部分能够保存到磁盘上的临时文件中。写入临时文件由 fastcgi_max_temp_file_size 和 fastcgi_temp_file_write_size 指令控制。

当缓冲被禁用时，nginx 在收到响应时当即同步传递给客户端，不会尝试从 FastCGI 服务器读取整个响应。nginx 一次能够从服务器接收的最大数据量由 fastcgi_buffer_size 指令设置。

经过在 X-Accel-Buffering 响应头字段中经过 yes 或 no 也能够启用或禁用缓冲。可使用 fastcgi_ignore_headers 指令禁用此功能。

fastcgi_buffes

-	说明
语法	fastcgi_buffes number size;
默认	fastcgi_buffers 8 4k|8k;
上下文	http、server、location

设置单个链接从 FastCGI 服务器读取响应的缓冲区的 number （数量）和 size （大小）。默认状况下，缓冲区大小等于一个内存页。为 4K 或 8K，因平台而异。

fastcgi_busy_buffers_size

-	说明
语法	fastcgi_busy_buffers_size size;
默认	fastcgi_busy_buffers_size 8k|16k;
上下文	http、server、location

当启用 FastCGI 服务器响应缓冲时，限制缓冲区的总大小（size）在当响应还没有被彻底读取时可向客户端发送响应。同时，其他的缓冲区能够用来读取响应，若是须要的话，缓冲部分响应到临时文件中。默认状况下，size 受 fastcgi_buffer_size 和 fastcgi_buffers 指令设置的两个缓冲区的大小限制。

fastcgi_cache

-	说明
语法	fastcgi_cache zone | off;
默认	fastcgi_cache off;
上下文	http、server、location

定义用于缓存的共享内存区域。同一个区域能够在几个地方使用。参数值能够包含变量（1.7.9）。off 参数将禁用从上级配置级别继承的缓存配置。

fastcgi_cache_background_update

-	说明
语法	fastcgi_cache_background_update on | off;
默认	fastcgi_cache_background_update off;
上下文	http、server、location
提示	该指令在 1.11.10. 版本中出现

容许启动后台子请求来更新过时的缓存项，而过期的缓存响应则返回给客户端。请注意，有必要在更新时容许使用陈旧的缓存响应。

fastcgi_cache_bypass

-	说明
语法	fastcgi_cache_bypass string ...;
默认	——
上下文	http、server、location

定义不从缓存中获取响应的条件。若是字符串参数中有一个值不为空且不等于 0，则不会从缓存中获取响应：

fastcgi_cache_bypass $cookie_nocache $arg_nocache$arg_comment; fastcgi_cache_bypass $http_pragma $http_authorization; 

能够和 fastcgi_no_cache 指令一块儿使用。

fastcgi_cache_key

-	说明
语法	fastcgi_cache_key string;
默认	——
上下文	http、server、location

为缓存定义一个 key，例如：

fastcgi_cache_key localhost:9000$request_uri; 

fastcgi_cache_lock

-	说明
语法	fastcgi_cache_lock on | off;
默认	fastcgi_cache_lock off;
上下文	http、server、location
提示	该指令在 1.1.12 版本中出现

当启用时，同一时间只容许一个请求经过将请求传递给 FastCGI 服务器来填充 fastcgi_cache_key 指令标识的新缓存元素。同一缓存元素的其余请求将等待响应出如今缓存中，或等待此元素的缓存锁释放，直到 fastcgi_cache_lock_timeout 指令设置的时间。

fastcgi_cache_lock_age

-	说明
语法	fastcgi_cache_lock_age time;
默认	fastcgi_cache_lock_age 5s;
上下文	http、server、location
提示	该指令在 1.7.8 版本中出现

若是传递给 FastCGI 服务器的最后一个请求填充新缓存元素没能在指定的 time 内完成，则可能会有其余另外一个请求被传递给 FastCGI 服务器。

fastcgi_cache_lock_timeout

-	说明
语法	fastcgi_cache_lock_timeout time;
默认	fastcgi_cache_lock_timeout 5s;
上下文	http、server、location
提示	该指令在 1.1.12 版本中出现

设置 fastcgi_cache_lock 的超时时间。当时间到期时，请求将被传递给 FastCGI 服务器，可是，响应不会被缓存。

在 1.7.8 以前，响应能够被缓存。

fastcgi_cache_max_range_offset

-	说明
语法	fastcgi_cache_max_range_offset number;
默认	——
上下文	http、server、location
提示	该指令在 1.11.6 版本中出现

为 byte-range 请求设置字节偏移量。若是 range 超出 number（偏移量），range 请求将被传递给 FastCGI 服务器，而且不会缓存响应。

fastcgi_cache_methods

-	说明
语法	fastcgi_cache_methods GET | HEAD | POST ...;
默认	fastcgi_cache_methods GET HEAD;
上下文	http、server、location
提示	该指令在 0.7.59 版本中出现

若是此指令中存在当前客户端请求方法，那么响应将被缓存。虽然 GET 和 HEAD 方法老是在该列表中，但咱们仍是建议您明确指定它们。另请参阅 fastcgi_no_cache 指令。

fastcgi_cache_min_uses

-	说明
语法	fastcgi_cache_min_uses number;
默认	fastcgi_cache_min_uses 1;
上下文	http、server、location

设置指定数量（number）请求后响应将被缓存。

fastcgi_cache_path

-	说明
语法	fastcgi_cache_path path [levels=levels] [use_temp_path=on|off] keys_zone=name:size [inactive=time] [max_size=size] [manager_files=number] [manager_sleep=time] [manager_threshold=time] [loader_files=number] [loader_sleep=time] [loader_threshold=time] [purger=on|off] [purger_files=number] [purger_sleep=time] [purger_threshold=time];
默认	——
上下文	http

设置缓存的路径和其余参数。缓存数据存储在文件中。缓存中的 key 和文件名是代理 URL 通过 MD5 函数处理后获得的值。levels 参数定义缓存的层次结构级别：范围从 1 到 3，每一个级别可接受值为 1 或 2。例如，在如下配置中

fastcgi_cache_path /data/nginx/cache levels=1:2 keys_zone=one:10m; 

缓存中的文件名以下所示：

/data/nginx/cache/c/29/b7f54b2df7773722d382f4809d65029c

首先将缓存的响应写入临时文件，而后重命名该文件。从 0.8.9 版本开始，临时文件和缓存能够放在不一样的文件系统上。可是，请注意，在这种状况下，文件复制将要跨两个文件系统，而不是简单的重命名操做。所以建议，对于任何给定的位置，缓存和保存临时文件的目录都应该放在同一个文件系统上。临时文件的目录根据 use_temp_path 参数（1.7.10）设置。若是忽略此参数或将其设置为 on，则将使用由 fastcgi_temp_path 指令设置的目录。若是该值设置为 off，临时文件将直接放在缓存目录中。

另外，全部活跃的 key 和有关数据的信息都存储在共享内存区中，其名称和大小由 keys_zone 参数配置。一个兆字节的区域能够存储大约 8 千个 key。

做为商业订阅的一部分，共享内存区还存储其余缓存信息，所以，须要为相同数量的 key区域大小。例如，一个兆字节区域能够存储大约 4 千个 key。

在 inactive 参数指定的时间内未被访问的缓存数据将从缓存中删除。默认状况下，inactive 设置为 10 分钟。

“缓存管理器”（cache manager）进程监视的最大缓存大小由 max_size 参数设置。当超过此大小时，它将删除最近最少使用的数据。数据在由 manager_files、manager_threshold 和 manager_sleep 参数（1.11.5）配置下进行迭代删除。在一次迭代中，不会超过 manager_files 项被删除（默认为 100）。一次迭代的持续时间受到 manager_threshold 参数（默认为 200 毫秒）的限制。在每次迭代之间存在间隔时间，由 manager_sleep 参数（默认为 50 毫秒）配置。

开始后一分钟，“缓存加载器”（cache loader）进程被激活。它将先前存储在文件系统中的缓存数据的有关信息加载到缓存区中。加载也是在迭代中完成。在每一次迭代中，不会加载 loader_files 个项（默认状况下为 100）。此外，每一次迭代的持续时间受到 loader_threshold 参数的限制（默认状况下为 200 毫秒）。在迭代之间存在间隔时间，由 loader_sleep 参数（默认为 50 毫秒）配置。

此外，如下参数做为咱们商业订阅的一部分：

• purger=on|off 指明缓存清除程序（1.7.12）是否将与通配符键匹配的缓存条目从磁盘中删除。将该参数设置为 on（默认为 off）将激活“缓存清除器”（cache purger）进程，该进程不断遍历全部缓存条目并删除与通配符匹配的条目。

• purger_files=number 设置在一次迭代期间将要扫描的条目数量（1.7.12）。默认状况下，purger_files 设置为 10。

• purger_threshold=number 设置一次迭代的持续时间（1.7.12）。默认状况下，purger_threshold 设置为 50 毫秒。

• purger_sleep=number 在迭代之间设置暂停时间（1.7.12）。默认状况下，purger_sleep 设置为 50 毫秒。

在 1.7.三、1.7.7 和 1.11.10 版本中，缓存头格式发生了更改。升级到更新的 nginx 版本后，之前缓存的响应将视为无效。

fastcgi_cache_purge

-	说明
语法	fastcgi_cache_purge string ...;
默认	——
上下文	http、server、location
提示	该指令在 1.5.7 版本中出现

定义将请求视为缓存清除请求的条件。若是 string 参数中至少有一个不为空的值而且不等于“0”，则带有相应缓存键的缓存条目将被删除。经过返回 204（无内容）响应来表示操做成功。

若是清除请求的缓存键以星号（*）结尾，则将匹配通配符键的全部缓存条目从缓存中删除。可是，这些条目仍然保留在磁盘上，直到它们由于不活跃而被删除或被缓存清除程序（1.7.12）处理，或者客户端尝试访问它们。

配置示例：

fastcgi_cache_path /data/nginx/cache keys_zone=cache_zone:10m; map $request_method $purge_method { PURGE 1; default 0; } server { ... location / { fastcgi_pass backend; fastcgi_cache cache_zone; fastcgi_cache_key $uri; fastcgi_cache_purge $purge_method; } } 

该功能可做为咱们商业订阅的一部分。

fastcgi_cache_revalidate

-	说明
语法	fastcgi_cache_purge on | off;
默认	fastcgi_cache_revalidate off;
上下文	http、server、location
提示	该指令在 1.5.7 版本中出现

开启使用带有 If-Modified-Since 和 If-None-Match 头字段的条件请求对过时缓存项进行从新验证。

fastcgi_cache_use_stale

-	说明
语法	fastcgi_cache_use_stale error | timeout | invalid_header | updating | http_500 | http_503 | http_403 | http_404 | http_429 | off ...;
默认	fastcgi_cache_use_stale off;
上下文	http、server、location

当在与 FastCGI 服务器通讯期间发生错误时可使用陈旧的缓存响应。该指令的参数与 fastcgi_next_upstream 指令的参数相匹配。

若是没法选择使用 FastCGI 服务器处理请求，则 error 参数还容许使用陈旧的缓存响应。

此外，若是它当前正在更新，updating 参数容许使用陈旧的缓存响应。这样能够在更新缓存数据时最大限度地减小对 FastCGI 服务器的访问次数。

也能够在响应头中直接启用在响应变为陈旧的指定秒数后使用陈旧的缓存响应（1.11.10）。这比使用指令参数的优先级低。

• Cache-Control 头字段的 stale-while-revalidate 扩展容许使用陈旧的缓存响应当它正在更新。
• Cache-Control 头字段的 stale-if-error 扩展容许在发生错误时使用陈旧的缓存响应。

为了最大限度地减小填充新缓存元素时对 FastCGI 服务器的访问次数，可使用 fastcgi_cache_lock 指令。

fastcgi_cache_valid

-	说明
语法	fastcgi_cache_valid [code ...] time;
默认	——
上下文	http、server、location

为不一样的响应码设置缓存时间。例如：

fastcgi_cache_valid 200 302 10m; fastcgi_cache_valid 404 1m; 

对响应码为 200 和 302 的响应设置 10 分钟缓存，对响应码为 404 的响应设置为 1 分钟。

若是只指定缓存时间（time）：

fastcgi_cache_valid 5m; 

那么只缓存 200 、301 和 302 响应。

另外，能够指定 any 参数来缓存任何响应：

fastcgi_cache_valid 200 302 10m; fastcgi_cache_valid 301 1h; fastcgi_cache_valid any 1m; 

缓存参数也能够直接在响应头中设置。这比使用指令设置缓存时间具备更高的优先级。

• X-Accel-Expires 头字段以秒为单位设置响应的缓存时间。零值会禁用响应缓存。若是该值以 @ 前缀开头，则它会设置自 Epoch 以来的绝对时间（以秒为单位），最多能够缓存该时间段内的响应。
• 若是头中不包含 X-Accel-Expires 字段，则能够在头字段 Expires 或 Cache-Control 中设置缓存参数。
• 若是头中包含 Set-Cookie 字段，则不会缓存此类响应。
• 若是头中包含具备特殊值 * 的 Vary 字段，则这种响应不会被缓存（1.7.7）。若是头中包含带有另外一个值的 Vary 字段，考虑到相应的请求头字段（1.7.7），这样的响应将被缓存。

使用 fastcgi_ignore_headers 指令能够禁用一个或多个响应头字段的处理。

fastcgi_catch_stderr

-	说明
语法	fastcgi_catch_stderr string;
默认	——
上下文	http、server、location

设置一个字符串，用于在从 FastCGI 服务器接收到的响应的错误流中搜索匹配。若是找到该字符串，则认为 FastCGI 服务器返回无效响应。此时将启用 nginx 中的应用程序错误处理，例如：

location /php { fastcgi_pass backend:9000; ... fastcgi_catch_stderr "PHP Fatal error"; fastcgi_next_upstream error timeout invalid_header; } 

fastcgi_connect_timeout

-	说明
语法	fastcgi_connect_timeout time;
默认	fastcgi_connect_timeout 60s;
上下文	http、server、location

设置与 FastCGI 服务器创建链接的超时时间。须要注意的是，这个超时一般不能超过 75 秒。

fastcgi_force_ranges

-	说明
语法	fastcgi_force_ranges on | off;
默认	fastcgi_force_ranges off;
上下文	http、server、location
提示	该指令在 1.7.7 版本中出现

启用来自 FastCGI 服务器的缓存和未缓存响应的 byte-range 支持，忽略响应中的 Accept-Ranges 头字段。

fastcgi_hide_header

-	说明
语法	fastcgi_hide_header field;
默认	——
上下文	http、server、location

默认状况下，nginx 不会将 FastCGI 服务器响应中的头字段 Status 和 X-Accel-... 传递给客户端。fastcgi_hide_header 指令设置不会被传递的附加字段。可是，若是须要容许传递字段，则可使用 fastcgi_pass_header 指令。

fastcgi_ignore_client_abort

-	说明
语法	fastcgi_ignore_client_abort on | off;
默认	fastcgi_ignore_client_abort off;
上下文	http、server、location

肯定当客户端关闭链接而不等待响应时是否关闭与 FastCGI 服务器的链接。

fastcgi_ignore_headers

-	说明
语法	fastcgi_ignore_headers field ...;
默认	——
上下文	http、server、location

禁止处理来自 FastCGI 服务器的某些响应头字段。如下字段将被忽略：X-Accel-Redirect、X-Accel-Expires、X-Accel-Limit-Rate（1.1.6）、X-Accel-Buffering（1.1.6）、X-Accel-Charset（1.1.6）、Expires、Cache-Control、Set-Cookie（0.8.44）和 Vary（1.7.7）。

若是未禁用，则处理这些头字段产生如下效果：

• X-Accel-Expires、Expires、Cache-Control、Set-Cookie 和 Vary 设置响应缓存的参数
• X-Accel-Redirect 执行内部重定向到指定的 URI
• X-Accel-Limit-Rate 设置响应的传送速率限制回客户端
• X-Accel-Buffering 启用或禁用缓冲响应
• X-Accel-Charset 设置所需的响应字符集

fastcgi_index

-	说明
语法	fastcgi_index name;
默认	——
上下文	http、server、location

在 $fastcgi_script_name 变量的值中设置一个文件名，该文件名追加到 URL 后面并以一个斜杠结尾。例如如下设置

fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name; 

和 /page.php 请求，SCRIPT_FILENAME 参数将等于 /home/www/scripts/php/page.php，而且 / 请求将等于 /home/www/scripts/php/index.php。

fastcgi_intercept_errors

-	说明
语法	fastcgi_intercept_errors on | off;
默认	fastcgi_intercept_errors off;
上下文	http、server、location

肯定当 FastCGI 服务器响应码大于或等于 300 时是否应传递给客户端，或者拦截并重定向到 nginx 以便使用 error_page 指令进行处理。

fastcgi_keep_conn

-	说明
语法	fastcgi_keep_conn on | off;
默认	fastcgi_keep_conn off;
上下文	http、server、location
提示	该指令在 1.1.4 版本中出现

默认状况下，FastCGI 服务器将在发送响应后当即关闭链接。可是，若是当此指令设置为 on 值，则 nginx 将指示 FastCGI 服务器保持链接处于打开状态。这对保持 FastCGI 服务器链接 keepalive 尤其重要。

fastcgi_limit_rate

-	说明
语法	fastcgi_limit_rate rate;
默认	fastcgi_limit_rate 0;
上下文	http、server、location
提示	该指令在 1.7.7 版本中出现

限制读取 FastCGI 服务器响应的速度。rate 以每秒字节数为单位。零值则禁用速率限制。该限制是针对每一个请求设置的，所以若是 nginx 同时打开两个链接到 FastCFI 服务器的链接，则总体速率将是指定限制的两倍。该限制仅在启用缓冲来自 FastCGI 服务器的响应时才起做用。

fastcgi_max_temp_file_size

-	说明
语法	fastcgi_max_temp_file_size size;
默认	fastcgi_max_temp_file_size 1024m;
上下文	http、server、location

当启用缓冲](#fastcgi_buffering)来自 FastCGI 服务器的响应时而且整个响应不适合由 {fastcgi_buffer_size 和 fastcgi_buffers 指令设置的缓冲时，响应的一部分能够保存到临时文件中。该指令用于设置临时文件的最大大小（size）。一次写入临时文件的数据大小由 fastcgi_temp_file_write_size 指令设置。

零值将禁用临时文件响应缓冲。

此限制不适用于将要缓存或存储在磁盘上的响应。

fastcgi_next_upstream

-	说明
语法	fastcgi_next_upstream error | timeout | invalid_header | http_500 | http_503 | http_403 | http_404 | http_429 | non_idempotent | off ...；
默认	fastcgi_next_upstream error timeout;
上下文	http、server、location

指定在哪些状况下请求应传递给下一台服务器：

• erorr

  在与服务器创建链接、传递请求或读取响应头时发生错误

• timeout

  在与服务器创建链接、传递请求或读取响应头时发生超时

• invalid_header

  服务器返回了空的或无效的响应

• http_500

  服务器返回 500 响应码

• http_503

  服务器返回 503 响应码

• http_403

  服务器返回 403 响应码

• http_404

  服务器返回 404 响应码

• http_429

  服务器返回 429 响应码（1.11.13）

• non_idempotent

  一般，若是请求已发送到上游服务器（1.9.13），则具备非幂等方法（POST、LOCK、PATCH）的请求不会传递到下一个服务器，使这个选项明确容许重试这样的请求

• off

  禁用将请求传递给下一个服务器

咱们应该记住，只有在没有任何内容发送给客户端的状况下，才能将请求传递给下一台服务器。也就是说，若是在响应传输过程当中发生错误或超时，要修复是不可能的。

该指令还定义了与服务器进行通讯的不成功尝试。erorr、timeout 和 invalid_header 的状况老是被认为是不成功的尝试，即便它们没有在指令中指定。只有在指令中指定了 http_500、http_503 和 http_429 的状况下，它们才被视为不成功尝试。http_403 和 http_404 的状况永远不会被视为不成功尝试。

将请求传递给下一台服务器可能受到尝试次数和时间的限制。

fastcgi_next_upstream_timeout

-	说明
语法	fastcgi_next_upstream_timeout time;
默认	fastcgi_next_upstream_timeout 0;
上下文	http、server、location
提示	该指令在 1.7.5 版本中出现

限制请求能够传递到下一个服务器的时间。0 值关闭此限制。

fastcgi_next_upstream_tries

-	说明
语法	fastcgi_next_upstream_tries number;
默认	fastcgi_next_upstream_tries 0;
上下文	http、server、location
提示	该指令在 1.7.5 版本中出现

限制将请求传递到下一个服务器的尝试次数。0 值关闭此限制。

fastcgi_no_cache

-	说明
语法	fastcgi_no_cache string ...;
默认	——
上下文	http、server、location

定义响应不会保存到缓存中的条件。若是 string 参数中有一个值不为空且不等于 0，则不会保存响应：

fastcgi_no_cache $cookie_nocache $arg_nocache$arg_comment; fastcgi_no_cache $http_pragma $http_authorization; 

能够与 fastcgi_cache_bypass 指令一块儿使用。

fastcgi_param

-	说明
语法	fastcgi_param parameter value [if_not_empty];
默认	——
上下文	http、server、location

设置应传递给 FastCGI 服务器的 parameter (参数)。该值能够包含文本、变量及其组合。当且仅当在当前级别上没有定义 fastcgi_param 指令时，这些指令才从前一级继承。

如下示例展现了 PHP 的最小要求配置：

fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name; fastcgi_param QUERY_STRING $query_string; 

SCRIPT_FILENAME 参数在 PHP 中用于肯定脚本名称，QUERY_STRING 参数用于传递请求参数。

对于处理 POST 请求的脚本，还须要如下三个参数：

fastcgi_param REQUEST_METHOD $request_method; fastcgi_param CONTENT_TYPE $content_type; fastcgi_param CONTENT_LENGTH $content_length; 

若是 PHP 使用了 --enable-force-cgi-redirect 配置参数构建，则还应该使用值 200 传递 REDIRECT_STATUS 参数：

fastcgi_param REDIRECT_STATUS 200; 

若是该指令是经过 if_not_empty（1.1.11）指定的，那么只有当它的值不为空时，这个参数才会被传递给服务器：

fastcgi_param HTTPS $https if_not_empty; 

fastcgi_pass

-	说明
语法	fastcgi_pass address;
默认	——
上下文	http、server、location

设置 FastCGI 服务器的地址。该地址能够指定为域名或 IP 地址，以及端口：

fastcgi_pass localhost:9000; 

或者做为 UNIX 域套接字路径：

fastcgi_pass unix:/tmp/fastcgi.socket; 

若是域名解析为多个地址，则全部这些地址都将以循环方式使用。另外，地址能够被指定为服务器组。

参数值能够包含变量。在这种状况下，若是地址被指定为域名，则在所描述的服务器组中搜索名称，若是未找到，则使用解析器来肯定。

fastcgi_pass_header

-	说明
语法	fastcgi_pass_header field;
默认	——
上下文	http、server、location

容许从 FastCGI 服务器向客户端传递隐藏禁用的头字段。

fastcgi_pass_request_body

-	说明
语法	fastcgi_pass_request_body on | off;
默认	fastcgi_pass_request_body on;
上下文	http、server、location

指示是否将原始请求主体传递给 FastCGI 服务器。另请参阅 fastcgi_pass_request_headers 指令。

fastcgi_pass_request_headers

-	说明
语法	fastcgi_pass_request_headers on | off;
默认	fastcgi_pass_request_headers on;
上下文	http、server、location

指示原始请求的头字段是否传递给 FastCGI 服务器。另请参阅 fastcgi_pass_request_body 指令。

fastcgi_read_timeout

-	说明
语法	fastcgi_read_timeout time;
默认	fastcgi_read_timeout 60s;
上下文	http、server、location

定义从 FastCGI 服务器读取响应的超时时间。超时设置在两次连续的读操做之间，而不是传输整个响应的过程。若是 FastCGI 服务器在此时间内没有发送任何内容，则链接将被关闭。

fastcgi_request_buffering

-	说明
语法	fastcgi_request_buffering on | off;
默认	fastcgi_request_buffering on;
上下文	http、server、location
提示	该指令在 1.7.11 版本中出现

启用或禁用客户端请求体缓冲。

启用缓冲时，在将请求发送到 FastCGI 服务器以前，将从客户端读取整个请求体。

当缓冲被禁用时，请求体在收到时当即发送到 FastCGI 服务器。在这种状况下，若是 nginx 已经开始发送请求体，则请求不能传递到下一个服务器。

fastcgi_send_lowat

-	说明
语法	fastcgi_send_lowat size;
默认	fastcgi_send_lowat 0;
上下文	http、server、location

若是指令设置为非零值，则 nginx 将尝试经过使用 kqueue 方式的 NOTE_LOWAT 标志或 SO_SNDLOWAT 套接字选项，以指定的 size（大小）来最小化传出链接到 FastCGI 服务器上的发送操做次数。

该指令在 Linux、Solaris 和 Windows 上被忽略。

fastcgi_send_timeout

-	说明
语法	fastcgi_send_timeout time;
默认	fastcgi_send_timeout 60s;
上下文	http、server、location

设置向 FastCGI 服务器发送请求的超时时间。超时设置在两次连续写入操做之间，而不是传输整个请求的过程。若是 FastCGI 服务器在此时间内没有收到任何内容，则链接将关闭。

fastcgi_split_path_info

-	说明
语法	fastcgi_split_path_info regex;
默认	fastcgi_send_timeout 60s;
上下文	location

定义一个捕获 $fastcgi_path_info 变量值的正则表达式。正则表达式应该有两个捕获：第一个为 $fastcgi_script_name 变量的值，第二个为 $fastcgi_path_info 变量的值。例如如下设置

location ~ ^(.+\.php)(.*)$ { fastcgi_split_path_info ^(.+\.php)(.*)$; fastcgi_param SCRIPT_FILENAME /path/to/php$fastcgi_script_name; fastcgi_param PATH_INFO $fastcgi_path_info; 

和 /show.php/article/0001 请求，SCRIPT_FILENAME 参数等于 /path/to/php/show.php，而且 PATH_INFO 参数等于 /article/0001。

fastcgi_store

-	说明
语法	fastcgi_store on | off | string;
默认	fastcgi_store off;
上下文	http、server、location

启用将文件保存到磁盘。on 参数将文件保存为与指令 alias 或 root 相对应的路径。off 参数禁用保存文件。另外，可使用带变量的字符串显式设置文件名：

fastcgi_store /data/www$original_uri; 

文件的修改时间根据收到的 Last-Modified 响应头字段设置。首先将响应写入临时文件，而后重命名该文件。从 0.8.9 版本开始，临时文件和持久存储能够放在不一样的文件系统上。可是，请注意，在这种状况下，文件将跨两个文件系统进行复制，而不是简单地进行重命名操做。所以建议，对于任何给定位置，保存的文件和由 fastcgi_temp_path 指令设置的保存临时文件的目录都放在同一个文件系统上。

该指令可用于建立静态不可更改文件的本地副本，例如：

location /images/ { root /data/www; error_page 404 = /fetch$uri; } location /fetch/ { internal; fastcgi_pass backend:9000; ... fastcgi_store on; fastcgi_store_access user:rw group:rw all:r; fastcgi_temp_path /data/temp; alias /data/www/; } 

fastcgi_store_access

-	说明
语法	fastcgi_store_access users:permissions ...;
默认	fastcgi_store_access user:rw;
上下文	http、server、location

为新建立的文件和目录设置访问权限，例如：

fastcgi_store_access user:rw group:rw all:r; 

若是指定了任何组或全部访问权限，则能够省略用户权限

fastcgi_store_access group:rw all:r; 

fastcgi_temp_file_write_size

-	说明
语法	fastcgi_temp_file_write_size size;
默认	fastcgi_temp_file_write_size 8k	16k;
上下文	http、server、location

设置当开启缓冲 FastCGI 服务器响应到临时文件时，限制写入临时文件的数据 size（大小）。默认状况下，大小受 fastcgi_buffer_size 和 fastcgi_buffers 指令设置的两个缓冲区限制。临时文件的最大大小由 fastcgi_max_temp_file_size 指令设置。

fastcgi_temp_path

-	说明
语法	fastcgi_temp_path path [level1 [level2 [level3]]];
默认	astcgi_temp_path fastcgi_temp;
上下文	http、server、location

定义一个目录，用于存储从 FastCGI 服务器接收到的数据的临时文件。指定目录下最多可有三级子目录。例如如下配置

fastcgi_temp_path /spool/nginx/fastcgi_temp 1 2; 

临时文件以下所示：

/spool/nginx/fastcgi_temp/7/45/00000123457 

另请参见 fastcgi_cache_path 指令的 use_temp_path 参数。

 

传参到 FastCGI 服务器

HTTP 请求头字段做为参数传递给 FastCGI 服务器。在做为 FastCGI 服务器运行的应用程序和脚本中，这些参数一般做为环境变量提供。例如，User-Agent 头字段做为 HTTP_USER_AGENT 参数传递。除 HTTP 请求头字段外，还可使用 fastcgi_param 指令传递任意参数。

 

内嵌变量

ngx_http_fastcgi_module 模块支持在 fastcgi_param 指令设置参数时使用内嵌变量：

• $fastcgi_script_name

  请求 URI，或者若是 URI 以斜杠结尾，则请求 URI 的索引文件名称由 fastcgi_index 指令配置。该变量可用于设置 SCRIPT_FILENAME 和 PATH_TRANSLATED 参数，以肯定 PHP 中的脚本名称。例如，对 /info/ 请求的指令设置

  fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name; 

  SCRIPT_FILENAME 参数等于 /home/www/scripts/php/info/index.php。

  使用 fastcgi_split_path_info 指令时，$fastcgi_script_name 变量等于指令设置的第一个捕获值。

• $fastcgi_path_info

  由 fastcgi_split_path_info 指令设置的第二个捕获值。这个变量能够用来设置 PATH_INFO 参数。

官方文档：

http://nginx.org/en/docs/http/ngx_http_fastcgi_module.html