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

• 監聽埠，即nginx中php處理的地址，一般預設值即可。可用格式為: 'ip:port', 'port', '/path/to/unix/socket'. 每個程序池都需要設定.

listen.backlog = -1

• backlog數，-1表示無限制，由作業系統決定，此行註釋掉就行。

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 . 預設值: 空.`

常見錯誤及解決辦法整理

一

• 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加一個超時引數。！

• 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.slow.log即可看到執行過慢的php過程。 大家可以看到經常出現的網路讀取超過、Mysql查詢過慢的問題，根據提示資訊再排查問題就有很明確的方向了。