php-fpm.conf 解析

如下内容转自：http://www.4wei.cn/archives/1002061

约定几个目录
/usr/local/php/sbin/php-fpm
/usr/local/php/etc/php-fpm.conf
/usr/local/php/etc/php.ini

 

php-fpm.conf重要参数详解：

 1 pid = run/php-fpm.pid
 2 #pid设置，默认在安装目录中的var/run/php-fpm.pid，建议开启
 3  
 4 error_log = log/php-fpm.log
 5 #错误日志，默认在安装目录中的var/log/php-fpm.log
 6  
 7 log_level = notice
 8 #错误级别. 可用级别为: alert（必须当即处理）, error（错误状况）, warning（警告状况）, notice（通常重要信息）, debug（调试信息）. 默认: notice.
 9  
10 emergency_restart_threshold = 60
11 emergency_restart_interval = 60s
12 #表示在emergency_restart_interval所设值内出现SIGSEGV或者SIGBUS错误的php-cgi进程数若是超过 emergency_restart_threshold个，php-fpm就会优雅重启。这两个选项通常保持默认值。
13  
14 process_control_timeout = 0
15 #设置子进程接受主进程复用信号的超时时间. 可用单位: s(秒), m(分), h(小时), 或者 d(天) 默认单位: s(秒). 默认值: 0.
16  
17 daemonize = yes
18 #后台执行fpm,默认值为yes，若是为了调试能够改成no。在FPM中，可使用不一样的设置来运行多个进程池。 这些设置能够针对每一个进程池单独设置。
19  
20 listen = 127.0.0.1:9000
21 #fpm监听端口，即nginx中php处理的地址，通常默认值便可。可用格式为: 'ip:port', 'port', '/path/to/unix/socket'. 每一个进程池都须要设置.
22  
23 listen.backlog = -1
24 #backlog数，-1表示无限制，由操做系统决定，此行注释掉就行。backlog含义参考：http://www.3gyou.cc/?p=41
25  
26 listen.allowed_clients = 127.0.0.1
27 #容许访问FastCGI进程的IP，设置any为不限制IP，若是要设置其余主机的nginx也能访问这台FPM进程，listen处要设置成本地可被访问的IP。默认值是any。每一个地址是用逗号分隔. 若是没有设置或者为空，则容许任何服务器请求链接
28  
29 listen.owner = www
30 listen.group = www
31 listen.mode = 0666
32 #unix socket设置选项，若是使用tcp方式访问，这里注释便可。
33  
34 user = www
35 group = www
36 #启动进程的账户和组
37  
38 pm = dynamic #对于专用服务器，pm能够设置为static。
39 #如何控制子进程，选项有static和dynamic。若是选择static，则由pm.max_children指定固定的子进程数。若是选择dynamic，则由下开参数决定：
40 pm.max_children #，子进程最大数
41 pm.start_servers #，启动时的进程数
42 pm.min_spare_servers #，保证空闲进程数最小值，若是空闲进程小于此值，则建立新的子进程
43 pm.max_spare_servers #，保证空闲进程数最大值，若是空闲进程大于此值，此进行清理
44  
45 pm.max_requests = 1000
46 #设置每一个子进程重生以前服务的请求数. 对于可能存在内存泄漏的第三方模块来讲是很是有用的. 若是设置为 '0' 则一直接受请求. 等同于 PHP_FCGI_MAX_REQUESTS 环境变量. 默认值: 0.
47  
48 pm.status_path = /status
49 #FPM状态页面的网址. 若是没有设置, 则没法访问状态页面. 默认值: none. munin监控会使用到
50  
51 ping.path = /ping
52 #FPM监控页面的ping网址. 若是没有设置, 则没法访问ping页面. 该页面用于外部检测FPM是否存活而且能够响应请求. 请注意必须以斜线开头 (/)。
53  
54 ping.response = pong
55 #用于定义ping请求的返回相应. 返回为 HTTP 200 的 text/plain 格式文本. 默认值: pong.
56  
57 request_terminate_timeout = 0
58 #设置单个请求的超时停止时间. 该选项可能会对php.ini设置中的'max_execution_time'由于某些特殊缘由没有停止运行的脚本有用. 设置为 '0' 表示 'Off'.当常常出现502错误时能够尝试更改此选项。
59  
60 request_slowlog_timeout = 10s
61 #当一个请求该设置的超时时间后，就会将对应的PHP调用堆栈信息完整写入到慢日志中. 设置为 '0' 表示 'Off'
62  
63 slowlog = log/$pool.log.slow
64 #慢请求的记录日志,配合request_slowlog_timeout使用
65  
66 rlimit_files = 1024
67 #设置文件打开描述符的rlimit限制. 默认值: 系统定义值默承认打开句柄是1024，可以使用 ulimit -n查看，ulimit -n 2048修改。
68  
69 rlimit_core = 0
70 #设置核心rlimit最大限制值. 可用值: 'unlimited' 、0或者正整数. 默认值: 系统定义值.
71  
72 chroot =
73 #启动时的Chroot目录. 所定义的目录须要是绝对路径. 若是没有设置, 则chroot不被使用.
74  
75 chdir =
76 #设置启动目录，启动时会自动Chdir到该目录. 所定义的目录须要是绝对路径. 默认值: 当前目录，或者/目录（chroot时）
77  
78 catch_workers_output = yes
79 #重定向运行过程当中的stdout和stderr到主要的错误日志文件中. 若是没有设置, stdout 和 stderr 将会根据FastCGI的规则被重定向到 /dev/null . 默认值: 空.

 

