配置

php-fpm.conf 全局配置段

pid string

PID 文件的位置。默認(rèn)為空。

error_log string

錯誤日志的位置。默認(rèn)：#INSTALL_PREFIX#/log/php-fpm.log。 如果設(shè)置為 "syslog"，日志將不會寫入本地文件，而是發(fā)送到 syslogd。

log_level string

錯誤級別?？捎眉墑e為：alert（必須立即處理），error（錯誤情況），warning（警告情況），notice（一般重要信息），debug（調(diào)試信息）。默認(rèn)：notice。

log_limit int

日志記錄行的限制，允許記錄超過 1024 個字符的消息而不需要換行。 默認(rèn)值：1024。 PHP 7.3.0 起可用。

log_buffering bool

實驗性：沒有額外緩沖的日志記錄。 默認(rèn)值：yes。 PHP 7.3.0 后可用。

syslog.facility string

設(shè)置何種程序記錄消息，默認(rèn)值：daemon。

syslog.ident string

為每條信息添加前綴。 如果在同一臺服務(wù)器上運行了多個 FPM 實例，可以修改此默認(rèn)值來滿足需求。默認(rèn)值：php-fpm。

emergency_restart_threshold int

如果子進程在 emergency_restart_interval 設(shè)定的時間內(nèi)收到該參數(shù)設(shè)定次數(shù)的 SIGSEGV 或者 SIGBUS退出信息號，則FPM會重新啟動。0 表示“關(guān)閉該功能”。默認(rèn)值：0（關(guān)閉）。

emergency_restart_interval mixed

emergency_restart_interval 用于設(shè)定平滑重啟的間隔時間。這么做有助于解決加速器中共享內(nèi)存的使用問題?？捎脝挝唬簊（秒），m（分），h（小時）或者 d（天）。默認(rèn)單位：s（秒）。默認(rèn)值：0（關(guān)閉）。

process_control_timeout mixed

設(shè)置子進程接受主進程復(fù)用信號的超時時間?？捎脝挝唬簊（秒），m（分），h（小時）或者 d（天）。默認(rèn)單位：s（秒）。默認(rèn)值：0（關(guān)閉）。

process.max int

Fork 的最大 FPM 進程數(shù)。使用動態(tài)管理進程數(shù)時，此設(shè)計可以控制在一個進程池內(nèi)的全局進程數(shù)量。 使用需謹(jǐn)慎。默認(rèn)值：0。

process.priority int

設(shè)置 master 進程的 nice(2) 優(yōu)先級（如果設(shè)置了此值）。 可以是 -19（最高優(yōu)先級）到 20 （更低優(yōu)先級）。 默認(rèn)值：不設(shè)置。

daemonize bool

設(shè)置 FPM 在后臺運行。設(shè)置“no”將 FPM 保持在前臺運行用于調(diào)試。默認(rèn)值：yes。

rlimit_files int

設(shè)置 master 進程的打開文件描述符 rlimit 數(shù)。 默認(rèn)值：系統(tǒng)定義值。

rlimit_core int

設(shè)置 master 進程最大 core 的 rlimit 尺寸。 默認(rèn)值：0。

events.mechanism string

設(shè)置 FPM 使用的事件機制。 可用以下選項：select、pool、epoll、kqueue (*BSD)、port (Solaris)。 默認(rèn)值：不設(shè)置（自動檢測）

systemd_interval int

使用 systemd 集成的 FPM 時，設(shè)置間歇秒數(shù)，報告健在通知給 systemd。 設(shè)置為 0 表示禁用。默認(rèn)值：10。

運行配置區(qū)段

在FPM中，可以使用不同的設(shè)置來運行多個進程池。 這些設(shè)置可以針對每個進程池單獨設(shè)置。

listen string

設(shè)置接受 FastCGI 請求的地址?？捎酶袷綖椋?ip:port'，'port'，'/path/to/unix/socket'。每個進程池都需要設(shè)置。

listen.backlog int

設(shè)置 listen(2) 的 backlog 最大值。“-1”表示無限制。默認(rèn)值：-1。

listen.allowed_clients string

設(shè)置允許連接到 FastCGI 的服務(wù)器 IPV4 地址。等同于 PHP FastCGI (5.2.2+) 中的 FCGI_WEB_SERVER_ADDRS 環(huán)境變量。僅對 TCP 監(jiān)聽起作用。每個地址是用逗號分隔，如果沒有設(shè)置或者為空，則允許任何服務(wù)器請求連接。默認(rèn)值：any。 支持 IPv6 地址。

listen.owner string

