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)程的帳戶和組
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
子進(jìn)程最大數(shù)
pm.start_servers
啟動(dòng)時(shí)的進(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)行清理
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.
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)值: 空.`
常見錯(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ù)提示信息再排查問題就有很明確的方向了涯竟。