常见错误及解决办法整理

1,request_terminate_timeout的值若是设置为0或者过长的时间，可能会引发file_get_contents的资源问题。
若是file_get_contents请求的远程资源若是反应过慢，file_get_contents就会一直卡在那里不会超时，咱们知道php.ini 里面max_execution_time 能够设置 PHP 脚本的最大执行时间，可是，在 php-cgi(php-fpm) 中，该参数不会起效。真正可以控制 PHP 脚本最大执行时间的是 php-fpm.conf 配置文件中的request_terminate_timeout参数。

request_terminate_timeout默认值为 0 秒，也就是说，PHP 脚本会一直执行下去。这样，当全部的 php-cgi 进程都卡在 file_get_contents() 函数时，这台 Nginx+PHP 的 WebServer 已经没法再处理新的 PHP 请求了，Nginx 将给用户返回“502 Bad Gateway”。修改该参数，设置一个 PHP 脚本最大执行时间是必要的，可是，治标不治本。例如改为 30s，若是发生 file_get_contents() 获取网页内容较慢的状况，这就意味着 150 个 php-cgi 进程，每秒钟只能处理 5 个请求，WebServer 一样很难避免"502 Bad Gateway"。解决办法是request_terminate_timeout设置为10s或者一个合理的值，或者给file_get_contents加一个超时参数。

1 $ctx = stream_context_create(array(  
2    'http' => array(  
3        'timeout' => 10 //设置一个超时时间，单位为秒  
4        )  
5    )  
6 );  
7 file_get_contents($str, 0, $ctx); 

2,max_requests参数配置不当，可能会引发间歇性502错误：
http://hily.me/blog/2011/01/nginx-php-fpm-502/

pm.max_requests = 1000
#设置每一个子进程重生以前服务的请求数. 对于可能存在内存泄漏的第三方模块来讲是很是有用的. 若是设置为 '0' 则一直接受请求. 等同于 PHP_FCGI_MAX_REQUESTS 环境变量. 默认值: 0.
这段配置的意思是，当一个 PHP-CGI 进程处理的请求数累积到 500 个后，自动重启该进程。

可是为何要重启进程呢？

通常在项目中，咱们多多少少都会用到一些 PHP 的第三方库，这些第三方库常常存在内存泄漏问题，若是不按期重启 PHP-CGI 进程，势必形成内存使用量不断增加。所以 PHP-FPM 做为 PHP-CGI 的管理器，提供了这么一项监控功能，对请求达到指定次数的 PHP-CGI 进程进行重启，保证内存使用量不增加。

正是由于这个机制，在高并发的站点中，常常致使 502 错误，我猜想缘由是 PHP-FPM 对从 NGINX 过来的请求队列没处理好。不过我目前用的仍是 PHP 5.3.2，不知道在 PHP 5.3.3 中是否还存在这个问题。

目前咱们的解决方法是，把这个值尽可能设置大些，尽量减小 PHP-CGI 从新 SPAWN 的次数，同时也能提升整体性能。在咱们本身实际的生产环境中发现，内存泄漏并不明显，所以咱们将这个值设置得很是大（204800）。你们要根据本身的实际状况设置这个值，不能盲目地加大。

话说回来，这套机制目的只为保证 PHP-CGI 不过度地占用内存，为什么不经过检测内存的方式来处理呢？我很是认同高春辉所说的，经过设置进程的峰值内在占用量来重启 PHP-CGI 进程，会是更好的一个解决方案。

3,php-fpm的慢日志，debug及异常排查神器：request_slowlog_timeout设置一个超时的参数，slowlog设置慢日志的存放位置，tail -f /var/log/www.slow.log便可看到执行过慢的php过程。你们能够看到常常出现的网络读取超过、Mysql查询过慢的问题，根据提示信息再排查问题就有很明确的方向了。