php-fpm 啟動(dòng)參數(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ù)
#測(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ù)詳解
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)值即可葵诈。可用格式為: '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)程的帳戶(hù)和組
pm = dynamic #對(duì)于專(zhuān)用服務(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 將給用戶(hù)返回“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ù)。
$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ò)誤：
1pm.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è)置慢日志的存放位置
1tail -f /var/log/www.slow.log
上面的命令即可看到執(zhí)行過(guò)慢的php過(guò)程魄梯。
大家可以看到經(jīng)常出現(xiàn)的網(wǎng)絡(luò)讀取超過(guò)、Mysql查詢(xún)過(guò)慢的問(wèn)題宾符，根據(jù)提示信息再排查問(wèn)題就有很明確的方向了酿秸。
