php-fpm.conf

編輯器加載中...

運行時配置

FPM 配置文件為php-fpm.conf，其語法類似 php.ini 。
php-fpm.conf 全局配置段pid string

PID文件的位置. 默認為空.
error_log string

錯誤日志的位置. 默認： 安裝路徑#INSTALL_PREFIX#/log/php-fpm.log.
log_level string

錯誤級別. 可用級別為: alert（必須立即處理）, error（錯誤情況）, warning（警告情況）, notice（一般重要信息）, debug（調試信息）. 默認: notice.
emergency_restart_threshold int

如果子進程在emergency_restart_interval設定的時間內收到該參數設定次數的SIGSEGV 或者 SIGBUS退出信息號，則FPM會重新啟動。 0 表示 '關閉該功能'. 默認值: 0 (關閉).
emergency_restart_interval mixed

emergency_restart_interval用於設定平滑重啟的間隔時間. 這么做有助於解決加速器中共享內存的使用問題. 可用單位: s(秒), m(分), h(小時), 或者 d(天). 默認單位： s(秒). 默認值: 0 (關閉).
process_control_timeout mixed

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

設置FPM在后台運行. 設置 'no' 將 FPM 保持在前台運行用於調試. 默認值: yes.
運行配置區段

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

設置接受FastCGI請求的地址. 可用格式為: 'ip:port', 'port', '/path/to/unix/socket'. 每個進程池都需要設置.
listen.backlog int

設置 listen(2) 的半連接隊列長度. '-1' 表示無限制. 默認值: -1.
listen.allowed_clients string

設置允許連接到FastCGI的服務器IPV4地址. 等同於PHP FastCGI (5.2.2+)中的 FCGI_WEB_SERVER_ADDRS環境變量. 僅對TCP監聽起作用. 每個地址是用逗號分隔. 如果沒有設置或者為空，則允許任何服務器請求連接. 默認值: any.
listen.owner string

如果使用，表示設置Unix套接字的權限. 在Linux中，讀寫權限必須設置，以便用於WEB服務器連接. 在很多BSD派生的系統中可以忽略權限允許自由連接. 默認值: 運行所使用的用戶合租, 權限為0666.
listen.group string

參見 listen.owner.
listen.mode string

參見 listen.owner.
user string

FPM 進程運行的Unix用戶. 必須設置.
group string

FPM 進程運行的Unix用戶組. 如果沒有設置，則默認用戶的組被使用.
pm string

設置進程管理器如何管理子進程. 可用值: static, dynamic. 必須設置.

static - 子進程的數量是固定的 (pm.max_children).

dynamic - 子進程的數量在下面配置的基礎上動態設置: pm.max_children, pm.start_servers, pm.min_spare_servers, pm.max_spare_servers.
pm.max_children int

子進程的數量，pm 設置為 static 時表示創建的， pm 設置為 dynamic 時表示最大可創建的. 必須設置.

該選項設置可以同時提供服務的請求數限制. 類似 Apache 的 mpm_prefork 中 MaxClients 的設置和 普通PHP FastCGI中的 PHP_FCGI_CHILDREN 環境變量.
pm.start_servers in

設置啟動時創建的子進程數目. 僅在 pm 設置為 dynamic 時使用. 默認值: min_spare_servers + (max_spare_servers - min_spare_servers) / 2.
pm.min_spare_servers int

設置空閑服務進程的最低數目. 僅在 pm 設置為 dynamic 時使用. 必須設置.
pm.max_spare_servers int

設置空閑服務進程的最大數目. 僅在 pm 設置為 dynamic 時使用. 必須設置.
pm.max_requests int

設置每個子進程重生之前服務的請求數. 對於可能存在內存泄漏的第三方模塊來說是非常有用的. 如果設置為 '0' 則一直接受請求. 等同於 PHP_FCGI_MAX_REQUESTS 環境變量. 默認值: 0.
pm.status_path string

FPM狀態頁面的網址. 如果沒有設置, 則無法訪問狀態頁面. 默認值: none.
ping.path string

FPM監控頁面的ping網址. 如果沒有設置, 則無法訪問ping頁面. 該頁面用於外部檢測FPM是否存活並且可以響應請求. 請注意必須以斜線開頭 (/).
ping.response string

用於定義ping請求的返回相應. 返回為 HTTP 200 的 text/plain 格式文本. 默認值: pong.
request_terminate_timeout mixed

設置單個請求的超時中止時間. 該選項可能會對php.ini設置中的'max_execution_time'因為某些特殊原因沒有中止運行的腳本有用. 設置為 '0' 表示 'Off'. Available units: s(econds)(default), m(inutes), h(ours), or d(ays). Default value: 0.
request_slowlog_timeout mixed

當一個請求該設置的超時時間后，就會將對應的PHP調用堆棧信息完整寫入到慢日志中. 設置為 '0' 表示 'Off'. 可用單位: s(秒)(默認), m(分), h(小時), 或者 d(天). 默認值: 0.
slowlog string

慢請求的記錄日志. 默認值: #INSTALL_PREFIX#/log/php-fpm.log.slow.
rlimit_files int

設置文件打開描述符的rlimit限制. 默認值: 系統定義值.
rlimit_core int

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

啟動時的Chroot目錄. 所定義的目錄需要是絕對路徑. 如果沒有設置, 則chroot不被使用.
chdir string

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

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