php-fpm 啟動參數及重要配置詳解

 　　約定幾個目錄

　　/usr/local/php/sbin/php-fpm

　　/usr/local/php/etc/php-fpm.conf

　　/usr/local/php/etc/php.ini

　　一，php-fpm的啟動參數

　　#測試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

　　#啟動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

　　#關閉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重要參數詳解

　　pid = run/php-fpm.pid

　　#pid設置，默認在安裝目錄中的var/run/php-fpm.pid，建議開啟

　　error_log = log/php-fpm.log

　　#錯誤日志，默認在安裝目錄中的var/log/php-fpm.log

　　log_level = notice

　　#錯誤級別. 可用級別為: alert(必須立即處理), error(錯誤情況), warning(警告情況), notice(一般重要信息), debug(調試信息). 默認: notice.

　　emergency_restart_threshold = 60

　　emergency_restart_interval = 60s

　　#表示在emergency_restart_interval所設值內出現SIGSEGV或者SIGBUS錯誤的php-cgi進程數如果超過 emergency_restart_threshold個，php-fpm就會優雅重啟。這兩個選項一般保持默認值。

　　process_control_timeout = 0

　　#設置子進程接受主進程復用信號的超時時間. 可用單位: s(秒), m(分), h(小時), 或者 d(天) 默認單位: s(秒). 默認值: 0.

　　daemonize = yes

　　#後台執行fpm,默認值為yes，如果為了調試可以改為no。在FPM中，可以使用不同的設置來運行多個進程池。 這些設置可以針對每個進程池單獨設置。

　　listen = 127.0.0.1:9000

　　#fpm監聽端口，即nginx中php處理的地址，一般默認值即可。可用格式為: 'ip:port', 'port', '/path/to/unix/socket'. 每個進程池都需要設置.

　　listen.backlog = -1

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

　　listen.allowed_clients = 127.0.0.1

　　#允許訪問FastCGI進程的IP，設置any為不限制IP，如果要設置其他主機的nginx也能訪問這台FPM進程，listen處要設置成本地可被訪問的IP。默認值是any。每個地址是用逗號分隔. 如果沒有設置或者為空，則允許任何服務器請求連接

　　listen.owner = www

　　listen.group = www

　　listen.mode = 0666

　　#unix socket設置選項，如果使用tcp方式訪問，這裡注釋即可。

　　user = www

　　group = www

　　#啟動進程的帳戶和組

　　pm = dynamic #對於專用服務器，pm可以設置為static。

　　#如何控制子進程，選項有static和dynamic。如果選擇static，則由pm.max_children指定固定的子進程數。如果選擇dynamic，則由下開參數決定：

　　pm.max_children #，子進程最大數

　　pm.start_servers #，啟動時的進程數

　　pm.min_spare_servers #，保證空閒進程數最小值，如果空閒進程小於此值，則創建新的子進程

　　pm.max_spare_servers #，保證空閒進程數最大值，如果空閒進程大於此值，此進行清理

　　pm.max_requests = 1000

　　#設置每個子進程重生之前服務的請求數. 對於可能存在內存洩漏的第三方模塊來說是非常有用的. 如果設置為 '0' 則一直接受請求. 等同於 PHP_FCGI_MAX_REQUESTS 環境變量. 默認值: 0.

　　pm.status_path = /status

　　#FPM狀態頁面的網址. 如果沒有設置, 則無法訪問狀態頁面. 默認值: none. munin監控會使用到

　　ping.path = /ping

　　#FPM監控頁面的ping網址. 如果沒有設置, 則無法訪問ping頁面. 該頁面用於外部檢測FPM是否存活並且可以響應請求. 請注意必須以斜線開頭 (/)。

　　ping.response = pong

　　#用於定義ping請求的返回相應. 返回為 HTTP 200 的 text/plain 格式文本. 默認值: pong.

　　request_terminate_timeout = 0

　　#設置單個請求的超時中止時間. 該選項可能會對php.ini設置中的'max_execution_time'因為某些特殊原因沒有中止運行的腳本有用. 設置為 '0' 表示 'Off'.當經常出現502錯誤時可以嘗試更改此選項。

　　request_slowlog_timeout = 10s

