nginx FastCGI模块（FastCGI）配置

http://www.howtocn.org/nginx:nginx%E6%A8%A1%E5%9D%97%E5%8F%82%E8%80%83%E6%89%8B%E5%86%8C%E4%B8%AD%E6%96%87%E7%89%88:standardhttpmodules:fastcgi#fastcgi%E6%A8%A1%E5%9D%97_fastcgi

nginx官方文档：http://nginx.org/en/docs/http/ngx_http_fastcgi_module.html

摘要

这个模块允许nginx同FastCGI协同工作，并且控制哪些参数将被安全传递。
例：

[plain] view plain copy

  1. location / {
  2. fastcgi_pass   localhost:9000;
  3. fastcgi_index  index.php;
  4. fastcgi_param  SCRIPT_FILENAME  /home/www/scripts/php$fastcgi_script_name;
  5. fastcgi_param  QUERY_STRING     $query_string;
  6. fastcgi_param  REQUEST_METHOD   $request_method;
  7. fastcgi_param  CONTENT_TYPE     $content_type;
  8. fastcgi_param  CONTENT_LENGTH   $content_length;
  9. }


一个在缓存中的实例：


[plain] view plain copy



    

  1. http {
    2. 

  2. fastcgi_cache_path   /path/to/cache  levels=1:2
    3. 

  3. keys_zone=NAME:10m
    4. 

  4. inactive=5m;
    5. 

  5. server {
    6. 

  6. location / {
    7. 

  7. fastcgi_pass    http://127.0.0.1:9000;
    8. 

  8. fastcgi_cache   NAME;
    9. 

  9. fastcgi_cache_valid   200 302  1h;
    10. 

  10. fastcgi_cache_valid   301      1d;
    11. 

  11. fastcgi_cache_valid   any      1m;
    12. 

  12. fastcgi_cache_min_uses  1;
    13. 

  13. fastcgi_cache_use_stale error  timeout invalid_header http_500;
    14. 

  14. }
    15. 

  15. }
    16. 

  16. }
    17. 






0.7.48以后，缓存遵循后端服务器的Cache-Control, Expires等，0.7.66版本以后，”Cache-Control:“private”和”no-store”头同样被遵循。


指令



fastcgi_bind


语法：fastcgi_bind address
默认值：none
使用字段：http, server, location 
可用版本：大于0.8.22
示例：


fastcgi_bind  192.168.1.1;


指令在调用connect()函数之前将解析每个上游socket到一个本地地址，可以使用在主机拥有多个网卡接口或别名，但是你只允许到外的连接来自指定的网卡或者地址的情况下。


fastcgi_buffer_size


语法：fastcgi_buffer_size the_size ;
默认值：fastcgi_buffer_size 4k/8k ;
使用字段：http, server, location 
这个参数指定将用多大的缓冲区来读取从FastCGI进程到来应答头。
默认的缓冲区大小为fastcgi_buffers指令中的每块大小，可以将这个值设置更小。


fastcgi_buffers


语法：fastcgi_buffers the_number is_size; 
默认值：fastcgi_buffers 8 4k/8k; 
使用字段：http, server, location 
这个参数指定了从FastCGI进程到来的应答，本地将用多少和多大的缓冲区读取。
fastcgi_buffers可以设置为你的FastCGI返回的大部分应答大小，这样可以处理大部分的请求，较大的请求将被缓冲到磁盘。
如果想关闭对所有请求道磁盘的缓冲，可以将fastcgi_max_temp_file_size设置为0。
fastcgi_buffer等于：fastcgi_buffer_size + the_number * is_size
如果一个fastcgi应答为12k，那么fastcgi_buffers 64 4k将分配3个4k的buffer。这便是为什么fastcgi_buffers有两个参数，而fastcgi_buffer_size（用于应答头与应答的第一部分）只有1个参数，在fastcgi_buffer_size被清空后，它们和fastcgi_buffers一起被使用。
例如：


fastcgi_buffers 256 4k; #设置buffer大小为：4k + 256 * 4k = 1028k


这意味着大于1M的应答将被缓冲到磁盘，而小于1M的将在内存中处理。
默认这个参数等于分页大小，根据环境的不同可能是4K, 8K或16K。
在Linux系统中你可以通过下面的命令得到分页大小：


getconf PAGESIZE


返回的单位为bytes。
指令示例:


fastcgi_buffers 256 4k; # 设置缓冲区大小为4k + 256 * 4k = 1028k


这意味着所有FastCGI返回的应答，nginx将超过1M的部分写入磁盘，1M以内的部分写入内存。


