php-fpm介绍及配置
php-fpm是什么
全稱是php fastcgi process manager即php fastcgi進(jìn)程管理器,相比fastcgi靜態(tài)的喚起cgi,fpm能根據(jù)訪問的壓力動(dòng)態(tài)的喚起cgi進(jìn)程和銷毀以到達(dá)動(dòng)態(tài)的調(diào)整cgi數(shù)量,這樣可以有效的使用內(nèi)存。除此之外還有其它的一些優(yōu)點(diǎn),比如,fpm還可以平滑的重載php配置;由于fpm是使用Unix-Socket來和服務(wù)器通訊,所以也不用再配置cgi端口;fpm有更好的狀態(tài)輸出和slowlog日志,502的時(shí)候能給出更多的錯(cuò)誤細(xì)節(jié)。
php-fpm配置
從php5.3.3版本開始就已經(jīng)集成了fpm,不再是第三方的包了,如果使用的是php5.3.3以前的版本就得自己去安裝fpm包了,對(duì)于php5.2.x的版本,fpm的配置文件還是xml格式,php5.3.x開始fpm配置文件就已經(jīng)支持ini格式了。
下面是一個(gè)ini格式的配置文件
[plain] view plaincopyprint?
;this configuration is for PHP 5.3.10 for heavy loaded servers
[global]
error_log = syslog
log_level = error
rlimit_files = 655360
rlimit_core = 0
[myapp]
user = nobody
group = nobody
listen = fpm.sock
listen.allowed_clients = 127.0.0.1
pm = dynamic
pm.max_children = 1000
pm.start_servers = 20
pm.min_spare_servers = 10
pm.max_spare_servers = 30
pm.max_requests = 500
; system max load (request number) = max_children * max_requests = 500,000
pm.status_path = /fpm_status
ping.path = /status
ping.response = ok
slowlog = /data/phplogs/phpfpm_slow.log
request_slowlog_timeout = 3s
;listen.backlog = 262144
; The timeout for serving a single request after which the worker process will
; be killed. This option should be used when the 'max_execution_time' ini option
; does not stop script execution for some reason. A value of '0' means 'off'.
; Available units: s(econds)(default), m(inutes), h(ours), or d(ays)
; Default Value: 0
;request_terminate_timeout = 0
rlimit_files = 655360
rlimit_core = 0
security.limit_extensions = .php .html
php_admin_value['date.timezone'] = 'Asia/Shanghai'
;this configuration is for PHP 5.3.10 for heavy loaded servers [global] error_log = syslog log_level = error rlimit_files = 655360 rlimit_core = 0 [myapp] user = nobody group = nobody listen = fpm.sock listen.allowed_clients = 127.0.0.1 pm = dynamic pm.max_children = 1000 pm.start_servers = 20 pm.min_spare_servers = 10 pm.max_spare_servers = 30 pm.max_requests = 500 ; system max load (request number) = max_children * max_requests = 500,000 pm.status_path = /fpm_status ping.path = /status ping.response = ok slowlog = /data/phplogs/phpfpm_slow.log request_slowlog_timeout = 3s ;listen.backlog = 262144 ; The timeout for serving a single request after which the worker process will ; be killed. This option should be used when the 'max_execution_time' ini option ; does not stop script execution for some reason. A value of '0' means 'off'. ; Available units: s(econds)(default), m(inutes), h(ours), or d(ays) ; Default Value: 0 ;request_terminate_timeout = 0 rlimit_files = 655360 rlimit_core = 0 security.limit_extensions = .php .html php_admin_value['date.timezone'] = 'Asia/Shanghai'
參數(shù)說明:
error_log string
錯(cuò)誤日志的位置. 默認(rèn): 安裝路徑#INSTALL_PREFIX#/log/php-fpm.log.
log_level string
錯(cuò)誤級(jí)別. 可用級(jí)別為: alert(必須立即處理), error(錯(cuò)誤情況), warning(警告情況), notice(一般重要信息), debug(調(diào)試信息). 默認(rèn): notice.
emergency_restart_threshold int
如果子進(jìn)程在emergency_restart_interval設(shè)定的時(shí)間內(nèi)收到該參數(shù)設(shè)定次數(shù)的SIGSEGV 或者 SIGBUS退出信息號(hào),則FPM會(huì)重新啟動(dòng)。 0 表示 ‘關(guān)閉該功能’. 默認(rèn)值: 0 (關(guān)閉).
emergency_restart_interval mixed
emergency_restart_interval用于設(shè)定平滑重啟的間隔時(shí)間. 這么做有助于解決加速器中共享內(nèi)存的使用問題. 可用單位: s(秒), m(分), h(小時(shí)), 或者 d(天). 默認(rèn)單位: s(秒). 默認(rèn)值: 0 (關(guān)閉).
process_control_timeout mixed
設(shè)置子進(jìn)程接受主進(jìn)程復(fù)用信號(hào)的超時(shí)時(shí)間. 可用單位: s(秒), m(分), h(小時(shí)), 或者 d(天) 默認(rèn)單位: s(秒). 默認(rèn)值: 0.
daemonize boolean
設(shè)置FPM在后臺(tái)運(yùn)行. 設(shè)置 ‘no’ 將 FPM 保持在前臺(tái)運(yùn)行用于調(diào)試. 默認(rèn)值: yes.
運(yùn)行配置區(qū)段
在FPM中,可以使用不同的設(shè)置來運(yùn)行多個(gè)進(jìn)程池。 這些設(shè)置可以針對(duì)每個(gè)進(jìn)程池單獨(dú)設(shè)置。
listen string
設(shè)置接受FastCGI請(qǐng)求的地址. 可用格式為: ‘ip:port’, ‘port’, ‘/path/to/unix/socket’. 每個(gè)進(jìn)程池都需要設(shè)置.
listen.backlog int
設(shè)置 listen(2) 的半連接隊(duì)列長度. ‘-1′ 表示無限制. 默認(rèn)值: -1.
listen.allowed_clients string
設(shè)置允許連接到FastCGI的服務(wù)器IPV4地址. 等同于PHP FastCGI (5.2.2+)中的 FCGI_WEB_SERVER_ADDRS環(huán)境變量. 僅對(duì)TCP監(jiān)聽起作用. 每個(gè)地址是用逗號(hào)分隔. 如果沒有設(shè)置或者為空,則允許任何服務(wù)器請(qǐng)求連接. 默認(rèn)值: any.
listen.owner string
如果使用,表示設(shè)置Unix套接字的權(quán)限. 在Linux中,讀寫權(quán)限必須設(shè)置,以便用于WEB服務(wù)器連接. 在很多BSD派生的系統(tǒng)中可以忽略權(quán)限允許自由連接. 默認(rèn)值: 運(yùn)行所使用的用戶合租, 權(quán)限為0666.
listen.group string
參見 listen.owner.
listen.mode string
參見 listen.owner.
user string
FPM 進(jìn)程運(yùn)行的Unix用戶. 必須設(shè)置.
group string
FPM 進(jìn)程運(yùn)行的Unix用戶組. 如果沒有設(shè)置,則默認(rèn)用戶的組被使用.
pm string
設(shè)置進(jìn)程管理器如何管理子進(jìn)程. 可用值: static, dynamic. 必須設(shè)置.
static – 子進(jìn)程的數(shù)量是固定的 (pm.max_children).
dynamic – 子進(jìn)程的數(shù)量在下面配置的基礎(chǔ)上動(dòng)態(tài)設(shè)置: pm.max_children, pm.start_servers, pm.min_spare_servers, pm.max_spare_servers.
pm.max_children int
子進(jìn)程的數(shù)量,pm 設(shè)置為 static 時(shí)表示創(chuàng)建的, pm 設(shè)置為 dynamic 時(shí)表示最大可創(chuàng)建的. 必須設(shè)置.
該選項(xiàng)設(shè)置可以同時(shí)提供服務(wù)的請(qǐng)求數(shù)限制. 類似 Apache 的 mpm_prefork 中 MaxClients 的設(shè)置和 普通PHP FastCGI中的 PHP_FCGI_CHILDREN 環(huán)境變量.
pm.start_servers in
設(shè)置啟動(dòng)時(shí)創(chuàng)建的子進(jìn)程數(shù)目. 僅在 pm 設(shè)置為 dynamic 時(shí)使用. 默認(rèn)值: min_spare_servers + (max_spare_servers – min_spare_servers) / 2.
pm.min_spare_servers int
設(shè)置空閑服務(wù)進(jìn)程的最低數(shù)目. 僅在 pm 設(shè)置為 dynamic 時(shí)使用. 必須設(shè)置.
pm.max_spare_servers int
設(shè)置空閑服務(wù)進(jìn)程的最大數(shù)目. 僅在 pm 設(shè)置為 dynamic 時(shí)使用. 必須設(shè)置.
pm.max_requests int
設(shè)置每個(gè)子進(jìn)程重生之前服務(wù)的請(qǐng)求數(shù). 對(duì)于可能存在內(nèi)存泄漏的第三方模塊來說是非常有用的. 如果設(shè)置為 ’0′ 則一直接受請(qǐng)求. 等同于 PHP_FCGI_MAX_REQUESTS 環(huán)境變量. 默認(rèn)值: 0.
pm.status_path string
FPM狀態(tài)頁面的網(wǎng)址. 如果沒有設(shè)置, 則無法訪問狀態(tài)頁面. 默認(rèn)值: none.
ping.path string
FPM監(jiān)控頁面的ping網(wǎng)址. 如果沒有設(shè)置, 則無法訪問ping頁面. 該頁面用于外部檢測(cè)FPM是否存活并且可以響應(yīng)請(qǐng)求. 請(qǐng)注意必須以斜線開頭 (/).
ping.response string
用于定義ping請(qǐng)求的返回相應(yīng). 返回為 HTTP 200 的 text/plain 格式文本. 默認(rèn)值: pong.
request_terminate_timeout mixed
設(shè)置單個(gè)請(qǐng)求的超時(shí)中止時(shí)間. 該選項(xiàng)可能會(huì)對(duì)php.ini設(shè)置中的’max_execution_time’因?yàn)槟承┨厥庠驔]有中止運(yùn)行的腳本有用. 設(shè)置為 ’0′ 表示 ‘Off’. Available units: s(econds)(default), m(inutes), h(ours), or d(ays). Default value: 0.
request_slowlog_timeout mixed
當(dāng)一個(gè)請(qǐng)求該設(shè)置的超時(shí)時(shí)間后,就會(huì)將對(duì)應(yīng)的PHP調(diào)用堆棧信息完整寫入到慢日志中. 設(shè)置為 ’0′ 表示 ‘Off’. 可用單位: s(秒)(默認(rèn)), m(分), h(小時(shí)), 或者 d(天). 默認(rèn)值: 0.
slowlog string
慢請(qǐng)求的記錄日志. 默認(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
啟動(dòng)時(shí)的Chroot目錄. 所定義的目錄需要是絕對(duì)路徑. 如果沒有設(shè)置, 則chroot不被使用.
chdir string
設(shè)置啟動(dòng)目錄,啟動(dòng)時(shí)會(huì)自動(dòng)Chdir到該目錄. 所定義的目錄需要是絕對(duì)路徑. 默認(rèn)值: 當(dāng)前目錄,或者/目錄(chroot時(shí)).
catch_workers_output boolean
重定向運(yùn)行過程中的stdout和stderr到主要的錯(cuò)誤日志文件中. 如果沒有設(shè)置, stdout 和 stderr 將會(huì)根據(jù)FastCGI的規(guī)則被重定向到 /dev/null . 默認(rèn)值: 空.
nginx配置
如果使用unix-socket來與nginx配合,nginx中的配置也要做相應(yīng)的更改
1. 在ngnix配置的server_name下面聲明全局的fpm變量
[plain] view plaincopyprint?
server {
listen 80 ;
server_name xxx;
#在這里插入,設(shè)置為全局變量
set $fpm_sock 'unix:/var/run/myapp/fpm.sock';
...
}
server {
listen 80 ;
server_name xxx;
#在這里插入,設(shè)置為全局變量
set $fpm_sock 'unix:/var/run/myapp/fpm.sock';
...
}
2. 然后改造所有 fastcgi_pass 字段
[plain] view plaincopyprint?
location = / {
include fastcgi_params;
root xxx/apps/fnt;
fastcgi_pass $fpm_sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME xxx/apps/fnt/index.php ;
}
location = / {
include fastcgi_params;
root xxx/apps/fnt;
fastcgi_pass $fpm_sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME xxx/apps/fnt/index.php ;
}
fpm status
在nginx.conf里配置
[plain] view plaincopyprint?
server {
listen 8360;
server_name localhost;
location /fpm_status {
if ( $arg_sid = '' ) {
rewrite ^ /fpm_list last;
}
include fastcgi_params;
fastcgi_pass unix:/var/run/$arg_sid/fpm.sock;
}
#列出所有正在運(yùn)行的fpm-sock
location /fpm_list {
default_type text/html;
content_by_lua "
ngx.print('<h2>Runing FPM instances:</h2>')
local cmd = [[/bin/ls -1 /var/run/ | grep rgapp- | awk '{print "<p><a href=?sid="$1">"$1"</a>"}']]
local f = io.popen(cmd, 'r')
local log = f:read('*a')
f:close()
ngx.print(log)
";
}
...
}
server {
listen 8360;
server_name localhost;
location /fpm_status {
if ( $arg_sid = '' ) {
rewrite ^ /fpm_list last;
}
include fastcgi_params;
fastcgi_pass unix:/var/run/$arg_sid/fpm.sock;
}
#列出所有正在運(yùn)行的fpm-sock
location /fpm_list {
default_type text/html;
content_by_lua "
ngx.print('<h2>Runing FPM instances:</h2>')
local cmd = [[/bin/ls -1 /var/run/ | grep rgapp- | awk '{print "<p><a href=?sid="$1">"$1"</a>"}']]
local f = io.popen(cmd, 'r')
local log = f:read('*a')
f:close()
ngx.print(log)
";
}
...
}
因?yàn)閼?yīng)用池里面會(huì)有多個(gè)應(yīng)用,所以通過sid參數(shù)來參看指定應(yīng)用的fpm狀態(tài)。
通過地址http://xxx:8360/fpm_status?sid=myapp查看fpm狀態(tài)
總結(jié)
以上是生活随笔為你收集整理的php-fpm介绍及配置的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 常见git使用
- 下一篇: 虚拟地址 线性地址 物理地址 傻傻分不清