　　#當一個請求該設置的超時時間後，就會將對應的PHP調用堆棧信息完整寫入到慢日志中. 設置為 '0' 表示 'Off'

　　slowlog = log/$pool.log.slow

　　#慢請求的記錄日志,配合request_slowlog_timeout使用

　　rlimit_files = 1024

　　#設置文件打開描述符的rlimit限制. 默認值: 系統定義值默認可打開句柄是1024，可使用 ulimit -n查看，ulimit -n 2048修改。

　　rlimit_core = 0

　　#設置核心rlimit最大限制值. 可用值: 'unlimited' 、0或者正整數. 默認值: 系統定義值.

　　chroot =

　　#啟動時的Chroot目錄. 所定義的目錄需要是絕對路徑. 如果沒有設置, 則chroot不被使用.

　　chdir =

　　#設置啟動目錄，啟動時會自動Chdir到該目錄. 所定義的目錄需要是絕對路徑. 默認值: 當前目錄，或者/目錄(chroot時)

　　catch_workers_output = yes

　　#重定向運行過程中的stdout和stderr到主要的錯誤日志文件中. 如果沒有設置, stdout 和 stderr 將會根據FastCGI的規則被重定向到 /dev/null . 默認值: 空.

　　三，常見錯誤及解決辦法整理

　　1,request_terminate_timeout引起的資源問題

　　request_terminate_timeout的值如果設置為0或者過長的時間，可能會引起file_get_contents的資源問題。

　　如果file_get_contents請求的遠程資源如果反應過慢，file_get_contents就會一直卡在那裡不會超時。我們知道php.ini 裡面max_execution_time 可以設置 PHP 腳本的最大執行時間，但是，在 php-cgi(php-fpm) 中，該參數不會起效。真正能夠控制 PHP 腳本最大執行時間的是 php-fpm.conf 配置文件中的request_terminate_timeout參數。

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

　　[代碼]php代碼：

　　2,max_requests參數配置不當，可能會引起間歇性502錯誤：

　　pm.max_requests = 1000

　　設置每個子進程重生之前服務的請求數. 對於可能存在內存洩漏的第三方模塊來說是非常有用的. 如果設置為 ’0′ 則一直接受請求. 等同於 PHP_FCGI_MAX_REQUESTS 環境變量. 默認值: 0.

　　這段配置的意思是，當一個 PHP-CGI 進程處理的請求數累積到 500 個後，自動重啟該進程。

　　但是為什麼要重啟進程呢?

　　一般在項目中，我們多多少少都會用到一些 PHP 的第三方庫，這些第三方庫經常存在內存洩漏問題，如果不定期重啟 PHP-CGI 進程，勢必造成內存使用量不斷增長。因此 PHP-FPM 作為 PHP-CGI 的管理器，提供了這麼一項監控功能，對請求達到指定次數的 PHP-CGI 進程進行重啟，保證內存使用量不增長。

　　正是因為這個機制，在高並發的站點中，經常導致 502 錯誤，我猜測原因是 PHP-FPM 對從 NGINX 過來的請求隊列沒處理好。不過我目前用的還是 PHP 5.3.2，不知道在 PHP 5.3.3 中是否還存在這個問題。

　　目前我們的解決方法是，把這個值盡量設置大些，盡可能減少 PHP-CGI 重新 SPAWN 的次數，同時也能提高總體性能。在我們自己實際的生產環境中發現，內存洩漏並不明顯，因此我們將這個值設置得非常大(204800)。大家要根據自己的實際情況設置這個值，不能盲目地加大。

　　話說回來，這套機制目的只為保證 PHP-CGI 不過分地占用內存，為何不通過檢測內存的方式來處理呢?我非常認同高春輝所說的，通過設置進程的峰值內在占用量來重啟 PHP-CGI 進程，會是更好的一個解決方案。

　　3,php-fpm的慢日志，debug及異常排查神器：

　　request_slowlog_timeout設置一個超時的參數，slowlog設置慢日志的存放位置

　　tail -f /var/log/www.php2.cc.log

　　上面的命令即可看到執行過慢的php過程。

　　大家可以看到經常出現的網絡讀取超過、Mysql查詢過慢的問題，根據提示信息再排查問題就有很明確的方向了。