fastcgi_cache


语法：fastcgi_cache zone|off; 
默认值：off 
使用字段：http, server, location 
为缓存实际使用的共享内存指定一个区域，相同的区域可以用在不同的地方。


fastcgi_cache_key


语法：fastcgi_cache_key line
默认值：none 
使用字段：http, server, location 
设置缓存的关键字，如：


fastcgi_cache_key localhost:9000$request_uri;



fastcgi_cache_path


语法：fastcgi_cache_path path [levels=m:n] keys_zone=name:size [inactive=time] [max_size=size]
默认值：none 
使用字段：http 
clean_time参数在0.7.45版本中已经移除。
这个指令指定FastCGI缓存的路径以及其他的一些参数，所有的数据以文件的形式存储，缓存的关键字(key)和文件名为代理的url计算出的MD5值。
Level参数设置缓存目录的目录分级以及子目录的数量，例如指令如果设置为：


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


那么数据文件将存储为：


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


缓存中的文件首先被写入一个临时文件并且随后被移动到缓存目录的最后位置，0.8.9版本之后可以将临时文件和缓存文件存储在不同的文件系统，但是需要明白这种移动并不是简单的原子重命名系统调用，而是整个文件的拷贝，所以最好在fastcgi_temp_path和fastcgi_cache_path的值中使用相同的文件系统。
另外，所有活动的关键字及数据相关信息都存储于共享内存池，这个值的名称和大小通过key_zone参数指定，inactive参数指定了内存中的数据存储时间，默认为10分钟。
max_size参数设置缓存的最大值，一个指定的cache manager进程将周期性的删除旧的缓存数据。


fastcgi_cache_methods


在缓存FastCGI请求中允许哪些http方法。
语法：fastcgi_cache_methods [GET HEAD POST]; 
默认值：fastcgi_cache_methods GET HEAD; 
使用字段：main,http,location 
这个指令指定在缓存FastCGI请求中允许哪些http方法。
无法禁用GET/HEAD ，即使你只是这样设置：


fastcgi_cache_methods  POST; #GET和HEAD依然可用



fastcgi_cache_min_uses


语法：fastcgi_cache_min_uses n 
默认值：fastcgi_cache_min_uses 1 
使用字段：http, server, location 
指令指定了经过多少次请求的相同URL将被缓存。


fastcgi_cache_use_stale


语法：fastcgi_cache_use_stale [updating|error|timeout|invalid_header|http_500]
默认值：fastcgi_cache_use_stale off; 
使用字段：http, server, location 
在某些网关错误、超时的情况下，nginx都将传送过期的缓存数据。


fastcgi_cache_valid


语法：fastcgi_cache_valid [http_error_code|time] 
默认值：none 
使用字段：http, server, location 
为指定的http返回代码指定缓存时间，例如：


fastcgi_cache_valid  200 302  10m;
fastcgi_cache_valid  404      1m;


将响应状态码为200和302缓存10分钟，404缓存1分钟。
默认情况下缓存只处理200，301，302的状态。
同样也可以在指令中使用any表示任何一个。


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



fastcgi_connect_timeout


语法：fastcgi_connect_timeout time 
默认值：fastcgi_connect_timeout 60 
使用字段：http, server, location 
指定同FastCGI服务器的连接超时时间，这个值不能超过75秒。


fastcgi_index


语法：fastcgi_index file 
默认值：none 
使用字段：http, server, location 
如果URI以斜线结尾，文件名将追加到URI后面，这个值将存储在变量$fastcgi_script_name中。例如：


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_hide_header


语法：fastcgi_hide_header name 
使用字段：http, server, location 
默认情况下nginx不会将来自FastCGI服务器的”Status”和”X-Accel-…“头传送到客户端，这个参数也可以隐藏某些其它的头。
如果必须传递”Status”和”X-Accel-…“头，则必须使用fastcgi_pass_header强制其传送到客户端。


fastcgi_ignore_client_abort


语法：fastcgi_ignore_client_abort on|off 
默认值：fastcgi_ignore_client_abort off 
使用字段：http, server, location 
如果当前连接请求FastCGI服务器失败，为防止其与nginx服务器断开连接，可以用这个指令。


fastcgi_ignore_headers


语法：fastcgi_ignore_headers name [name…] 
使用字段：http, server, location 
这个指令禁止处理一些FastCGI服务器应答的头部字段，比如可以指定像”X-Accel-Redirect”, “X-Accel-Expires”, “Expires”或”Cache-Control”等。


