php.ini是php運(yùn)行核心配置文件,下面是一些常用配置
extension_dir=""
- 設(shè)置PHP的擴(kuò)展庫(kù)路徑
expose_php = Off
- 避免PHP信息暴露在http頭中
display_errors = Off
- 避免暴露php調(diào)用mysql的錯(cuò)誤信息
log_errors = On
- 在關(guān)閉display_errors后開啟PHP錯(cuò)誤日志(路徑在php-fpm.conf中配置)
zend_extension=opcache.so extension=mysqli.so extension=pdo_mysql.so
- 設(shè)置PHP的opcache和mysql動(dòng)態(tài)庫(kù)
date.timezone = PRC
- 設(shè)置PHP的時(shí)區(qū)
opcache.enable=1
- 開啟opcache
open_basedir = /usr/share/nginx/html;
- 設(shè)置PHP腳本允許訪問的目錄(需要根據(jù)實(shí)際情況配置)
php-fpm.conf是php-fpm進(jìn)程服務(wù)的配置文件,下面是一些常用配置
error_log = /usr/local/php/logs/php-fpm.log
- 設(shè)置錯(cuò)誤日志的路徑
include=/usr/local/php7/etc/php-fpm.d/*.conf
- 引入www.conf文件中的配置(默認(rèn)已設(shè)置)
php-fpm.conf 以及 www.conf的主要配置信息
pid = run/php-fpm.pid
- pid設(shè)置,默認(rèn)在安裝目錄中的var/run/php-fpm.pid,建議開啟
error_log = log/php-fpm.log
- 錯(cuò)誤日志,默認(rèn)在安裝目錄中的var/log/php-fpm.log
log_level = notice
- 錯(cuò)誤級(jí)別. 可用級(jí)別為: alert(必須立即處理), error(錯(cuò)誤情況), warning(警告情況), notice(一般重要信息), debug(調(diào)試信息). 默認(rèn): notice.
emergency_restart_threshold = 60
emergency_restart_interval = 60s
- 表示在emergency_restart_interval所設(shè)值內(nèi)出現(xiàn)SIGSEGV或者SIGBUS錯(cuò)誤的php-cgi進(jìn)程數(shù)如果超過 emergency_restart_threshold個(gè),php-fpm就會(huì)優(yōu)雅重啟。這兩個(gè)選項(xiàng)一般保持默認(rèn)值。
process_control_timeout = 0
- 設(shè)置子進(jìn)程接受主進(jìn)程復(fù)用信號(hào)的超時(shí)時(shí)間. 可用單位: s(秒), m(分), h(小時(shí)), 或者 d(天) 默認(rèn)單位: s(秒). 默認(rèn)值: 0.
daemonize = yes
- 后臺(tái)執(zhí)行fpm,默認(rèn)值為yes,如果為了調(diào)試可以改為no。在FPM中,可以使用不同的設(shè)置來運(yùn)行多個(gè)進(jìn)程池。 這些設(shè)置可以針對(duì)每個(gè)進(jìn)程池單獨(dú)設(shè)置。
listen = 127.0.0.1:9000
- 監(jiān)聽端口,即nginx中php處理的地址,一般默認(rèn)值即可??捎酶袷綖? 'ip:port', 'port', '/path/to/unix/socket'. 每個(gè)進(jìn)程池都需要設(shè)置.
listen.backlog = -1
- backlog數(shù),-1表示無限制,由操作系統(tǒng)決定,此行注釋掉就行。
listen.allowed_clients = 127.0.0.1
- 允許訪問FastCGI進(jìn)程的IP,設(shè)置any為不限制IP,如果要設(shè)置其他主機(jī)的nginx也能訪問這臺(tái)FPM進(jìn)程,listen處要設(shè)置成本地可被訪問的IP。默認(rèn)值是any。每個(gè)地址是用逗號(hào)分隔. 如果沒有設(shè)置或者為空,則允許任何服務(wù)器請(qǐng)求連接
listen.owner = www listen.group = www listen.mode = 0666
- unix socket設(shè)置選項(xiàng),如果使用tcp方式訪問,這里注釋即可。
user = www group = www
- 啟動(dòng)進(jìn)程的帳戶和組
php-fpm 進(jìn)程池優(yōu)化方法
pm = dynamic
- 對(duì)于專用服務(wù)器,pm可以設(shè)置為static。 如何控制子進(jìn)程,選項(xiàng)有static和dynamic。如果選擇static,則由pm.max_children指定固定的子進(jìn)程數(shù)。如果選擇dynamic,則由下開參數(shù)決定:
pm.max_children
- 靜態(tài)方式下開啟的php-fpm進(jìn)程數(shù)量,在動(dòng)態(tài)方式下他限定php-fpm的最大進(jìn)程數(shù)(這里要注意pm.max_spare_servers的值只能小于等于pm.max_children)
pm.start_servers
- 動(dòng)態(tài)方式下的起始php-fpm進(jìn)程數(shù)量。
pm.min_spare_servers
- 保證空閑進(jìn)程數(shù)最小值,如果空閑進(jìn)程小于此值,則創(chuàng)建新的子進(jìn)程
pm.max_spare_servers
- 保證空閑進(jìn)程數(shù)最大值,如果空閑進(jìn)程大于此值,此進(jìn)行清理
- 如果dm設(shè)置為static,那么其實(shí)只有pm.max_children這個(gè)參數(shù)生效。系統(tǒng)會(huì)開啟參數(shù)設(shè)置數(shù)量的php-fpm進(jìn)程。php-fpm一個(gè)進(jìn)程大概會(huì)占20m-40m的內(nèi)存,所以他的數(shù)字大小的設(shè)置要根據(jù)你的物理內(nèi)存的大小來設(shè)置,還要注意到其他的內(nèi)存占用,如數(shù)據(jù)庫(kù),系統(tǒng)進(jìn)程等,來確定以上4個(gè)參數(shù)的設(shè)定值!
- 如果dm設(shè)置為dynamic,4個(gè)參數(shù)都生效。系統(tǒng)會(huì)在php-fpm運(yùn)行開始時(shí)啟動(dòng)pm.start_servers個(gè)php-fpm進(jìn)程,然后根據(jù)系統(tǒng)的需求動(dòng)態(tài)在pm.min_spare_servers和pm.max_spare_servers之間調(diào)整php-fpm進(jìn)程數(shù)。參數(shù)要求pm.start_servers的值在pm.min_spare_servers和pm.max_spare_servers之間。
pm.max_requests = 1000
- 設(shè)置每個(gè)子進(jìn)程重生之前服務(wù)的請(qǐng)求數(shù).
- 最大處理請(qǐng)求數(shù)是指一個(gè)php-fpm的worker進(jìn)程在處理多少個(gè)請(qǐng)求后就終止掉,master進(jìn)程會(huì)重新respawn一個(gè)新的。 這個(gè)配置的主要目的是避免php解釋器或程序引用的第三方庫(kù)造成的內(nèi)存泄露。
- 對(duì)于可能存在內(nèi)存泄漏的第三方模塊來說是非常有用的. 如果設(shè)置為 '0' 則一直接受請(qǐng)求. 等同于 PHP_FCGI_MAX_REQUESTS 環(huán)境變量. 默認(rèn)值: 0.
pm.status_path = /status
- FPM狀態(tài)頁(yè)面的網(wǎng)址. 如果沒有設(shè)置, 則無法訪問狀態(tài)頁(yè)面. 默認(rèn)值: none. munin監(jiān)控會(huì)使用到
ping.path = /ping
- FPM監(jiān)控頁(yè)面的ping網(wǎng)址. 如果沒有設(shè)置, 則無法訪問ping頁(yè)面. 該頁(yè)面用于外部檢測(cè)FPM是否存活并且可以響應(yīng)請(qǐng)求. 請(qǐng)注意必須以斜線開頭 (/)。
ping.response = pong
- 用于定義ping請(qǐng)求的返回相應(yīng). 返回為 HTTP 200 的 text/plain 格式文本. 默認(rèn)值: pong.
request_terminate_timeout = 0
- 設(shè)置單個(gè)請(qǐng)求的超時(shí)中止時(shí)間. 該選項(xiàng)可能會(huì)對(duì)php.ini設(shè)置中的'max_execution_time'因?yàn)槟承┨厥庠驔]有中止運(yùn)行的腳本有用. 設(shè)置為 '0' 表示 'Off'.當(dāng)經(jīng)常出現(xiàn)502錯(cuò)誤時(shí)可以嘗試更改此選項(xiàng)。
request_slowlog_timeout = 10s
- 當(dāng)一個(gè)請(qǐng)求該設(shè)置的超時(shí)時(shí)間后,就會(huì)將對(duì)應(yīng)的PHP調(diào)用堆棧信息完整寫入到慢日志中. 設(shè)置為 '0' 表示 'Off'
slowlog = log/$pool.log.slow
- 慢請(qǐng)求的記錄日志,配合request_slowlog_timeout使用
rlimit_files = 1024
- 設(shè)置文件打開描述符的rlimit限制. 默認(rèn)值: 系統(tǒng)定義值默認(rèn)可打開句柄是1024,可使用 ulimit -n查看,ulimit -n 2048修改。
rlimit_core = 0
- 設(shè)置核心rlimit最大限制值. 可用值: 'unlimited' 、0或者正整數(shù). 默認(rèn)值: 系統(tǒng)定義值.
chroot =
- 啟動(dòng)時(shí)的Chroot目錄. 所定義的目錄需要是絕對(duì)路徑. 如果沒有設(shè)置, 則chroot不被使用.
chdir =
- 設(shè)置啟動(dòng)目錄,啟動(dòng)時(shí)會(huì)自動(dòng)Chdir到該目錄. 所定義的目錄需要是絕對(duì)路徑. 默認(rèn)值: 當(dāng)前目錄,或者/目錄(chroot時(shí))
catch_workers_output = yes
- 重定向運(yùn)行過程中的stdout和stderr到主要的錯(cuò)誤日志文件中. 如果沒有設(shè)置, stdout 和 stderr 將會(huì)根據(jù)FastCGI的規(guī)則被重定向到 /dev/null . 默認(rèn)值: 空.`
clear_env = no
??????????
- 清理環(huán)境
variables_order
variables_order參數(shù)詳解在另一篇文章 url: juejin.im/post/5c4eea…
常見錯(cuò)誤及解決辦法整理
請(qǐng)求的超時(shí)中止時(shí)間未設(shè)置
- request_terminate_timeout的值如果設(shè)置為0或者過長(zhǎng)的時(shí)間,可能會(huì)引起PHP 腳本會(huì)一直執(zhí)行下去。這樣,當(dāng)所有的 php-cgi 進(jìn)程都卡在 file_get_contents() 函數(shù)時(shí),這臺(tái) Nginx+PHP 的 WebServer 已經(jīng)無法再處理新的 PHP 請(qǐng)求了,Nginx 將給用戶返回“502 Bad Gateway”。設(shè)置一個(gè) PHP腳本最大執(zhí)行時(shí)間是必要的,但是,治標(biāo)不治本。例如改成 30s,如果發(fā)生 file_get_contents() 獲取網(wǎng)頁(yè)內(nèi)容較慢的情況,這就意味著 150 個(gè) php-cgi 進(jìn)程,每秒鐘只能處理 5 個(gè)請(qǐng)求,WebServer 同樣很難避免"502 Bad Gateway"。解決辦法是request_terminate_timeout設(shè)置為10s或者一個(gè)合理的值,或者給file_get_contents加一個(gè)超時(shí)參數(shù)!
max_requests參數(shù)配置不當(dāng)
-
max_requests參數(shù)配置不當(dāng),可能會(huì)引起間歇性502錯(cuò)誤:
pm.max_requests = 1000
-
設(shè)置每個(gè)子進(jìn)程重生之前服務(wù)的請(qǐng)求數(shù). 對(duì)于可能存在內(nèi)存泄漏的第三方模塊來說是非常有用的. 如果設(shè)置為 '0' 則一直接受請(qǐng)求. 等同于 PHP_FCGI_MAX_REQUESTS 環(huán)境變量. 默認(rèn)值: 0. 這段配置的意思是,當(dāng)一個(gè) PHP-CGI 進(jìn)程處理的請(qǐng)求數(shù)累積到 500 個(gè)后,自動(dòng)重啟該進(jìn)程。
-
但是為什么要重啟進(jìn)程呢?
-
一般在項(xiàng)目中,我們多多少少都會(huì)用到一些 PHP 的第三方庫(kù),這些第三方庫(kù)經(jīng)常存在內(nèi)存泄漏問題,如果不定期重啟 PHP-CGI 進(jìn)程,勢(shì)必造成內(nèi)存使用量不斷增長(zhǎng)。因此 PHP-FPM 作為 PHP-CGI 的管理器,提供了這么一項(xiàng)監(jiān)控功能,對(duì)請(qǐng)求達(dá)到指定次數(shù)的 PHP-CGI 進(jìn)程進(jìn)行重啟,保證內(nèi)存使用量不增長(zhǎng)。
php-fpm的慢日志,debug及異常排查神器
-
request_slowlog_timeout設(shè)置一個(gè)超時(shí)的參數(shù),slowlog設(shè)置慢日志的存放位置,tail -f /var/log/www.slow.log即可看到執(zhí)行過慢的php過程。 大家可以看到經(jīng)常出現(xiàn)的網(wǎng)絡(luò)讀取超過、Mysql查詢過慢的問題,根據(jù)提示信息再排查問題就有很明確的方向了。
推薦教程:《php教程》