php-fpm.conf配置文件中文說明詳解及重要參數(shù)說明

php-fpm工作流程

php-fpm全名是PHP FastCGI進(jìn)程管理器

php-fpm啟動(dòng)后會先讀php.ini，然后再讀相應(yīng)的conf配置文件，conf配置可以覆蓋php.ini的配置。

啟動(dòng)php-fpm之后，會創(chuàng)建一個(gè)master進(jìn)程，監(jiān)聽9000端口（可配置），master進(jìn)程又會根據(jù)fpm.conf/www.conf去創(chuàng)建若干子進(jìn)程，子進(jìn)程用于處理實(shí)際的業(yè)務(wù)。

當(dāng)有客戶端（比如nginx）來連接9000端口時(shí)，空閑子進(jìn)程會自己去accept，如果子進(jìn)程全部處于忙碌狀態(tài)，新進(jìn)的待accept的連接會被master放進(jìn)隊(duì)列里，等待fpm子進(jìn)程空閑；

這個(gè)存放待accept的半連接的隊(duì)列有多長，由 listen.backlog 配置。

php-fpm全局配置說明

配置里面的所有相對路徑，都是相對于php的安裝路徑。

除了有php-fpm.conf配置文件外，通常還有其他的*.conf配置文件（也可以不要，直接在php-fpm.conf配置）用于配置進(jìn)程池，不同的進(jìn)程池可以用不同的用戶執(zhí)行，監(jiān)聽不同的端口，處理不同的任務(wù)；多個(gè)進(jìn)程池共用一個(gè)全局配置。

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

php-fpm全局配置參數(shù)中文說明：

pid = /opt/remi/php56/root/var/run/php-fpm/php-fpm.pid 
#pid進(jìn)程文件，默認(rèn)為none。

error_log = /opt/remi/php56/root/var/log/php-fpm/error.log 
#錯(cuò)誤日志位置，默認(rèn)：安裝路徑 #INSTALL_PREFIX#/log/php-fpm.log。如果設(shè)置為syslog，log就會發(fā)送給syslogd服務(wù)而不會寫進(jìn)文件里。

syslog.facility = daemon 
#把日志寫進(jìn)系統(tǒng)log，linux還不夠熟悉，暫時(shí)不用理會。

syslog.ident = php-fpm 
#系統(tǒng)日志標(biāo)示，如果跑了多個(gè)fpm進(jìn)程，需要用這個(gè)來區(qū)分日志是誰的。

log_level = notice 
#日志等級，默認(rèn)notice，可選：alert, error, warning, notice, debug

emergency_restart_threshold = 60 
#配合下面emergency_restart_interval參數(shù)

emergency_restart_interval = 60s 
#如果在此參數(shù)設(shè)置的時(shí)間內(nèi)，出現(xiàn)SIGSEGV或SIGBUS的子進(jìn)程數(shù)超過emergency_restart_threshold參數(shù)設(shè)置的值，那么fpm就會優(yōu)雅的重啟，值是0表示off這個(gè)功能，可用的單位有：s秒,m分,h時(shí),d天。

process_control_timeout = 0 
#設(shè)置子進(jìn)程接受主進(jìn)程復(fù)用信號的超時(shí)時(shí)間。這個(gè)每天明白，是過了這個(gè)時(shí)間就不能復(fù)用了？

process.max = 128 
#當(dāng)動(dòng)態(tài)管理子進(jìn)程時(shí)，fpm最多能fork多少個(gè)進(jìn)程，0表示無限制，這是所有進(jìn)程池能啟動(dòng)子進(jìn)程的總和，謹(jǐn)慎使用。

process.priority = -19 
#設(shè)置子進(jìn)程的優(yōu)先級，在master進(jìn)程以root用戶啟動(dòng)時(shí)有效；如果沒有設(shè)置，子進(jìn)程會繼承master進(jìn)程的優(yōu)先級，值范圍-19(最高)到20(最低)，默認(rèn)不設(shè)置。

daemonize = yes 
#設(shè)置成no用于調(diào)試bug，默認(rèn)為yes。

rlimit_files = 1024 
#設(shè)置master進(jìn)程最多能打開的文件，默認(rèn)為系統(tǒng)的值。

rlimit_core = 0 
#master進(jìn)程核心rlimit限制值；可選unlimited或>=0的整數(shù)，默認(rèn)為系統(tǒng)的值。

