Nginx模块参考手册：FastCGI模块(FastCGI)(3)

fastcgi_pass

语法：fastcgi_pass fastcgi-server
默认值：none
使用字段：http, server, location
指定FastCGI服务器监听端口与地址，可以是本机或者其它：

fastcgi_pass   localhost:9000;

使用Unix socket:

fastcgi_pass   unix:/tmp/fastcgi.socket;

同样可以使用一个upstream字段名称：

upstream backend  {
  server   localhost:1234;
}
 
fastcgi_pass   backend;

fastcgi_pass_header

语法：fastcgi_pass_header name
默认值：none
使用字段：http, server, location

fastcgi_read_timeout

语法：fastcgi_read_timeout time
默认值：fastcgi_read_timeout 60
使用字段：http, server, location
前端FastCGI服务器的响应超时时间，如果有一些直到它们运行完才有输出的长时间运行的FastCGI进程，或者在错误日志中出现前端服务器响应超时错误，可能需要调整这个值。

fastcgi_redirect_errors

语法：fastcgi_redirect_errors on|off
指令重命名为fastcgi_intercept_errors。

fastcgi_send_timeout

语法：fastcgi_send_timeout time
默认值：fastcgi_send_timeout 60
使用字段：http, server, location
指令为上游服务器设置等待一个FastCGI进程的传送数据时间，如果有一些直到它们运行完才有输出的长时间运行的FastCGI进程，那么可以修改这个值，如果你在上游服务器的error log里面发现一些超时错误，那么可以恰当的增加这个值。
指令指定请求服务器的超时时间，指完成了2次握手的连接，而不是完整的连接，如果在这期间客户端没有进行数据传递，那么服务器将关闭这个连接。

fastcgi_split_path_info

语法：fastcgi_split_path_info regex
使用字段：location
可用版本：0.7.31以上
这个指令允许为CGI specification设置SCRIPT_FILENAME (SCRIPT_NAME)和PATH_INFO变量。正则包含两个组:

• 处理请求的脚本路径–对应$fastcgi_script_name。
   
• 脚本参数的值–对应$fastcgi_path_info。
   

下面是一个示例，脚本show.php接受字符串参数： article/0001，下面的例子将处理路径妥善分裂：

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

请求”/show.php/article/0001”的参数SCRIPT_FILENAME将设置为”/path/to/php/show.php”，参数PATH_INFO为”/article/0001”。

fastcgi_store

语法：fastcgi_store [on | off | path]
默认值：fastcgi_store off
使用字段：http, server, location
制定了存储前端文件的路径，参数on指定了将使用root和alias指令相同的路径，off禁止存储，此外，参数中可以使用变量使路径名更明确：

fastcgi_store   /data/www$original_uri;

应答中的”Last-Modified”头将设置文件的最后修改时间，为了使这些文件更加安全，可以将其在一个目录中存为临时文件，使用fastcgi_temp_path指令。
这个指令可以用在为那些不是经常改变的后端动态输出创建本地拷贝的过程中。如：

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

fastcgi_store并不是缓存，某些需求下它更像是一个镜像。

fastcgi_store_access

语法：fastcgi_store_access users:permissions [users:permission …]
默认值：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_path

语法：fastcgi_temp_path path [level1 [level2 [level3]]]
默认值：fastcgi_temp_path fastcgi_temp
使用字段：http, server, location
指令指定存储从别的服务器传送来的数据临时文件路径，同样可以指定三级目录已经哈希存储，level的值指定为哈希设置多少标记，例如，在下列配置中：

fastcgi_temp_path  /spool/nginx/fastcgi_temp 1 2;

临时文件类似如下：

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

传送到FastCGI服务器的相关参数

请求头是以参数的形式传送到FastCGI服务器，以具体应用和脚本运行在FastCGI服务器上，这些参数通常以环境变量的形式取得，例如，”User-agent”头以HTTP_USER_AGENT参数传递，除此之外还有一些其他的http头，都可以用fastcgi_param指令自由传递。

变量

$fastcgi_script_name

这个变量等于一个以斜线结尾的请求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”。