php-fpm.conf組態檔中文及重要參數說明
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-fpm.conf組態檔外，通常還有其他的*.conf組態檔（也可以不要，直接在php-fpm.conf設定）用於設定進程池，不同的進程池可以用不同的使用者執行，監聽不同的埠，處理不同的任務；多個進程池共用一個全域性設定。
include=/opt/remi/php56/root/etc/php-fpm.d/*.conf 載入其他的組態檔。
php-fpm全域性設定參數中文說明：
pid = /opt/remi/php56/root/var/run/php-fpm/php-fpm.pid
#pid進程檔案，預設爲none。error_log = /opt/remi/php56/root/var/log/php-fpm/error.log
#錯誤日誌位置，預設：安裝路徑 #INSTALL_PREFIX#/log/php-fpm.log。如果設定爲syslog，log就會發送給syslogd服務而不會寫進檔案裡。syslog.facility = daemon
#把日誌寫進系統log，linux還不夠熟悉，暫時不用理會。syslog.ident = php-fpm
#系統日誌標示，如果跑了多個fpm進程，需要用這個來區分日誌是誰的。log_level = notice
#日誌等級，預設notice，可選：alert, error, warning, notice, debugemergency_restart_threshold = 60
#配合下面 下麪emergency_restart_interval參數emergency_restart_interval = 60s
#如果在此參數設定的時間內，出現SIGSEGV或SIGBUS的子進程數超過emergency_restart_threshold參數設定的值，那麼fpm就會優雅的重新啓動，值是0表示off這個功能，可用的單位有：s秒,m分,h時,d天。process_control_timeout = 0
#設定子進程接受主進程複用信號的超時時間。這個每天明白，是過了這個時間就不能複用了？process.max = 128
#當動態管理子進程時，fpm最多能fork多少個進程，0表示無限制，這是所有進程池能啓動子進程的總和，謹慎使用。process.priority = -19
#設定子進程的優先順序，在master進程以root使用者啓動時有效；如果沒有設定，子進程會繼承master進程的優先順序，值範圍-19(最高)到20(最低)，預設不設定。daemonize = yes
#設定成no用於偵錯bug，預設爲yes。rlimit_files = 1024
#設定master進程最多能開啓的檔案，預設爲系統的值。rlimit_core = 0
#master進程核心rlimit限制值；可選unlimited或>=0的整數，預設爲系統的值。events.mechanism = epoll
#事件處理機制 機製，預設自動檢測，可選值：select，poll，epoll(linux>=2.5.44)，kqueue，/dev/poll，portsystemd_interval = 10s
#當fpm被設定爲系統服務時，多久向伺服器報告一次狀態，單位有s,m,h。
php-fpm進程池設定 pool Definitions：
在不同的監聽埠和不同的管理選項下可以跑任意數量的池，並沒有個數限制；
池的名字用於 logs 和 stats。
user = apache
group = apache
#以什麼使用者什麼組的許可權來執行池fpm。
用apache可以像httpd服務一樣去存取某些目錄
listen = 127.0.0.1:9000
#監聽的ip和埠，可以 /path/to/unix/socket 來監聽unix socket，效能更好。listen.backlog = 65535
#未accept處理的socket佇列大小，-1 on FreeBSD and OpenBSD，其他平臺預設65535，高併發時重要，合理設定會及時處理排隊的請求；太大會積壓太多，處理完後nginx在前面都等超時斷開這個和fpm的socket連線了，就杯具了。不要用-1，建議1024以上，最好是2的冪值。#一個池共用一個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連線可以註釋掉
listen.allowed_clients = 127.0.0.1
#設定允許連線fpm的地址，比如nginx就要來連，多個地址用逗號隔開，如果不設定，則預設任意地址都能來連。process.priority = -19
#池進程的許可權，同樣要master進程是root使用者纔有效，和全域性那個一樣，不設定的話會繼承master進程的優先順序。pm = dynamic
#啓動時子進程管理方式，可選值：static(啓動時建立指定個數)， dynamic(啓動時根據情況建立，至少有一個)， ondemand(啓動時不建立子進程，有需求才建立)pm.max_children = 5
#該池同時最多存在5個進程， 三種管理方式都要設定pm.start_servers = 2
#fpm啓動時建立2個子進程，只適用動態dynamic管理方式pm.min_spare_servers = 2
#伺服器閒置時最少保持2個子進程，不夠這個數就會建立，只適用動態dynamic管理方式pm.max_spare_servers = 3
#伺服器閒置時最多要有幾個，多了會kill，只適用動態dynamic管理方式pm.process_idle_timeout = 10s
#子進程閒置10s後就會被殺掉。pm.max_requests = 500
#每個子進程最大處理500請求就被回收，可防止記憶體泄露。pm.status_path string
#FPM 狀態頁面的網址。如果沒有設定，則無法存取狀態頁面，預設值：無。
ping.path string
#FPM 監控頁面的 ping 網址。如果沒有設定，則無法存取 ping 頁面。該頁面用於外部檢測 FPM 是否存活並且可以響應請求。請注意必須以斜線開頭（/）。
ping.response string
#用於定義 ping 請求的返迴響應。返回爲 HTTP 200 的 text/plain 格式文字。預設值：pong。process.priority int
#設定 worker 的 nice(2)優先順序（如果設定了的話）。 該值從 -19（最高優先順序） 到 20（更低優先順序）。 預設值：不設定prefix string
#檢測路徑時使用的字首access.log = var/log/$pool.access.log
#存取檔案日誌，沒啥用處，比如yii2每次都記錄存取index.php，只是記錄真實的PHP檔案。slowlog = var/log/$pool.log.slow
#PHP檔案執行過慢的日誌，會準確的記錄具體哪一行程式碼太慢，這個非常有用，在設定了時間時生效。request_slowlog_timeout = 2s
#超過這個執行時間就會寫慢日誌request_terminate_timeout = 3s
#單個請求的超時時間，有時候php.ini設定的最大執行時間未生效，這個就會來幹掉那個執行太久的請求。rlimit_files = 1024
#最大開啓控制代碼數，預設爲系統值。rlimit_core = 0
#最多的核心使用數，預設爲系統分配。chroot = /path
#路徑必須是絕對路徑，改變子進程的跟目錄，可以把進程對檔案系統的讀寫與實際的操作系統檔案系統隔離，對安全有好處。chdir = /var/www
#改變當前工作目錄，可以用相對路徑，預設是當前目錄或者chroot。
catch_workers_output = yes
#重定向標準輸出stdout和標準錯誤stderr到主錯誤日誌，如果不設定，這兩個日誌就會定向到/dev/null，在高負載情況下，這個設定會引起頁面延遲幾毫秒，預設不開啓。clear_env = no
#建立work進程時是否清除環境變數，如果是yes，那麼該子進程 getenv() 就存取不到 $_ENV 和$_SERVER 了。security.limit_extensions = .php .php3 .php4 .php5
#爲了安全，限制能執行的指令碼後綴#爲當前池指定另外的 php.ini 設定，比如指定當前池的錯誤日誌寫在哪個地方
php_value/php_flag
#可以設定php.ini的內容，可以被ini_set覆蓋php_admin_value/php_admin_flag
#這個同上，但是不會被ini_set覆蓋。#其中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進程狀態監控
1、nginx設定：遇到 status 的請求，直接轉發給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，在瀏覽器裡存取就能看到了：
預設以 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參數。
大部分參數只要系統預設的就可以了，我們只需要知道幾個比較重要的參數設定，什麼時候用到可以回頭查詢相關說明
相關推薦：
以上就是php-fpm.conf組態檔中文及重要參數說明的詳細內容，更多請關注php中文網其它相關文章！