阿里云-云小站(无限量代金券发放中)
【腾讯云】云服务器、云数据库、COS、CDN、短信等热卖云产品特惠抢购

LNMP笔记:php-fpm – 启动参数及重要配置详解

225次阅读
没有评论

共计 7494 个字符,预计需要花费 19 分钟才能阅读完成。

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

php-fpm 的启动参数

1
2
3
4
5
6
78
9
10
11
12
13
# 测试 php-fpm 配置
/usr/local/php/sbin/php-fpm -t
/usr/local/php/sbin/php-fpm -c /usr/local/php/etc/php.ini -y /usr/local/php/etc/php-fpm.conf -t
 
# 启动 php-fpm
/usr/local/php/sbin/php-fpm
/usr/local/php/sbin/php-fpm -c /usr/local/php/etc/php.ini -y /usr/local/php/etc/php-fpm.conf
 
# 关闭 php-fpm
kill -INT `cat /usr/local/php/var/run/php-fpm.pid`
 
# 重启 php-fpm
kill -USR2 `cat /usr/local/php/var/run/php-fpm.pid`

# 启动 php-fpm
/usr/local/php/sbin/php-fpm
/usr/local/php/sbin/php-fpm -c /usr/local/php/etc/php.ini -y /usr/local/php/etc/php-fpm.conf

# 关闭 php-fpm
kill -INT `cat /usr/local/php/var/run/php-fpm.pid`

# 重启 php-fpm
kill -USR2 `cat /usr/local/php/var/run/php-fpm.pid`

php-fpm.conf 重要参数详解

1
2
3
4
5
6
78
9
10
11
12
1314
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
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
listen.group = www
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 . 默认值: 空.

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
listen.group = www
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 . 默认值: 空.

常见错误及解决办法整理

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
2
3
4
5
6
7
$ctx = stream_context_create(array(  
   'http' => array(  
       'timeout' => 10 // 设置一个超时时间,单位为秒  
       )  
   )  
);  
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 查询过慢的问题,根据提示信息再排查问题就有很明确的方向了。

转载自:http://www.4wei.cn/archives/1002061

正文完
星哥说事-微信公众号
post-qrcode
 
星锅
版权声明:本站原创文章,由 星锅 2022-01-22发表,共计7494字。
转载说明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。
【腾讯云】推广者专属福利,新客户无门槛领取总价值高达2860元代金券,每种代金券限量500张,先到先得。
阿里云-最新活动爆款每日限量供应
评论(没有评论)
验证码
【腾讯云】云服务器、云数据库、COS、CDN、短信等云产品特惠热卖中