PHP-FPM參數(shù)詳解

約定幾個(gè)目錄

/usr/local/php/sbin/php-fpm
/usr/local/php/etc/php-fpm.conf
/usr/local/php/etc/php.ini
一，php-fpm的啟動(dòng)參數(shù)

復(fù)制代碼代碼如下:

#測(cè)試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

#啟動(dòng)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

#關(guān)閉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重要參數(shù)詳解

復(fù)制代碼代碼如下:

pid = run/php-fpm.pid
#pid設(shè)置，默認(rèn)在安裝目錄中的var/run/php-fpm.pid，建議開(kāi)啟

error_log = log/php-fpm.log
#錯(cuò)誤日志，默認(rèn)在安裝目錄中的var/log/php-fpm.log

log_level = notice
#錯(cuò)誤級(jí)別. 可用級(jí)別為: alert（必須立即處理）, error（錯(cuò)誤情況）, warning（警告情況）, notice（一般重要信息）, debug（調(diào)試信息）. 默認(rèn): notice.

emergency_restart_threshold = 60
emergency_restart_interval = 60s
#表示在emergency_restart_interval所設(shè)值內(nèi)出現(xiàn)SIGSEGV或者SIGBUS錯(cuò)誤的php-cgi進(jìn)程數(shù)如果超過(guò) emergency_restart_threshold個(gè)，php-fpm就會(huì)優(yōu)雅重啟。這兩個(gè)選項(xiàng)一般保持默認(rèn)值。

process_control_timeout = 0
#設(shè)置子進(jìn)程接受主進(jìn)程復(fù)用信號(hào)的超時(shí)時(shí)間. 可用單位: s(秒), m(分), h(小時(shí)), 或者 d(天) 默認(rèn)單位: s(秒). 默認(rèn)值: 0.

daemonize = yes
#后臺(tái)執(zhí)行fpm,默認(rèn)值為yes，如果為了調(diào)試可以改為no。在FPM中，可以使用不同的設(shè)置來(lái)運(yùn)行多個(gè)進(jìn)程池。這些設(shè)置可以針對(duì)每個(gè)進(jìn)程池單獨(dú)設(shè)置。

listen = 127.0.0.1:9000
#fpm監(jiān)聽(tīng)端口，即nginx中php處理的地址，一般默認(rèn)值即可?？捎酶袷綖?/span>: 'ip:port', 'port','/path/to/unix/socket'. 每個(gè)進(jìn)程池都需要設(shè)置.

listen.backlog = -1
#backlog數(shù)，-1表示無(wú)限制，由操作系統(tǒng)決定，此行注釋掉就行。backlog含義參考：http://www.3gyou.cc/?p=41

listen.allowed_clients = 127.0.0.1
#允許訪問(wèn)FastCGI進(jìn)程的IP，設(shè)置any為不限制IP，如果要設(shè)置其他主機(jī)的nginx也能訪問(wèn)這臺(tái)FPM進(jìn)程，listen處要設(shè)置成本地可被訪問(wèn)的IP。默認(rèn)值是any。每個(gè)地址是用逗號(hào)分隔. 如果沒(méi)有設(shè)置或者為空，則允許任何服務(wù)器請(qǐng)求連接

listen.owner = www
listen.group = www
listen.mode = 0666
#unix socket設(shè)置選項(xiàng)，如果使用tcp方式訪問(wèn)，這里注釋即可。

user = www
group = www
#啟動(dòng)進(jìn)程的帳戶和組

pm = dynamic #對(duì)于專用服務(wù)器，pm可以設(shè)置為static。
#如何控制子進(jìn)程，選項(xiàng)有static和dynamic。如果選擇static，則由pm.max_children指定固定的子進(jìn)程數(shù)。如果選擇dynamic，則由下開(kāi)參數(shù)決定：
pm.max_children #，子進(jìn)程最大數(shù)
pm.start_servers #，啟動(dòng)時(shí)的進(jìn)程數(shù)
pm.min_spare_servers #，保證空閑進(jìn)程數(shù)最小值，如果空閑進(jìn)程小于此值，則創(chuàng)建新的子進(jìn)程
pm.max_spare_servers #，保證空閑進(jìn)程數(shù)最大值，如果空閑進(jìn)程大于此值，此進(jìn)行清理