如果使用了 Unix 套接字，表示它的權(quán)限。在 Linux 中必須設(shè)置讀/寫權(quán)限，以便用于 WEB 服務(wù)器連接。 在很多 BSD 派生的系統(tǒng)中可以忽略權(quán)限允許自由連接。 默認(rèn)值：運行所使用的用戶和組，權(quán)限為 0660。

listen.group string

參見 listen.owner。

listen.mode string

參見 listen.owner。

listen.acl_users string

當(dāng)系統(tǒng)支持 POSIX ACL（Access Control Lists）時，可以設(shè)置使用此選項。 當(dāng)設(shè)置了的時候，將會忽略 listen.owner 和 listen.group。 值是逗號分割的用戶名列表。

listen.acl_groups string

參見 listen.acl_users。 值是逗號分割的用戶組名稱列表。

user string

FPM 進程運行的Unix用戶。必須設(shè)置。

group string

FPM 進程運行的 Unix 用戶組。如果不設(shè)置，就使用默認(rèn)用戶的用戶組。

pm string

設(shè)置進程管理器如何管理子進程。可用值：static，ondemand，dynamic。必須設(shè)置。

static - 子進程的數(shù)量是固定的（pm.max_children）。

ondemand - 進程在有需求時才產(chǎn)生（當(dāng)請求時才啟動。與 dynamic 相反，在服務(wù)啟動時 pm.start_servers 就啟動了。

dynamic - 子進程的數(shù)量在下面配置的基礎(chǔ)上動態(tài)設(shè)置：pm.max_children，pm.start_servers，pm.min_spare_servers，pm.max_spare_servers。

pm.max_children int

pm 設(shè)置為 static 時表示創(chuàng)建的子進程的數(shù)量，pm 設(shè)置為 dynamic 時表示最大可創(chuàng)建的子進程的數(shù)量。必須設(shè)置。

該選項設(shè)置可以同時提供服務(wù)的請求數(shù)限制。類似 Apache 的 mpm_prefork 中 MaxClients 的設(shè)置和 普通PHP FastCGI中的 PHP_FCGI_CHILDREN 環(huán)境變量。

pm.start_servers in

設(shè)置啟動時創(chuàng)建的子進程數(shù)目。僅在 pm 設(shè)置為 dynamic 時使用。默認(rèn)值：min_spare_servers + (max_spare_servers - min_spare_servers) / 2。

pm.min_spare_servers int

設(shè)置空閑服務(wù)進程的最低數(shù)目。僅在 pm 設(shè)置為 dynamic 時使用。必須設(shè)置。

pm.max_spare_servers int

設(shè)置空閑服務(wù)進程的最大數(shù)目。僅在 pm 設(shè)置為 dynamic 時使用。必須設(shè)置。

pm.process_idle_timeout mixed

秒數(shù)，多久之后結(jié)束空閑進程。 僅當(dāng)設(shè)置 pm 為 ondemand。 可用單位：s（秒），m（分），h（小時）或者 d（天）。默認(rèn)單位：10s。

pm.max_requests int

設(shè)置每個子進程重生之前服務(wù)的請求數(shù)。對于可能存在內(nèi)存泄漏的第三方模塊來說是非常有用的。如果設(shè)置為 '0' 則一直接受請求，等同于 PHP_FCGI_MAX_REQUESTS 環(huán)境變量。默認(rèn)值：0。

pm.status_path string

FPM 狀態(tài)頁面的網(wǎng)址。如果沒有設(shè)置，則無法訪問狀態(tài)頁面，默認(rèn)值：無。

ping.path string

FPM 監(jiān)控頁面的 ping 網(wǎng)址。如果沒有設(shè)置，則無法訪問 ping 頁面。該頁面用于外部檢測 FPM 是否存活并且可以響應(yīng)請求。請注意必須以斜線開頭（/）。

ping.response string

用于定義 ping 請求的返回響應(yīng)。返回為 HTTP 200 的 text/plain 格式文本。默認(rèn)值：pong。

process.priority int

設(shè)置 worker 的 nice(2)優(yōu)先級（如果設(shè)置了的話）。 該值從 -19（最高優(yōu)先級） 到 20（更低優(yōu)先級）。 默認(rèn)值：不設(shè)置

process.dumpable bool

即使進程用戶或者組跟主進程用戶是不同的，也設(shè)置進程可轉(zhuǎn)儲標(biāo)志 (PR_SET_DUMPABLE prctl)。 它允許為用戶池創(chuàng)建進程 core dump 和 ptrace 進程。 默認(rèn)值：no。自 PHP 7.0.29、7.1.17 和 7.2.5 起可用。

prefix string

檢測路徑時使用的前綴。

request_terminate_timeout mixed

