基于php-fpm 参数的深入理解
程序员文章站
2023-02-24 23:42:47
ps aux |grep php-fpm |more查看php-fpm总数php-fpm.conf 配置pid stringpid文件的位置. 默认为空.error_log...
ps aux |grep php-fpm |more
查看php-fpm总数
php-fpm.conf 配置
pid string
pid文件的位置. 默认为空.
error_log string
错误日志的位置. 默认： 安装路径#install_prefix#/log/php-fpm.log.
log_level string
错误级别. 可用级别为: alert（必须立即处理）, error（错误情况）, warning（警告情况）, notice（一般重要信息）, debug（调试信息）. 默认: notice.
emergency_restart_threshold int
如果子进程在emergency_restart_interval设定的时间内收到该参数设定次数的sigsegv 或者 sigbus退出信息号，则fpm会重新启动。 0 表示 ‘关闭该功能'. 默认值: 0 (关闭).
emergency_restart_interval mixed
emergency_restart_interval用于设定平滑重启的间隔时间. 这么做有助于解决加速器*享内存的使用问题. 可用单位: s(秒), m(分), h(小时), 或者 d(天). 默认单位： s(秒). 默认值: 0 (关闭).
process_control_timeout mixed
设置子进程接受主进程复用信号的超时时间. 可用单位: s(秒), m(分), h(小时), 或者 d(天) 默认单位: s(秒). 默认值: 0.
daemonize boolean
设置fpm在后台运行. 设置 ‘no' 将 fpm 保持在前台运行用于调试. 默认值: yes.
运行配置区段
在fpm中，可以使用不同的设置来运行多个进程池。 这些设置可以针对每个进程池单独设置。
listen string
设置接受fastcgi请求的地址. 可用格式为: ‘ip:port', ‘port', ‘/path/to/unix/socket'. 每个进程池都需要设置.
listen.backlog int
设置 listen(2) 的半连接队列长度. ‘-1′ 表示无限制. 默认值: -1.
listen.allowed_clients string
设置允许连接到fastcgi的服务器ipv4地址. 等同于php fastcgi (5.2.2+)中的 fcgi_web_server_addrs环境变量. 仅对tcp监听起作用. 每个地址是用逗号分隔. 如果没有设置或者为空，则允许任何服务器请求连接. 默认值: any.
listen.owner string
如果使用，表示设置unix套接字的权限. 在linux中，读写权限必须设置，以便用于web服务器连接. 在很多bsd派生的系统中可以忽略权限允许*连接. 默认值: 运行所使用的用户合租, 权限为0666.
listen.group string
参见 listen.owner.
listen.mode string
参见 listen.owner.
user string
fpm 进程运行的unix用户. 必须设置.
group string
fpm 进程运行的unix用户组. 如果没有设置，则默认用户的组被使用.
pm string
设置进程管理器如何管理子进程. 可用值: static, dynamic. 必须设置.
static – 子进程的数量是固定的 (pm.max_children).
dynamic – 子进程的数量在下面配置的基础上动态设置: pm.max_children, pm.start_servers, pm.min_spare_servers, pm.max_spare_servers.
pm.max_children int
子进程的数量，pm 设置为 static 时表示创建的， pm 设置为 dynamic 时表示最大可创建的. 必须设置.
该选项设置可以同时提供服务的请求数限制. 类似 apache 的 mpm_prefork 中 maxclients 的设置和 普通php fastcgi中的 php_fcgi_children 环境变量.
pm.start_servers in
设置启动时创建的子进程数目. 仅在 pm 设置为 dynamic 时使用. 默认值: min_spare_servers + (max_spare_servers – min_spare_servers) / 2.
pm.min_spare_servers int
设置空闲服务进程的最低数目. 仅在 pm 设置为 dynamic 时使用. 必须设置.
pm.max_spare_servers int
设置空闲服务进程的最大数目. 仅在 pm 设置为 dynamic 时使用. 必须设置.
pm.max_requests int
设置每个子进程重生之前服务的请求数. 对于可能存在内存泄漏的第三方模块来说是非常有用的. 如果设置为 '0′ 则一直接受请求. 等同于 php_fcgi_max_requests 环境变量. 默认值: 0.
pm.status_path string
fpm状态页面的网址. 如果没有设置, 则无法访问状态页面. 默认值: none.
ping.path string
fpm监控页面的ping网址. 如果没有设置, 则无法访问ping页面. 该页面用于外部检测fpm是否存活并且可以响应请求. 请注意必须以斜线开头 (/).
ping.response string
用于定义ping请求的返回相应. 返回为 http 200 的 text/plain 格式文本. 默认值: pong.
request_terminate_timeout mixed
设置单个请求的超时中止时间. 该选项可能会对php.ini设置中的'max_execution_time'因为某些特殊原因没有中止运行的脚本有用. 设置为 '0′ 表示 ‘off'. available units: s(econds)(default), m(inutes), h(ours), or d(ays). default value: 0.
request_slowlog_timeout mixed
当一个请求该设置的超时时间后，就会将对应的php调用堆栈信息完整写入到慢日志中. 设置为 '0′ 表示 ‘off'. 可用单位: s(秒)(默认), m(分), h(小时), 或者 d(天). 默认值: 0.
slowlog string
慢请求的记录日志. 默认值: #install_prefix#/log/php-fpm.log.slow.
request_slowlog_timeout
范围: php-fpm.conf 选项
分类: 方便
这个选项能让你跟踪执行缓慢的脚本并把他们连同调用栈一起记录再日志文件中。例如如下设置：
<value name="request_slowlog_timeout">5s</value>
<value name="slowlog">logs/slow.log</value>
记录的 slow.log 可能是这个样子：
sep 21 16:22:19.399162 pid 29715 (pool default)
script_filename = /local/www/stable/www/catalogue.php
[0x00007fff23618120] mysql_query() /srv/stable/common/database/class.mysqlrequest.php:20
[0x00007fff23618560] getresult() /srv/stable/common/database/class.facade.php:106
[0x00007fff23618aa0] query() /srv/stable/common/mysite.com/orm/class.usersmapper.php:99
[0x00007fff23618d60] resolvebyid() /srv/stable/common/mysite.com/orm/class.user.php:629
[0x00007fff236193b0] getdata() /srv/stable/common/class.dataentity.php:90
[0x00007fff236195d0] load() /srv/stable/common/mysite.com/orm/class.user.php:587
[0x00007fff23619a00] getishidden() /srv/stable/common/mysite.com/class.user.php:42
[0x00007fff2361a470] getname() /local/www/stable/www/catalogue.php:41
同时，在 error.log 中保存了如下记录：
sep 21 16:22:19.399031 [warning] fpm_request_check_timed_out(), line 135: child 29715, script '/local/www/stable/www/catalogue.php' (pool default) executing too slow (5.018002 sec), logging
正如你再例子中看到的，脚本运行了 5 秒以上，并很可能是由于 mysql 响应慢造成的（top backtrace）。
rlimit_files int
设置文件打开描述符的rlimit限制. 默认值: 系统定义值.
rlimit_core int
设置核心rlimit最大限制值. 可用值: ‘unlimited' 、0或者正整数. 默认值: 系统定义值.
chroot string
启动时的chroot目录. 所定义的目录需要是绝对路径. 如果没有设置, 则chroot不被使用.
chdir string
设置启动目录，启动时会自动chdir到该目录. 所定义的目录需要是绝对路径. 默认值: 当前目录，或者/目录（chroot时）.
catch_workers_output boolean
重定向运行过程中的stdout和stderr到主要的错误日志文件中. 如果没有设置, stdout 和 stderr 将会根据fastcgi的规则被重定向到 /dev/null . 默认值: 空.
你还可以在为一个运行池传递附加的环境变量，或者更新php的配置值. 你可以在 php-fpm.conf 中下如下面的配置参数来做到：
example #1 给运行池传递环境变量和设置php的配置值
env[hostname] = $hostname
env[path] = /usr/local/bin:/usr/bin:/bin
env[tmp] = /tmp
env[tmpdir] = /tmp
env[temp] = /tmp
php_admin_value[sendmail_path] = /usr/sbin/sendmail -t -i -f www@my.domain.com
php_flag[display_errors] = off
php_admin_value[error_log] = /var/log/fpm-php.www.log
php_admin_flag[log_errors] = on
php_admin_value[memory_limit] = 32m
php配置值通过 php_value 或者 php_flag 设置，并且会覆盖以前的值. 请注意 disable_functions 或者 disable_classes 在 php.ini 之中定义的值不会被覆盖掉, 但是会将新的设置附加在原有值的后面.
使用 php_admin_value 或者 php_admin_flag 定义的值，不能被php代码中的 ini_set() 覆盖.
faq
q：php-fpm 可以和 zendoptimize 一起用吗？
a：完全可以。
查看php-fpm总数
php-fpm.conf 配置
pid string
pid文件的位置. 默认为空.
error_log string
错误日志的位置. 默认： 安装路径#install_prefix#/log/php-fpm.log.
log_level string
错误级别. 可用级别为: alert（必须立即处理）, error（错误情况）, warning（警告情况）, notice（一般重要信息）, debug（调试信息）. 默认: notice.
emergency_restart_threshold int
如果子进程在emergency_restart_interval设定的时间内收到该参数设定次数的sigsegv 或者 sigbus退出信息号，则fpm会重新启动。 0 表示 ‘关闭该功能'. 默认值: 0 (关闭).
emergency_restart_interval mixed
emergency_restart_interval用于设定平滑重启的间隔时间. 这么做有助于解决加速器*享内存的使用问题. 可用单位: s(秒), m(分), h(小时), 或者 d(天). 默认单位： s(秒). 默认值: 0 (关闭).
process_control_timeout mixed
设置子进程接受主进程复用信号的超时时间. 可用单位: s(秒), m(分), h(小时), 或者 d(天) 默认单位: s(秒). 默认值: 0.
daemonize boolean
设置fpm在后台运行. 设置 ‘no' 将 fpm 保持在前台运行用于调试. 默认值: yes.
运行配置区段
在fpm中，可以使用不同的设置来运行多个进程池。 这些设置可以针对每个进程池单独设置。
listen string
设置接受fastcgi请求的地址. 可用格式为: ‘ip:port', ‘port', ‘/path/to/unix/socket'. 每个进程池都需要设置.
listen.backlog int
设置 listen(2) 的半连接队列长度. ‘-1′ 表示无限制. 默认值: -1.
listen.allowed_clients string
设置允许连接到fastcgi的服务器ipv4地址. 等同于php fastcgi (5.2.2+)中的 fcgi_web_server_addrs环境变量. 仅对tcp监听起作用. 每个地址是用逗号分隔. 如果没有设置或者为空，则允许任何服务器请求连接. 默认值: any.
listen.owner string
如果使用，表示设置unix套接字的权限. 在linux中，读写权限必须设置，以便用于web服务器连接. 在很多bsd派生的系统中可以忽略权限允许*连接. 默认值: 运行所使用的用户合租, 权限为0666.
listen.group string
参见 listen.owner.
listen.mode string
参见 listen.owner.
user string
fpm 进程运行的unix用户. 必须设置.
group string
fpm 进程运行的unix用户组. 如果没有设置，则默认用户的组被使用.
pm string
设置进程管理器如何管理子进程. 可用值: static, dynamic. 必须设置.
static – 子进程的数量是固定的 (pm.max_children).
dynamic – 子进程的数量在下面配置的基础上动态设置: pm.max_children, pm.start_servers, pm.min_spare_servers, pm.max_spare_servers.
pm.max_children int
子进程的数量，pm 设置为 static 时表示创建的， pm 设置为 dynamic 时表示最大可创建的. 必须设置.
该选项设置可以同时提供服务的请求数限制. 类似 apache 的 mpm_prefork 中 maxclients 的设置和 普通php fastcgi中的 php_fcgi_children 环境变量.
pm.start_servers in
设置启动时创建的子进程数目. 仅在 pm 设置为 dynamic 时使用. 默认值: min_spare_servers + (max_spare_servers – min_spare_servers) / 2.
pm.min_spare_servers int
设置空闲服务进程的最低数目. 仅在 pm 设置为 dynamic 时使用. 必须设置.
pm.max_spare_servers int
设置空闲服务进程的最大数目. 仅在 pm 设置为 dynamic 时使用. 必须设置.
pm.max_requests int
设置每个子进程重生之前服务的请求数. 对于可能存在内存泄漏的第三方模块来说是非常有用的. 如果设置为 '0′ 则一直接受请求. 等同于 php_fcgi_max_requests 环境变量. 默认值: 0.
pm.status_path string
fpm状态页面的网址. 如果没有设置, 则无法访问状态页面. 默认值: none.
ping.path string
fpm监控页面的ping网址. 如果没有设置, 则无法访问ping页面. 该页面用于外部检测fpm是否存活并且可以响应请求. 请注意必须以斜线开头 (/).
ping.response string
用于定义ping请求的返回相应. 返回为 http 200 的 text/plain 格式文本. 默认值: pong.
request_terminate_timeout mixed
设置单个请求的超时中止时间. 该选项可能会对php.ini设置中的'max_execution_time'因为某些特殊原因没有中止运行的脚本有用. 设置为 '0′ 表示 ‘off'. available units: s(econds)(default), m(inutes), h(ours), or d(ays). default value: 0.
request_slowlog_timeout mixed
当一个请求该设置的超时时间后，就会将对应的php调用堆栈信息完整写入到慢日志中. 设置为 '0′ 表示 ‘off'. 可用单位: s(秒)(默认), m(分), h(小时), 或者 d(天). 默认值: 0.
slowlog string
慢请求的记录日志. 默认值: #install_prefix#/log/php-fpm.log.slow.
request_slowlog_timeout
范围: php-fpm.conf 选项
分类: 方便
这个选项能让你跟踪执行缓慢的脚本并把他们连同调用栈一起记录再日志文件中。例如如下设置：
<value name="request_slowlog_timeout">5s</value>
<value name="slowlog">logs/slow.log</value>
记录的 slow.log 可能是这个样子：
复制代码 代码如下:
sep 21 16:22:19.399162 pid 29715 (pool default)
script_filename = /local/www/stable/www/catalogue.php
[0x00007fff23618120] mysql_query() /srv/stable/common/database/class.mysqlrequest.php:20
[0x00007fff23618560] getresult() /srv/stable/common/database/class.facade.php:106
[0x00007fff23618aa0] query() /srv/stable/common/mysite.com/orm/class.usersmapper.php:99
[0x00007fff23618d60] resolvebyid() /srv/stable/common/mysite.com/orm/class.user.php:629
[0x00007fff236193b0] getdata() /srv/stable/common/class.dataentity.php:90
[0x00007fff236195d0] load() /srv/stable/common/mysite.com/orm/class.user.php:587
[0x00007fff23619a00] getishidden() /srv/stable/common/mysite.com/class.user.php:42
[0x00007fff2361a470] getname() /local/www/stable/www/catalogue.php:41
同时，在 error.log 中保存了如下记录：
sep 21 16:22:19.399031 [warning] fpm_request_check_timed_out(), line 135: child 29715, script '/local/www/stable/www/catalogue.php' (pool default) executing too slow (5.018002 sec), logging
正如你再例子中看到的，脚本运行了 5 秒以上，并很可能是由于 mysql 响应慢造成的（top backtrace）。
rlimit_files int
设置文件打开描述符的rlimit限制. 默认值: 系统定义值.
rlimit_core int
设置核心rlimit最大限制值. 可用值: ‘unlimited' 、0或者正整数. 默认值: 系统定义值.
chroot string
启动时的chroot目录. 所定义的目录需要是绝对路径. 如果没有设置, 则chroot不被使用.
chdir string
设置启动目录，启动时会自动chdir到该目录. 所定义的目录需要是绝对路径. 默认值: 当前目录，或者/目录（chroot时）.
catch_workers_output boolean
重定向运行过程中的stdout和stderr到主要的错误日志文件中. 如果没有设置, stdout 和 stderr 将会根据fastcgi的规则被重定向到 /dev/null . 默认值: 空.
你还可以在为一个运行池传递附加的环境变量，或者更新php的配置值. 你可以在 php-fpm.conf 中下如下面的配置参数来做到：
example #1 给运行池传递环境变量和设置php的配置值
env[hostname] = $hostname
env[path] = /usr/local/bin:/usr/bin:/bin
env[tmp] = /tmp
env[tmpdir] = /tmp
env[temp] = /tmp
php_admin_value[sendmail_path] = /usr/sbin/sendmail -t -i -f www@my.domain.com
php_flag[display_errors] = off
php_admin_value[error_log] = /var/log/fpm-php.www.log
php_admin_flag[log_errors] = on
php_admin_value[memory_limit] = 32m
php配置值通过 php_value 或者 php_flag 设置，并且会覆盖以前的值. 请注意 disable_functions 或者 disable_classes 在 php.ini 之中定义的值不会被覆盖掉, 但是会将新的设置附加在原有值的后面.
使用 php_admin_value 或者 php_admin_flag 定义的值，不能被php代码中的 ini_set() 覆盖.
faq
q：php-fpm 可以和 zendoptimize 一起用吗？
a：完全可以。
q：php-fpm 可以和 zendplatform、xcache、eaccelerator、apc 等的优化器一起用吗？
a：是的。php-fpm 的架构和任何一种用于高速 opcode 缓存的共享内存都适用。唯一的限制是：所有的 worker 进程只能适用一个缓存，即使它们用不同的 uid/gid 运行
q：为什么我要给 php 打补丁呢？spawn-fcgi 不需要这样！
a：php-fpm 的创建是为了增强方便管理。没有打过补丁的 php 不能做到：
平滑重启 php 而不丢失请求，包括升级 php 二进制文件 以及/或者 扩展。
用不同的 uid / gid / chroot 环境运行 worker 进程
所有的设置只有一个配置文件
根据负载动态请求 （todo）
对 php 请求实时统计性能 （todo）
q：为什么要用 root 运行 php-fpm 呢？这安全吗？
a：用 root 启动 php-fpm 只有在你打算用不同 uid/gid 的 php 来处理请求时才有意义。比如，在共享主机上的不同站点。因为只有在 master 进程用 root 运行的时候，才可以建立不同 uid/gid 的子进程。这是相当安全的。master 进程自己从来不会去处理请求。
在任何情况下，php- fpm 都不会用 root 身份来处理请求。
q：php-fpm 可以加速 php 脚本处理速度吗？
a：不，它不会影响处理速度。不过，如果你使用一些特殊特性，对于一些特定的请求还是可以有性能提升的。
q：如果我把我的网站从 mod_php 迁移到 php-fpm ，我会得到性能提升吗？
a：通常，当有服务器上有大量空闲内存可用时，能从迁移到 php-fpm 中得到的性能提升可能不大。但是如果内存并不充裕，性能提升还是很可观的，在某些情况下可以达到 300-500%。这可能是由于 nginx + php-fpm 一般会比 apache + mod_php 使用更少的内存。而且 vfs 缓存会由于更多的空余内存而更有效地工作。
q：php- fpm 将来会被官方的 php 包含吗？
a：我希望如此。目前，php-fpm 代码的协议是 gpl 。所以现在 php-fpm 的代码与 php 协议（类似 bsd）并不匹配。这是临时性措施。这样的选择是为了简化开发过程。一旦代码的功能完备，比如自适应生成子进程和其他一些东西，协议会改为一个相匹配的。之后，php-fpm 会正式发布给 php 开发团队，并被建议包含。