events.mechanism = epoll 
#事件處理機(jī)制，默認(rèn)自動(dòng)檢測，可選值：select，poll，epoll(linux>=2.5.44)，kqueue，/dev/poll，port

systemd_interval = 10s 
#當(dāng)fpm被設(shè)置為系統(tǒng)服務(wù)時(shí)，多久向服務(wù)器報(bào)告一次狀態(tài)，單位有s,m,h。

php-fpm進(jìn)程池配置 pool Definitions：

在不同的監(jiān)聽端口和不同的管理選項(xiàng)下可以跑任意數(shù)量的池，并沒有個(gè)數(shù)限制；

池的名字用于 logs 和 stats。

user = apache

group = apache

#以什么用戶什么組的權(quán)限來運(yùn)行池fpm。

用apache可以像httpd服務(wù)一樣去訪問某些目錄

listen = 127.0.0.1:9000 
#監(jiān)聽的ip和端口，可以 /path/to/unix/socket 來監(jiān)聽unix socket，性能更好。

listen.backlog = 65535 
#未accept處理的socket隊(duì)列大小，-1 on FreeBSD and OpenBSD，其他平臺默認(rèn)65535，高并發(fā)時(shí)重要，合理設(shè)置會及時(shí)處理排隊(duì)的請求；太大會積壓太多，處理完后nginx在前面都等超時(shí)斷開這個(gè)和fpm的socket連接了，就杯具了。不要用-1，建議1024以上，最好是2的冪值。

#一個(gè)池共用一個(gè)backlog隊(duì)列，所有的池進(jìn)程都去這個(gè)隊(duì)列里accept連接。

#最大數(shù)量受限于系統(tǒng)配置 cat /proc/sys/net/core/somaxconn，系統(tǒng)配置修改：vim /etc/sysctl.conf，增加 net.core.somaxconn = 2000 則最大為2000，然后php最大的backlog可以到2000。

listen.owner = apache

listen.group = apache

listen.mode = 0660

#用socket連接方式時(shí)，指定擁有unix socket權(quán)限的用戶，默認(rèn)和運(yùn)行的用戶一樣；用tcp連接可以注釋掉

listen.allowed_clients = 127.0.0.1 
#設(shè)置允許連接fpm的地址，比如nginx就要來連，多個(gè)地址用逗號隔開，如果不配置，則默認(rèn)任意地址都能來連。

process.priority = -19 
#池進(jìn)程的權(quán)限，同樣要master進(jìn)程是root用戶才有效，和全局那個(gè)一樣，不設(shè)置的話會繼承master進(jìn)程的優(yōu)先級。

pm = dynamic 
#啟動(dòng)時(shí)子進(jìn)程管理方式，可選值：static(啟動(dòng)時(shí)創(chuàng)建指定個(gè)數(shù))， dynamic(啟動(dòng)時(shí)根據(jù)情況創(chuàng)建，至少有一個(gè))， ondemand(啟動(dòng)時(shí)不創(chuàng)建子進(jìn)程，有需求才創(chuàng)建)

pm.max_children = 5 
#該池同時(shí)最多存在5個(gè)進(jìn)程， 三種管理方式都要配置

pm.start_servers = 2 
#fpm啟動(dòng)時(shí)創(chuàng)建2個(gè)子進(jìn)程，只適用動(dòng)態(tài)dynamic管理方式

pm.min_spare_servers = 2 
#服務(wù)器閑置時(shí)最少保持2個(gè)子進(jìn)程，不夠這個(gè)數(shù)就會創(chuàng)建，只適用動(dòng)態(tài)dynamic管理方式

pm.max_spare_servers = 3 
#服務(wù)器閑置時(shí)最多要有幾個(gè)，多了會kill，只適用動(dòng)態(tài)dynamic管理方式

pm.process_idle_timeout = 10s
#子進(jìn)程閑置10s后就會被殺掉。

pm.max_requests = 500 
#每個(gè)子進(jìn)程最大處理500請求就被回收，可防止內(nèi)存泄露。

pm.status_path string

#FPM 狀態(tài)頁面的網(wǎng)址。如果沒有設(shè)置，則無法訪問狀態(tài)頁面，默認(rèn)值：無。

ping.path string

#FPM 監(jiān)控頁面的 ping 網(wǎng)址。如果沒有設(shè)置，則無法訪問 ping 頁面。該頁面用于外部檢測 FPM 是否存活并且可以響應(yīng)請求。請注意必須以斜線開頭（/）。