設(shè)置單個請求的超時中止時間。該選項可能會對 php.ini 設(shè)置中的 'max_execution_time' 因為某些特殊原因沒有中止運行的腳本有用。設(shè)置為 '0' 表示 'Off'。可用單位：s（秒），m（分），h（小時）或者 d（天）。默認(rèn)單位：s（秒）。默認(rèn)值：0（關(guān)閉）。

request_slowlog_timeout mixed

當(dāng)一個請求該設(shè)置的超時時間后，就會將對應(yīng)的 PHP 調(diào)用堆棧信息完整寫入到慢日志中。設(shè)置為 '0' 表示 'Off'?？捎脝挝唬簊（秒），m（分），h（小時）或者 d（天）。默認(rèn)單位：s（秒）。默認(rèn)值：0（關(guān)閉）。

slowlog string

慢請求的記錄日志。默認(rèn)值：#INSTALL_PREFIX#/log/php-fpm.log.slow。

rlimit_files int

設(shè)置文件打開描述符的 rlimit 限制。默認(rèn)值：系統(tǒng)定義值。

rlimit_core int

設(shè)置核心 rlimit 最大限制值?？捎弥担?unlimited'，0 或者正整數(shù)。默認(rèn)值：系統(tǒng)定義值。

chroot string

啟動時的 Chroot 目錄。所定義的目錄需要是絕對路徑。如果沒有設(shè)置，則 chroot 不被使用。

chdir string

設(shè)置啟動目錄，啟動時會自動 Chdir 到該目錄。所定義的目錄需要是絕對路徑。默認(rèn)值：當(dāng)前目錄，或者根目錄（chroot時）。

catch_workers_output bool

重定向運行過程中的 stdout 和 stderr 到主要的錯誤日志文件中。如果沒有設(shè)置，stdout 和 stderr 將會根據(jù) FastCGI 的規(guī)則被重定向到 /dev/null。默認(rèn)值：無。

decorate_workers_output bool

當(dāng) catch_workers_output 啟用時， 為 worker 輸出啟用輸出裝飾。 默認(rèn)值：yes。 自 PHP 7.3.0 起可用。

clear_env bool

為 FPM worker 進程清除環(huán)境變量。 在進程池配置文件里設(shè)置環(huán)境變量前，阻止任意系統(tǒng)的環(huán)境變量進入 FPM worker 進程。 默認(rèn)值：Yes

security.limit_extensions string

限制 FPM 允許解析的腳本擴展名。 此設(shè)置可以預(yù)防 web 服務(wù)器配置的錯誤。 應(yīng)當(dāng)限制 FPM 僅僅解析 .php 擴展名，阻止惡意用戶使用其他擴展名運行 php 代碼。 默認(rèn)值： .php .phar

access.log string

Access log 文件。 默認(rèn)值：不設(shè)置

access.format string

access log 的格式。 默認(rèn): "%R - %u %t \"%m %r\" %s"：

可用選項

占位符	描述
%C	%CPU
%d	持續(xù)時間 μs
%e	fastcgi 環(huán)境變量
%f	腳本文件
%l	內(nèi)容長度
%m	請求方法
%M	內(nèi)存
%n	進程池（pool）名稱
%o	header 輸出
%p	PID
%q	查詢字符串
%Q	%q 和 %r 之間的連接字符
%r	請求 URI
%R	遠(yuǎn)程 IP 地址
%s	狀態(tài)碼
%T	時間
%t	時間
%u	遠(yuǎn)程用戶

還可以在為一個運行池傳遞附加的環(huán)境變量，或者更新 PHP 的配置值。可以在進程池配置文件中如下面的配置參數(shù)來做到：

env[HOSTNAME] = $HOSTNAME
env[PATH] = /usr/local/bin:/usr/bin:/bin
env[TMP] = /tmp
env[TMPDIR] = /tmp
env[TEMP] = /tmp

php_admin_value[sendmail_path] = /usr/sbin/sendmail -t -i -f www@my.domain.com
php_flag[display_errors] = off
php_admin_value[error_log] = /var/log/fpm-php.www.log
php_admin_flag[log_errors] = on
php_admin_value[memory_limit] = 32M

使用 php_admin_value 或者 php_admin_flag 定義的值，不能被 PHP 代碼中的 ini_set() 覆蓋。

可以通過 web 服務(wù)器設(shè)置 PHP 的設(shè)定。

set $php_value "pcre.backtrack_limit=424242";
set $php_value "$php_value \n pcre.recursion_limit=99999";
fastcgi_param  PHP_VALUE $php_value;

fastcgi_param  PHP_ADMIN_VALUE "open_basedir=/var/www/htdocs";

注意: 進程池不是種安全機制，因為它們不會完全隔離；例如：所有的進程池會使用單個 Opcache 實例。