fastcgi_intercept_errors


语法：fastcgi_intercept_errors on|off 
默认值：fastcgi_intercept_errors off 
使用字段：http, server, location 
这个指令指定是否传递4xx和5xx错误信息到客户端，或者允许nginx使用error_page处理错误信息。
你必须明确的在error_page中指定处理方法使这个参数有效，正如Igor所说“如果没有适当的处理方法，nginx不会拦截一个错误，这个错误不会显示自己的默认页面，这里允许通过某些方法拦截错误。


fastcgi_max_temp_file_size


语法：fastcgi_max_temp_file_size 0 
默认值：? 
使用字段：? 
根据源代码关闭FastCGI缓冲。


fastcgi_no_cache


语法：fastcgi_no_cache variable […]
默认值：None 
使用字段：http, server, location 
确定在何种情况下缓存的应答将不会使用，示例：


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


如果为空字符串或者等于0，表达式的值等于false，例如，在上述例子中，如果在请求中设置了cookie “nocache”，缓存将被绕过。


fastcgi_next_upstream


语法：fastcgi_next_upstream error|timeout|invalid_header|http_500|http_503|http_404|off
默认值：fastcgi_next_upstream error timeout 
使用字段：http, server, location 
指令指定哪种情况请求将被转发到下一个FastCGI服务器：


    

  • error — 传送中的请求或者正在读取应答头的请求在连接服务器的时候发生错误。
    • 

  • timeout — 传送中的请求或者正在读取应答头的请求在连接服务器的时候超时。
    • 

  • invalid_header — 服务器返回空的或者无效的应答。
    • 

  • http_500 — 服务器返回500应答代码。
    • 

  • http_503 — 服务器返回503应答代码。
    • 

  • http_404 — 服务器返回404应答代码。
    • 

  • off — 禁止请求传送到下一个FastCGI服务器。
    • 



注意传送请求在传送到下一个服务器之前可能已经将空的数据传送到了客户端，所以，如果在数据传送中有错误或者超时发生，这个指令可能无法修复一些传送错误。


fastcgi_param


语法：fastcgi_param parameter value 
默认值：none 
使用字段：http, server, location 
指定一些传递到FastCGI服务器的参数。
可以使用字符串，变量，或者其组合，这里的设置不会继承到其他的字段，设置在当前字段会清除掉任何之前的定义。
下面是一个PHP需要使用的最少参数：


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


PHP使用SCRIPT_FILENAME参数决定需要执行哪个脚本，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;



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”。


参考文档