ping.response string
#用于定義 ping 請求的返回響應(yīng)。返回為 HTTP 200 的 text/plain 格式文本。默認(rèn)值：pong。

process.priority int
#設(shè)置 worker 的 nice(2)優(yōu)先級（如果設(shè)置了的話）。 該值從 -19（最高優(yōu)先級） 到 20（更低優(yōu)先級）。 默認(rèn)值：不設(shè)置

prefix string
#檢測路徑時(shí)使用的前綴

access.log = var/log/$pool.access.log 
#訪問文件日志，沒啥用處，比如yii2每次都記錄訪問index.php，只是記錄真實(shí)的PHP文件。

slowlog = var/log/$pool.log.slow 
#PHP文件執(zhí)行過慢的日志，會準(zhǔn)確的記錄具體哪一行代碼太慢，這個(gè)非常有用，在設(shè)置了時(shí)間時(shí)生效。

request_slowlog_timeout = 2s 
#超過這個(gè)運(yùn)行時(shí)間就會寫慢日志

request_terminate_timeout = 3s 
#單個(gè)請求的超時(shí)時(shí)間，有時(shí)候php.ini設(shè)置的最大執(zhí)行時(shí)間未生效，這個(gè)就會來干掉那個(gè)執(zhí)行太久的請求。

rlimit_files = 1024 
#最大打開句柄數(shù)，默認(rèn)為系統(tǒng)值。

rlimit_core = 0 
#最多的核心使用數(shù)，默認(rèn)為系統(tǒng)分配。

chroot = /path 
#路徑必須是絕對路徑，改變子進(jìn)程的跟目錄，可以把進(jìn)程對文件系統(tǒng)的讀寫與實(shí)際的操作系統(tǒng)文件系統(tǒng)隔離，對安全有好處。

chdir = /var/www 

#改變當(dāng)前工作目錄，可以用相對路徑，默認(rèn)是當(dāng)前目錄或者chroot。

catch_workers_output = yes 
#重定向標(biāo)準(zhǔn)輸出stdout和標(biāo)準(zhǔn)錯(cuò)誤stderr到主錯(cuò)誤日志，如果不設(shè)置，這兩個(gè)日志就會定向到/dev/null，在高負(fù)載情況下，這個(gè)配置會引起頁面延遲幾毫秒，默認(rèn)不開啟。

clear_env = no 
#創(chuàng)建work進(jìn)程時(shí)是否清除環(huán)境變量，如果是yes，那么該子進(jìn)程 getenv() 就訪問不到 $_ENV 和$_SERVER 了。

security.limit_extensions = .php .php3 .php4 .php5 
#為了安全，限制能執(zhí)行的腳本后綴

#為當(dāng)前池指定另外的 php.ini 配置，比如指定當(dāng)前池的錯(cuò)誤日志寫在哪個(gè)地方

php_value/php_flag 
#可以設(shè)置php.ini的內(nèi)容，可以被ini_set覆蓋

php_admin_value/php_admin_flag 
#這個(gè)同上，但是不會被ini_set覆蓋。

#其中flag設(shè)置的，值只能是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

#這種方法設(shè)置 `disable_functions` 和 `disable_classes` 時(shí)，不會覆蓋 php.ini 的設(shè)置，只會追加。

注意：PHP配置值通過 php_value 或者 php_flag 設(shè)置，并且會覆蓋以前的值。
disable_functions 或者 disable_classes 在 php.ini 之中定義的值不會被覆蓋掉，但是會將新的設(shè)置附加在原有值的后面。
使用 php_admin_value 或者 php_admin_flag 定義的值，不能被 PHP 代碼中的 ini_set() 覆蓋。

自 5.3.3 起，也可以通過 web 服務(wù)器設(shè)置 PHP 的設(shè)定。

nginx 通過 unixsock 與 php-fpm 通信：

適用場景：nginx和php-fpm在同一臺服務(wù)器上，這時(shí)可以直接用unixsocket進(jìn)程間通信，不走tcp端口通信，可以節(jié)約創(chuàng)建連接的時(shí)間，從而提高性能。

1、設(shè)置php-fpm的listen為/opt/remi/php56/root/var/run/php-fpm/php567-fpm.sock(可以用相對路徑)，然后重啟fpm就會自動(dòng)創(chuàng)建該php567-fpm.sock文件