pm.max_requests = 1000
#設(shè)置每個(gè)子進(jìn)程重生之前服務(wù)的請(qǐng)求數(shù). 對(duì)于可能存在內(nèi)存泄漏的第三方模塊來(lái)說(shuō)是非常有用的. 如果設(shè)置為 '0' 則一直接受請(qǐng)求. 等同于 PHP_FCGI_MAX_REQUESTS 環(huán)境變量. 默認(rèn)值: 0.

pm.status_path = /status
#FPM狀態(tài)頁(yè)面的網(wǎng)址. 如果沒(méi)有設(shè)置, 則無(wú)法訪問(wèn)狀態(tài)頁(yè)面. 默認(rèn)值: none. munin監(jiān)控會(huì)使用到

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

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

request_terminate_timeout = 0
#設(shè)置單個(gè)請(qǐng)求的超時(shí)中止時(shí)間. 該選項(xiàng)可能會(huì)對(duì)php.ini設(shè)置中的'max_execution_time'因?yàn)槟承┨厥庠驔](méi)有中止運(yùn)行的腳本有用. 設(shè)置為 '0' 表示 'Off'.當(dāng)經(jīng)常出現(xiàn)502錯(cuò)誤時(shí)可以嘗試更改此選項(xiàng)。

request_slowlog_timeout = 10s
#當(dāng)一個(gè)請(qǐng)求該設(shè)置的超時(shí)時(shí)間后，就會(huì)將對(duì)應(yīng)的PHP調(diào)用堆棧信息完整寫(xiě)入到慢日志中. 設(shè)置為 '0' 表示 'Off'

slowlog = log/$pool.log.slow
#慢請(qǐng)求的記錄日志,配合request_slowlog_timeout使用

rlimit_files = 1024
#設(shè)置文件打開(kāi)描述符的rlimit限制. 默認(rèn)值: 系統(tǒng)定義值默認(rèn)可打開(kāi)句柄是1024，可使用 ulimit -n查看，ulimit -n 2048修改。

rlimit_core = 0
#設(shè)置核心rlimit最大限制值. 可用值: 'unlimited' 、0或者正整數(shù). 默認(rèn)值: 系統(tǒng)定義值.

chroot =
#啟動(dòng)時(shí)的Chroot目錄. 所定義的目錄需要是絕對(duì)路徑. 如果沒(méi)有設(shè)置, 則chroot不被使用.

chdir =
#設(shè)置啟動(dòng)目錄，啟動(dòng)時(shí)會(huì)自動(dòng)Chdir到該目錄. 所定義的目錄需要是絕對(duì)路徑. 默認(rèn)值: 當(dāng)前目錄，或者/目錄（chroot時(shí)）

catch_workers_output = yes
#重定向運(yùn)行過(guò)程中的stdout和stderr到主要的錯(cuò)誤日志文件中. 如果沒(méi)有設(shè)置, stdout 和 stderr 將會(huì)根據(jù)FastCGI的規(guī)則被重定向到 /dev/null . 默認(rèn)值: 空.

三，常見(jiàn)錯(cuò)誤及解決辦法整理

1、request_terminate_timeout引起的資源問(wèn)題
request_terminate_timeout的值如果設(shè)置為0或者過(guò)長(zhǎng)的時(shí)間，可能會(huì)引起file_get_contents的資源問(wèn)題。

如果file_get_contents請(qǐng)求的遠(yuǎn)程資源如果反應(yīng)過(guò)慢，file_get_contents就會(huì)一直卡在那里不會(huì)超時(shí)。我們知道php.ini 里面max_execution_time 可以設(shè)置 PHP 腳本的最大執(zhí)行時(shí)間，但是，在 php-cgi(php-fpm) 中，該參數(shù)不會(huì)起效。真正能夠控制 PHP 腳本最大執(zhí)行時(shí)間的是 php-fpm.conf 配置文件中的request_terminate_timeout參數(shù)。

request_terminate_timeout默認(rèn)值為 0 秒，也就是說(shuō)，PHP 腳本會(huì)一直執(zhí)行下去。這樣，當(dāng)所有的 php-cgi 進(jìn)程都卡在 file_get_contents()函數(shù)時(shí)，這臺(tái) Nginx+PHP 的 WebServer 已經(jīng)無(wú)法再處理新的 PHP 請(qǐng)求了，Nginx 將給用戶返回“502 Bad Gateway”。修改該參數(shù)，設(shè)置一個(gè) PHP 腳本最大執(zhí)行時(shí)間是必要的，但是，治標(biāo)不治本。例如改成 30s，如果發(fā)生file_get_contents() 獲取網(wǎng)頁(yè)內(nèi)容較慢的情況，這就意味著 150 個(gè) php-cgi 進(jìn)程，每秒鐘只能處理 5 個(gè)請(qǐng)求，WebServer 同樣很難避免”502 Bad Gateway”。解決辦法是request_terminate_timeout設(shè)置為10s或者一個(gè)合理的值，或者給file_get_contents加一個(gè)超時(shí)參數(shù)。