Original Documentation
Nginx Http FastCGI Module
				


				
时间： 2024-10-20 21:55:58 

		


		


	

	
	

		


		
nginx FastCGI模块（FastCGI）配置的相关文章


						

		

			

                NGINX基本模块与配置
			

		

		

									

				一.NGINX内置的基本模块 1.NGINX内核模块 2.EVENTS模块 3.HTTP核心模块 二.NGINX基本配置文件 #user nobody; worker_processes 1; #error_log logs/error.log; #error_log logs/error.log notice; #error_log logs/error.log info; #pid logs/nginx.pid; events { worker_connections 1024; } htt			

		

	

				

		

			

                Nginx基础入门之fastcgi模块常用配置项说明
			

		

		

									

				在LNMP环境中,我们都知道nginx如果要解析php脚本语言,就必须通过配置fastcgi模块来提供对php支持,那么在配置fastcgi的时候,关于fastcgi配置项的值应该怎么设置才能让其发挥出更出色的性能呢,下面就讲讲关于nginx模块中fastcgi这部分通用参数介绍 1.1 fastcgi_connect_timeout  配置语法:  fastcgi_connect_timeout 时间(单位为s) 默认值: fastcgi_connect_timeout 60s 配置区域: h			

		

	

				

		

			

                linux后台server开发环境的部署配置和验证(nginx+apache+php-fpm+FASTCGI(C/C++))
			

		

		

									

				linux后台server开发环境部署配置 引言 背景 随着互联网业务的不断增多.开发环境变得越来越复杂,为了便于统一server端的开发部署环境,特制定本配置文档. 使用软件 CentOS 6.3(Linux version 2.6.32-279.el6.x86_64) gcc (GCC) 4.4.6 20120305 (Red Hat 4.4.6-4) 本次配置 Nginx 1.5.8 Apache 2.4.7 php 5.3.26 目的 构造WEB前端技术架构.web前端的部署结构技术全然			

		

	

				

		

			

                linux后台服务器开发环境部署配置和验证(nginx+apache+php-fpm+FASTCGI(C/C++))
			

		

		

									

				linux后台服务器开发环境部署配置 引言 背景 随着公司互联网业务的不断增多,开发环境变得越来越复杂,为了便于统一服务器端的开发部署环境,特制定本配置文档. 使用软件 CentOS 6.3(Linux version 2.6.32-279.el6.x86_64) gcc (GCC) 4.4.6 20120305 (Red Hat 4.4.6-4) 本次配置 Nginx 1.5.8 Apache 2.4.7 php 5.3.26 目的 构造WEB前端技术架构,web前端的部署结构技术完全完成.			

		

	

				

		

			

                Nginx反向代理、缓存、 负载均衡、upstream以及fastcgi模块应用
			

		

		

									

				Nginx反向代理,缓存, 负载均衡, upstream及fastcgi模块应用 Nginx版本为nginx-1.6.2-1.el6.ngx.x86_64.rpm可以去官网下载: http://nginx.org/packages/centos/6/x86_64/RPMS/ [[email protected] ~]# rpm -ivhnginx-1.6.2-1.el6.ngx.x86_64.rpm [[email protected] ~]# vim/var/www/html/index.ht			

		

	

				

		

			

                Nginx缓存配置以及nginx ngx_cache_purge模块的使用
			

		

		

									

				web缓存位于内容源Web服务器和客户端之间,当用户访问一个URL时,Web缓存服务器会去后端Web源服务器取回要输出的内容,然后,当下一个请求到来时,如果访问的是相同的URL,Web缓存服务器直接输出内容给客户端,而不是向源服务器再次发送请求.Web缓存降低了内容源Web服务器,数据库的负载,减少了网络延迟,提高了用户访问的响应速度,增强了用户体验. web缓存服务器中,最著名的要数Squid Cache(简称为Squid),Squid是一个流浪的自由软件的代理服务器和Web缓存服务器.---			

		

	

				

		

			

                CentOS安装Apache的FastCGI模块（mod_fastcgi）
			

		

		

									

				网上有很多篇关于Apache的fastcgi模块安装说明的文章,大部分都是基于Apache源码编译的,如果是通过yum install方式安装httpd的话,直接依葫芦画瓢必然会遇到各种各样的编译问题,通过查阅老外写的一些关于CentOS下Apache的FastCGI模块(mod_fastcgi)的安装文档,我大致重新整理了一下. 1. 安装编译相关的依赖包 # yum install httpd-devel apr apr-devel libtool 2. 下载mod_fastcgi源代码 #			

		

	

				

		

			

                [Nginx配置系列] 基于Nginx Geo与 Nginx Map模块进行Nginx白名单配置
			

		

		

									

				一.简介 在通常情况下,使用 nginx 基于 ip 限制访问请求频率等限制内容,我们会需要对特定ip进行限制排除操作,因此本文引入了基于nginx geo 与 nginx map 进行此类情景相关配置: 在没有人为操作删除的情况下(without-http_geo_module),nginx默认模块中已经加载了ngx-http-geo-module相关内容: ngx-http-geo-module可以用来创建变量,变量值依赖于客户端 ip 地址; ngx-http-map-module可以基于			

		

	

				

		

			

                Nginx基于TCP/UDP端口的四层负载均衡（stream模块）配置梳理
			

		

		

									

				Nginx基于TCP/UDP端口的四层负载均衡(stream模块)配置梳理 通常我们会用Nginx的upstream做基于http/https端口的7层负载均衡,由于Nginx老版本不支持tcp协议,所以基于tcp/udp端口的四层负载均衡一般用LVS或Haproxy来做.至于4层负载均衡和7层负载均衡的区别,可以参考:http://www.cnblogs.com/kevingrace/p/6137881.html.然而Nginx从1.9.0版本开始,新增加了一个stream模块,用来实现四层协			

		

	

				

		

			

                Ubuntu中Nginx的安装与配置
			

		

		

									

				Ubuntu中Nginx的安装与配置 1.Nginx介绍 Nginx是一个非常轻量级的HTTP服务器,Nginx,它的发音为“engine X”, 是一个高性能的HTTP和 反向代理服务器,同时也是一个IMAP/POP3/SMTP 代理服务器. 2.对PHP支持 目前各种web 服务器对PHP的支持一共有三种: (1)通过web 服务器内置的模块来实现,例如Apache的mod_php5,类似的Apache内置的mod_perl 可以对perl支持. (2)通过CGI来实现,这个就好比之前per