2、nginx的fastcgi_pass參數(shù)修改為 unix:/opt/remi/php56/root/var/run/php-fpm/php567-fpm.sock; 通過php567-fpm.sock文件去和fpm通信，需要保證該 php567-fpm.sock 文件 nginx 有權(quán)限訪問。

總結(jié)：

sock文件隨便創(chuàng)建到哪里都可以，只要fpm有權(quán)限在那個(gè)目錄里寫文件，nginx有權(quán)限去讀就可以。tcp連接會更穩(wěn)定，因?yàn)橛衪cp協(xié)議保證數(shù)據(jù)的正確性，但是sock有更少的數(shù)據(jù)拷貝和上下文切換，更少的資源占用。不過只能在nginx和fpm在同一臺機(jī)器上才能用sock。

php-fpm進(jìn)程狀態(tài)監(jiān)控

1、nginx配置：遇到 status 的請求，直接轉(zhuǎn)發(fā)給php

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，在瀏覽器里訪問就能看到了：

默認(rèn)以 text/plain 展示結(jié)果，可以傳參數(shù) ?json/html/xml 分別得到j(luò)son等格式的結(jié)果；參數(shù)full可以查看每個(gè)子進(jìn)程的明細(xì)

pool 進(jìn)程池名稱

process manager 進(jìn)程管理方式

start time 進(jìn)程什么時(shí)候啟動(dòng)的

start since 進(jìn)程已經(jīng)運(yùn)行了多少秒

accepted conn 該池總共accept了多少連接

listen queue 等待accept的連接的數(shù)量

max listen queue fpm啟動(dòng)后，歷史最高等待accept的連接的數(shù)量

listen queue len 配置的監(jiān)聽隊(duì)列最大長度 受限于`listen.backlog`和系統(tǒng)`cat /proc/sys/net/core/somaxconn`，兩者中取最小值

idle processes 閑置的進(jìn)程數(shù)

active process 正在工作的進(jìn)程數(shù)（加上限制的，就是總的子進(jìn)程數(shù)）

total processes 總的子進(jìn)程數(shù)量

max active processes fpm啟動(dòng)后，歷史最多同時(shí)工作的進(jìn)程數(shù)

max children reached 進(jìn)程管理模式為 'dynamic'和 'ondemand'時(shí)，此數(shù)值是當(dāng)子進(jìn)程不夠用時(shí)，master創(chuàng)建更多子進(jìn)程的次數(shù)

slow requests 慢請求個(gè)數(shù)

full參數(shù)下

pid 子進(jìn)程ID;

state 子進(jìn)程狀態(tài)(Idle, Running, ...);

start time 子進(jìn)程啟動(dòng)的時(shí)間;

start since 子進(jìn)程啟動(dòng)后運(yùn)行了多少秒;

requests 當(dāng)前子進(jìn)程一共處理了多少個(gè)請求;

request duration 請求耗費(fèi)的納秒數(shù);

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

request URI 請求參數(shù);

content length POST請求時(shí)，請求的內(nèi)容長度;

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

script 請求的哪個(gè)php文件;

last request cpu 上次請求耗費(fèi)的cpu資源

last request memory 上次請求耗費(fèi)的內(nèi)存峰值

如果進(jìn)程是閑置狀態(tài)，那這些信息記錄的就是上次請求的相關(guān)數(shù)據(jù)，否則就是當(dāng)前本次請求的相關(guān)數(shù)據(jù)。

backlog配置問題

一個(gè)fpm子進(jìn)程在同一時(shí)間只能處理一個(gè)請求，如果，backlog設(shè)置得過大，nginx之類的客戶端發(fā)起的請求一直沒有fpm子進(jìn)程進(jìn)行accept，nginx就會直接斷掉這個(gè)連接，等fpm忙過來了再去accept的時(shí)候，就會發(fā)現(xiàn)斷開了，于是報(bào)錯(cuò)。backlog設(shè)置得過小，訪問量大時(shí)fpm子進(jìn)程全部處于忙碌狀態(tài)，backlog也塞滿了，就會拒絕新的連接，此時(shí)nginx再請求，就會直接被拒。所以需要合理的設(shè)置backlog參數(shù)。

大部分參數(shù)只要系統(tǒng)默認(rèn)的就可以了，我們只需要知道幾個(gè)比較重要的參數(shù)設(shè)置，什么時(shí)候用到可以回頭查詢相關(guān)說明