復(fù)制代碼代碼如下:

$ctx = stream_context_create(array(
    'http' => array(
        'timeout' => 10   //設(shè)置一個(gè)超時(shí)時(shí)間，單位為秒
    )
));

file_get_contents($str, 0, $ctx);

2,max_requests參數(shù)配置不當(dāng)，可能會(huì)引起間歇性502錯(cuò)誤：

復(fù)制代碼代碼如下:

pm.max_requests = 1000

設(shè)置每個(gè)子進(jìn)程重生之前服務(wù)的請(qǐng)求數(shù). 對(duì)于可能存在內(nèi)存泄漏的第三方模塊來(lái)說(shuō)是非常有用的. 如果設(shè)置為 '0′ 則一直接受請(qǐng)求. 等同于 PHP_FCGI_MAX_REQUESTS 環(huán)境變量. 默認(rèn)值: 0.
這段配置的意思是，當(dāng)一個(gè) PHP-CGI 進(jìn)程處理的請(qǐng)求數(shù)累積到 500 個(gè)后，自動(dòng)重啟該進(jìn)程。
但是為什么要重啟進(jìn)程呢？
一般在項(xiàng)目中，我們多多少少都會(huì)用到一些 PHP 的第三方庫(kù)，這些第三方庫(kù)經(jīng)常存在內(nèi)存泄漏問(wèn)題，如果不定期重啟 PHP-CGI 進(jìn)程，勢(shì)必造成內(nèi)存使用量不斷增長(zhǎng)。因此 PHP-FPM 作為 PHP-CGI 的管理器，提供了這么一項(xiàng)監(jiān)控功能，對(duì)請(qǐng)求達(dá)到指定次數(shù)的 PHP-CGI 進(jìn)程進(jìn)行重啟，保證內(nèi)存使用量不增長(zhǎng)。
正是因?yàn)檫@個(gè)機(jī)制，在高并發(fā)的站點(diǎn)中，經(jīng)常導(dǎo)致 502 錯(cuò)誤，我猜測(cè)原因是 PHP-FPM 對(duì)從 NGINX 過(guò)來(lái)的請(qǐng)求隊(duì)列沒(méi)處理好。不過(guò)我目前用的還是 PHP 5.3.2，不知道在 PHP 5.3.3 中是否還存在這個(gè)問(wèn)題。
目前我們的解決方法是，把這個(gè)值盡量設(shè)置大些，盡可能減少 PHP-CGI 重新 SPAWN 的次數(shù)，同時(shí)也能提高總體性能。在我們自己實(shí)際的生產(chǎn)環(huán)境中發(fā)現(xiàn)，內(nèi)存泄漏并不明顯，因此我們將這個(gè)值設(shè)置得非常大（204800）。大家要根據(jù)自己的實(shí)際情況設(shè)置這個(gè)值，不能盲目地加大。
話說(shuō)回來(lái)，這套機(jī)制目的只為保證 PHP-CGI 不過(guò)分地占用內(nèi)存，為何不通過(guò)檢測(cè)內(nèi)存的方式來(lái)處理呢？我非常認(rèn)同高春輝所說(shuō)的，通過(guò)設(shè)置進(jìn)程的峰值內(nèi)在占用量來(lái)重啟 PHP-CGI 進(jìn)程，會(huì)是更好的一個(gè)解決方案。

3,php-fpm的慢日志，debug及異常排查神器：
request_slowlog_timeout設(shè)置一個(gè)超時(shí)的參數(shù)，slowlog設(shè)置慢日志的存放位置

復(fù)制代碼代碼如下:

tail -f /var/log/www.slow.log

上面的命令即可看到執(zhí)行過(guò)慢的php過(guò)程。
大家可以看到經(jīng)常出現(xiàn)的網(wǎng)絡(luò)讀取超過(guò)、Mysql查詢過(guò)慢的問(wèn)題，根據(jù)提示信息再排查問(wèn)題就有很明確的方向了。