詳解：PHP-FPM配置文件參數解釋

PHP-FPM配置詳解

FPM配置文件爲php-fpm.conf，其語法相似 php.ini 。其php手冊上也有詳細的講解：http://php.net/manual/zh/install.fpm.configuration.php。

php-fpm.conf全局配置段

# 包含其餘POOL定義配置文件
include=/etc/php-fpm.d/*.conf

# 全局配置段，定義PID文件的位置和錯誤日誌的位置
[global]
daemonize = yes
pid = /var/run/php-fpm/php-fpm.pid
error_log = /var/log/php-fpm/error.log

通常在主配置文件php-fpm.conf全局配置段中的配置很是少，php-fpm能夠配置多個pool，每一個pool都是以一個獨立的配置文件來運做，默認都會定義在主配置文件的include包含文件目錄中。php默認會提供一個www的pool，大概配置以下。

$ cat /etc/php-fpm.d/www.conf
[www]
user = apache
group = apache

listen = 127.0.0.1:9000
listen.allowed_clients = 127.0.0.1
pm = dynamic
pm.max_children = 50
pm.start_servers = 5
pm.min_spare_servers = 5
pm.max_spare_servers = 35

每一個pool配置文件參數能夠獨立，也能夠設置在主配置文件的全局配置段中，這樣每一個pool就共用一個參數。建議最好分開設置。大概經常使用參數以下：

daemonize = yes

#後臺執行fpm，默認值爲yes，若是爲了調試能夠改成no。在FPM中，可使用不一樣的設置來運行多個進程池。 這些設置能夠針對每一個進程池單獨設置。

listen = 127.0.0.1:9000

#fpm監聽端口，即nginx中php處理的地址，通常默認值便可。可用格式爲: ‘ip:port’, ‘port’, ‘/path/to/unix/socket’，每一個進程池都須要設置。若是nginx和php在不一樣的機器上，分佈式處理，就設置ip這裏就能夠了。

listen.backlog = -1

#backlog數，設置 listen 的半鏈接隊列長度，-1表示無限制，由操做系統決定，此行註釋掉就行。backlog含義參考：http://www.3gyou.cc/?p=41。

log_level = notice

#錯誤級別. 上面的php-fpm.log紀錄的登記。可用級別爲: 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就會優雅重啓。這兩個選項通常保持默認值。0 表示 ‘關閉該功能’. 默認值: 0 (關閉).

process_control_timeout = 0

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

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

#啓動進程的用戶和用戶組，FPM 進程運行的Unix用戶, 必需要設置。用戶組，若是沒有設置，則默認用戶的組被使用。

pm = dynamic

#php-fpm進程啓動模式，pm能夠設置爲static和dynamic和ondemand。若是選擇static，則進程數就是固定的，由pm.max_children指定固定的子進程數。若是選擇dynamic，則進程數是動態變化的，由如下參數決定：

pm.max_children = 50

#子進程能開啓的最大數。

pm.start_servers = 2

#啓動時的進程數，默認值爲: min_spare_servers + (max_spare_servers – min_spare_servers) / 2。

pm.min_spare_servers = 1

#保證空閒進程數最小值，若是空閒進程小於此值，則建立新的子進程。

pm.max_spare_servers = 3

#保證空閒進程數最大值，若是空閒進程大於此值，此進行清理。

pm.max_requests = 500

#設置每一個子進程重生以前服務的請求數. 對於可能存在內存泄漏的第三方模塊來講是很是有用的. 若是設置爲 ‘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.

access.log = log/$pool.access.log

#每個請求的訪問日誌，默認是關閉的。

access.format = 「%R – %u %t \」%m %r%Q%q\」 %s %f %{mili}d %{kilo}M %C%%」

#設定訪問日誌的格式。

slowlog = log/$pool.log.slow

#慢請求的記錄日誌,配合request_slowlog_timeout使用，默認關閉

request_slowlog_timeout = 10s

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

request_terminate_timeout = 0

#設置單個請求的超時停止時間. 該選項可能會對php.ini設置中的’max_execution_time’由於某些特殊緣由沒有停止運行的腳本有用. 設置爲 ‘0’ 表示 ‘Off’.當常常出現502錯誤時能夠嘗試更改此選項。

rlimit_files = 1024

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

rlimit_core = 0

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

chroot = /data/app

#啓動時的Chroot目錄. 所定義的目錄須要是絕對路徑. 若是沒有設置, 則chroot不被使用。

chdir = /data/app

#設置啓動目錄，啓動時會自動Chdir到該目錄. 所定義的目錄須要是絕對路徑. 默認值: 當前目錄，或者/目錄（chroot時）。

catch_workers_output = yes

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

固然還有一些可有可無的設置，用到了再說吧。

PHP-FPM重要的設置

php-fpm進程分配

在以前的文章中就說過了。在fasgcgi模式下，php會啓動多個php-fpm進程，來接收nginx發來的請求，那是否是進程越多，速度就越快呢？這可不必定！得根據咱們的機器配置和業務量來決定。

咱們先來看下，設定進程的配置在哪裏？

pm = static | dynamic | ondemand

pm能夠設置成這樣3種，咱們用的最多的就上前面2種。

pm = static模式

pm = static 表示咱們建立的php-fpm子進程數量是固定的，那麼就只有pm.max_children = 50這個參數生效。你啓動php-fpm的時候就會一塊兒所有啓動51(1個主＋50個子)個進程，頗爲壯觀。

pm = dynamic模式

pm = dynamic模式，表示啓動進程是動態分配的，隨着請求量動態變化的。他由pm.max_children，pm.start_servers，pm.min_spare_servers，pm.max_spare_servers 這幾個參數共同決定。

上面已經講過，這裏再重申一下吧：

pm.max_children ＝ 50是最大可建立的子進程的數量。必須設置。這裏表示最多隻能50個子進程。

pm.start_servers = 20隨着php-fpm一塊兒啓動時建立的子進程數目。默認值：min_spare_servers + (max_spare_servers – min_spare_servers) / 2。這裏表示，一塊兒啓動會有20個子進程。

pm.min_spare_servers = 10

設置服務器空閒時最小php-fpm進程數量。必須設置。若是空閒的時候，會檢查若是少於10個，就會啓動幾個來補上。

pm.max_spare_servers = 30

設置服務器空閒時最大php-fpm進程數量。必須設置。若是空閒時，會檢查進程數，多於30個了，就會關閉幾個，達到30個的狀態。

通常原則是：動態適合小內存機器，靈活分配進程，省內存。靜態適用於大內存機器，動態建立回收進程對服務器資源也是一種消耗。

若是你的內存很大，有8-20G，按照一個php-fpm進程20M算，100個就2G內存了，那就能夠開啓static模式。若是你的內存很小，好比才256M，那就要當心設置了，由於你的機器裏面的其餘的進程也算須要佔用內存的，因此設置成dynamic是最好的，好比：pm.max_chindren = 8, 佔用內存160M左右，並且能夠隨時變化，對於一半訪問量的網站足夠了。

慢日誌查詢

咱們有時候會常常飽受500,504問題困擾。當nginx收到如上錯誤碼時，能夠肯定後端php-fpm解析php出了某種問題，好比，執行錯誤，執行超時。

這個時候，咱們是能夠開啓慢日誌功能的。

slowlog = /usr/local/var/log/php-fpm.log.slow

request_slowlog_timeout = 15s

當一個請求該設置的超時時間15秒後，就會將對應的PHP調用堆棧信息完整寫入到慢日誌中。

php-fpm慢日誌會記錄下進程號，腳本名稱，具體哪一個文件哪行代碼的哪一個函數執行時間過長：

[21-Nov-2013 14:30:38] [pool www] pid 11877
script_filename = /usr/local/lnmp/nginx/html/www.quancha.cn/www/fyzb.php
[0xb70fb88c] file_get_contents() /usr/local/lnmp/nginx/html/www.quancha.cn/www/fyzb.php:2

經過日誌，咱們就能夠知道第2行的file_get_contents 函數有點問題，這樣咱們就能追蹤問題了。

原文來自： https://www.linuxprobe.com/php-fpm-config.html