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

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

約定幾個目錄

• /usr/local/php/sbin/php-fpm
• /usr/local/php/etc/php-fpm/etc/php-fpm.
/usr/local/php/etc/php.ini

一，php-fpm的啟動參數

1

7

8

9

10

11

12

13

pm

 

- 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/binbin/php-fpm🜎 /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

#重啟php-fpm

#重啟php-fpm#重啟php-fpm

殺 -USR2 `cat /usr/local/php/var/run/php-fpm.pid`

二，php-fpm.conf重要參數詳解

1

8

9

10

11

12

13

14

15

16

17

201188 2

23

24

25

26

27

28

29

30

31

32

33

39

40

41

42

43

44

45

46

47

48

49

50

56

57

58

59

60

61

62

63

64

65

66

67

2

73

74

75

76

77

78

79

pid = run

/php-fpm

.pid

/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加上一個逾時參數。

1

2

3

4

5

6

4

5

6

45 = stream_context_create(array(

    'http' => array(

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

    )

));

)🎜🎜🎜🎜));🎜)🎜🎜🎜🎜));

file_get_contents($str, 0, $ctx);

2,max_requests參數配置不當，可能會造成間歇性505050%

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設定慢日誌的存放位置

 

-f

/var/log/www

.slow.log

以上就介紹了php-fpm 啟動參數及重要配置詳解，包括了方面的內容，希望對PHP教程有興趣的朋友有所幫助。