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

http://www.cnblogs.com/argb/p/3604340.html文章轉載

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

$ctx = stream_context_create(array(

    `http` => array(

        `timeout` => 10    //設定一個超時時間，單位為秒

    )

));

 

file_get_contents($str, 0, $ctx);

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.slow.log

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

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