php-fpm.conf配置文件中文及重要参数说明

互联网 20-8-8

php-fpm工作流程

php-fpm全名是PHP FastCGI进程管理器

php-fpm启动后会先读php.ini，然后再读相应的conf配置文件，conf配置可以覆盖php.ini的配置。

启动php-fpm之后，会创建一个master进程，监听9000端口（可配置），master进程又会根据fpm.conf/www.conf去创建若干子进程，子进程用于处理实际的业务。

当有客户端（比如nginx）来连接9000端口时，空闲子进程会自己去accept，如果子进程全部处于忙碌状态，新进的待accept的连接会被master放进队列里，等待fpm子进程空闲；

这个存放待accept的半连接的队列有多长，由 listen.backlog 配置。

相关学习推荐：php编程（视频）

配置里面的所有相对路径，都是相对于php的安装路径。

除了有php-fpm.conf配置文件外，通常还有其他的*.conf配置文件（也可以不要，直接在php-fpm.conf配置）用于配置进程池，不同的进程池可以用不同的用户执行，监听不同的端口，处理不同的任务；多个进程池共用一个全局配置。

include=/opt/remi/php56/root/etc/php-fpm.d/*.conf 载入其他的配置文件。

php-fpm全局配置参数中文说明：

php-fpm进程池配置 pool Definitions：

在不同的监听端口和不同的管理选项下可以跑任意数量的池，并没有个数限制；

池的名字用于 logs 和 stats。

user = apache
group = apache
#以什么用户什么组的权限来运行池fpm。
用apache可以像httpd服务一样去访问某些目录
#一个池共用一个backlog队列，所有的池进程都去这个队列里accept连接。
#最大数量受限于系统配置 cat /proc/sys/net/core/somaxconn，系统配置修改：vim /etc/sysctl.conf，增加 net.core.somaxconn = 2000 则最大为2000，然后php最大的backlog可以到2000。
listen.owner = apache
listen.group = apache
listen.mode = 0660
#用socket连接方式时，指定拥有unix socket权限的用户，默认和运行的用户一样；用tcp连接可以注释掉
pm.status_path string
#FPM 状态页面的网址。如果没有设置，则无法访问状态页面，默认值：无。
ping.path string
#FPM 监控页面的 ping 网址。如果没有设置，则无法访问 ping 页面。该页面用于外部检测 FPM 是否存活并且可以响应请求。请注意必须以斜线开头（/）。
chdir = /var/www
#改变当前工作目录，可以用相对路径，默认是当前目录或者chroot。
#为当前池指定另外的 php.ini 配置，比如指定当前池的错误日志写在哪个地方
#其中flag设置的，值只能是on, off, 1, 0, true, false, yes or no，其他类型的值需要用value。
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
#这种方法设置 `disable_functions` 和 `disable_classes` 时，不会覆盖 php.ini 的设置，只会追加。

注意：PHP配置值通过 php_value 或者 php_flag 设置，并且会覆盖以前的值。disable_functions 或者 disable_classes 在 php.ini 之中定义的值不会被覆盖掉，但是会将新的设置附加在原有值的后面。使用 php_admin_value 或者 php_admin_flag 定义的值，不能被 PHP 代码中的 ini_set() 覆盖。

自 5.3.3 起，也可以通过 web 服务器设置 PHP 的设定。

nginx 通过 unixsock 与 php-fpm 通信：

适用场景：nginx和php-fpm在同一台服务器上，这时可以直接用unixsocket进程间通信，不走tcp端口通信，可以节约创建连接的时间，从而提高性能。

1、设置php-fpm的listen为/opt/remi/php56/root/var/run/php-fpm/php567-fpm.sock(可以用相对路径)，然后重启fpm就会自动创建该php567-fpm.sock文件

2、nginx的fastcgi_pass参数修改为 unix:/opt/remi/php56/root/var/run/php-fpm/php567-fpm.sock; 通过php567-fpm.sock文件去和fpm通信，需要保证该 php567-fpm.sock 文件 nginx 有权限访问。

总结：

sock文件随便创建到哪里都可以，只要fpm有权限在那个目录里写文件，nginx有权限去读就可以。tcp连接会更稳定，因为有tcp协议保证数据的正确性，但是sock有更少的数据拷贝和上下文切换，更少的资源占用。不过只能在nginx和fpm在同一台机器上才能用sock。

php-fpm进程状态监控

location ~^/status$ {
fastcgi_param SCRIPT_FILENAME $fastcgi_script_name;
include fastcgi_params;
fastcgi_pass 127.0.0.1:9000;
}

2、fpm配置：pm.status_path = /status

3、然后重新fpm和nginx，在浏览器里访问就能看到了：

默认以 text/plain 展示结果，可以传参数 ?json/html/xml 分别得到json等格式的结果；参数full可以查看每个子进程的明细

pool 进程池名称

process manager 进程管理方式

start time 进程什么时候启动的

start since 进程已经运行了多少秒

accepted conn 该池总共accept了多少连接

listen queue 等待accept的连接的数量

max listen queue fpm启动后，历史最高等待accept的连接的数量

listen queue len 配置的监听队列最大长度受限于`listen.backlog`和系统`cat /proc/sys/net/core/somaxconn`，两者中取最小值

idle processes 闲置的进程数

active process 正在工作的进程数（加上限制的，就是总的子进程数）

total processes 总的子进程数量

max active processes fpm启动后，历史最多同时工作的进程数

max children reached 进程管理模式为 'dynamic'和 'ondemand'时，此数值是当子进程不够用时，master创建更多子进程的次数

slow requests 慢请求个数

full参数下

pid 子进程ID;

state 子进程状态(Idle, Running, ...);

start time 子进程启动的时间;

start since 子进程启动后运行了多少秒;

requests 当前子进程一共处理了多少个请求;

request duration 请求耗费的纳秒数;

request method 请求方法 (GET, POST, ...);

request URI 请求参数;

content length POST请求时，请求的内容长度;

user - the user (PHP_AUTH_USER) (or '-' if not set);

script 请求的哪个php文件;

last request cpu 上次请求耗费的cpu资源

last request memory 上次请求耗费的内存峰值

如果进程是闲置状态，那这些信息记录的就是上次请求的相关数据，否则就是当前本次请求的相关数据。

backlog配置问题

一个fpm子进程在同一时间只能处理一个请求，如果，backlog设置得过大，nginx之类的客户端发起的请求一直没有fpm子进程进行accept，nginx就会直接断掉这个连接，等fpm忙过来了再去accept的时候，就会发现断开了，于是报错。backlog设置得过小，访问量大时fpm子进程全部处于忙碌状态，backlog也塞满了，就会拒绝新的连接，此时nginx再请求，就会直接被拒。所以需要合理的设置backlog参数。