[php] php-fpm.conf 重要参数详解

php-fpm.conf 重要参数详解

原文链接

pid = run/php-fpm.pid

pid设置，默认在安装目录中的 var/run/php-fpm.pid，建议开启

error_log = log/php-fpm.log

错误日志，默认在安装目录中的 var/log/php-fpm.log

log_level = notice

错误级别. 可用级别为:
alert（必须立即处理）,
error（错误情况）,
warning（警告情况）,
notice（一般重要信息）,
debug（调试信息）. 默认: notice.

emergency_restart_threshold = 60
emergency_restart_interval = 60s

表示在 emergency_restart_interval 所设值内出现 SIGSEGV 或者 SIGBUS 错误的 php-cgi 进程数
如果超过 emergency_restart_threshold 个，php-fpm 就会优雅重启。
这两个选项一般保持默认值。

process_control_timeout = 0

设置子进程接受主进程复用信号的超时时间.
可用单位: s (秒), m (分), h (小时), 或者 d (天)
默认单位: s (秒). 默认值: 0.

daemonize = yes

后台执行 fpm，默认值为 yes，如果为了调试可以改为 no。
在 FPM 中，可以使用不同的设置来运行多个进程池。
这些设置可以针对每个进程池单独设置。

listen = 127.0.0.1:9000

fpm 监听端口，即 nginx 中 php 处理的地址，一般默认值即可。
可用格式为: ‘ip:port’, ‘port’, ‘/path/to/unix/socket’. 每个进程池都需要设置.

listen.backlog = -1

backlog 数，-1表示无限制，由操作系统决定，此行注释掉就行。
backlog 含义参考：http://www.3gyou.cc/?p=41

listen.allowed_clients = 127.0.0.1

允许访问 FastCGI 进程的 IP，设置 any 为不限制 IP，如果要设置其他主机的 nginx 也能访问这台 FPM 进程，listen 处要设置成本地可被访问的 IP。
默认值是 any。每个地址是用逗号分隔. 如果没有设置或者为空，则允许任何服务器请求连接

listen.owner = www

如果使用，表示设置 Unix 套接字的权限。
在 Linux 中，读写权限必须设置，以便用于 WEB 服务器连接。
在很多 BSD 派生的系统中可以忽略权限允许自由连接。
默认值：运行所使用的用户和组，权限为 0666。

listen.group = www

同 listen.owner

listen.mode = 0666

unix socket 设置选项，如果使用 tcp 方式访问，这里注释即可。

user = www
group = www

启动进程的帐户和组

pm = dynamic

对于专用服务器，pm 可以设置为 static。
如何控制子进程，选项有 static 和 dynamic。
如果选择 static，则由 pm.max_children 指定固定的子进程数。
如果选择 dynamic，则由下开参数决定：

pm.max_children

子进程最大数

pm.start_servers

启动时的进程数

pm.min_spare_servers

保证空闲进程数最小值，如果空闲进程小于此值，则创建新的子进程

pm.max_spare_servers

保证空闲进程数最大值，如果空闲进程大于此值，此进行清理

pm.max_requests = 1000

设置每个子进程重生之前服务的请求数. 对于可能存在内存泄漏的第三方模块来说是非常有用的.
如果设置为 ‘0’ 则一直接受请求. 等同于 PHP_FCGI_MAX_REQUESTS 环境变量。
默认值: 0.

pm.status_path = /status

FPM状态页面的网址. 如果没有设置, 则无法访问状态页面.
默认值: none. munin 监控会使用到

ping.path = /ping

FPM 监控页面的 ping 网址. 如果没有设置, 则无法访问 ping 页面.
该页面用于外部检测 FPM 是否存活并且可以响应请求. 请注意必须以斜线开头 (/)。

ping.response = pong

用于定义 ping 请求的返回相应. 返回为 HTTP 200 的 text/plain 格式文本.
默认值: pong.

request_terminate_timeout = 0

设置单个请求的超时中止时间.
该选项可能会对 php.ini 设置中的 ‘max_execution_time’ 因为某些特殊原因没有中止运行的脚本有用.
设置为 ‘0’ 表示 ‘Off’。当经常出现 502 错误时可以尝试更改此选项。

request_slowlog_timeout = 10s

当一个请求该设置的超时时间后，就会将对应的 PHP 调用堆栈信息完整写入到慢日志中.
设置为 ‘0’ 表示 ‘Off’

slowlog = log/$pool.log.slow

慢请求的记录日志,配合 request_slowlog_timeout 使用

rlimit_files = 1024

设置文件打开描述符的 rlimit 限制.
默认值: 系统定义值默认可打开句柄是1024，
可使用 ulimit -n查看，ulimit -n 2048修改。

rlimit_core = 0

设置核心 rlimit 最大限制值.
可用值: ‘unlimited’ 、0或者正整数.
默认值: 系统定义值.

chroot =

启动时的 Chroot 目录.
所定义的目录需要是绝对路径. 如果没有设置, 则 chroot 不被使用.

chdir =

设置启动目录，启动时会自动 Chdir 到该目录.
所定义的目录需要是绝对路径.
默认值: 当前目录，或者 / 目录（chroot 时）

catch_workers_output = yes

重定向运行过程中的 stdout 和 stderr 到主要的错误日志文件中.
如果没有设置, stdout 和 stderr 将会根据 FastCGI 的规则被重定向到 /dev/null
默认值: 空.

常见错误及解决办法整理

request_terminate_timeout 引起的资源问题

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 加一个超时参数。

$ctx = stream_context_create(array(
    'http' => array(
        'timeout' => 10    //设置一个超时时间，单位为秒
    )
));

file_get_contents ($str, 0, $ctx);

max_requests 参数配置不当，可能会引起间歇性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）。
大家要根据自己的实际情况设置这个值，不能盲目地加大。