nginx中文文档-ngx_http_fastcgi_module(R-T)

本文档包含以下指令:fastcgi_read_timeout、fastcgi_request_buffering、fastcgi_send_lowat、fastcgi_send_timeout、fastcgi_split_path_info、fastcgi_store、fastcgi_store_access、fastcgi_temp_file_write_size、fastcgi_temp_path

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服务器,请求就不能再传给下一个服务器了。

fastcgi_send_lowat

语法:fastcgi_send_lowat size
默认:fastcgi_send_lowat 0
上下文:http, server, location

如果指令设置了非零值,nginx将尝试通过kqueue方法的NOTE_LOWAT标志位或SO_SNDLOWAT socket选项降低连接到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
默认:—
上下文: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参数将保存文件到root和alias指令指定的相关路径下。off参数禁用保存文件功能。另外,文件名可以通过带变量的string参数显式的指定:
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;
如果定义了group或all的权限,user权限可以省略:
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服务器接收请求的缓冲区写入到临时文件功能时,限制一次写入到临时文件的数据大小。默认情况下,大小由fastcgi_buffer_size和fastcgi_buffers指令设置的两个缓冲区限制。临时文件大小最大值由fastcgi_max_temp_file_size指令设置。

fastcgi_temp_path

语法:fastcgi_temp_path path [level1 [level2 [level3]]]
默认:fastcgi_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参数