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的值若是設置爲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錯誤：
http://hily.me/blog/2011/01/nginx-php-fpm-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查詢過慢的問題，根據提示信息再排查問題就有很明確的方向了。