php.ini是php運行核心配置文件,下面是一些經常使用配置
extension_dir=""
php
expose_php = Off
html
display_errors = Off
mysql
log_errors = On
nginx
- 在關閉display_errors後開啓PHP錯誤日誌(路徑在php-fpm.conf中配置)
zend_extension=opcache.so extension=mysqli.so extension=pdo_mysql.so
sql
date.timezone = PRC
數據庫
opcache.enable=1
服務器
open_basedir = /usr/share/nginx/html;
網絡
- 設置PHP腳本容許訪問的目錄(須要根據實際狀況配置)
php-fpm.conf是php-fpm進程服務的配置文件,下面是一些經常使用配置
error_log = /usr/local/php/logs/php-fpm.log
php7
include=/usr/local/php7/etc/php-fpm.d/*.conf
socket
php-fpm.conf 以及 www.conf的主要配置信息
pid = run/php-fpm.pid
- pid設置,默認在安裝目錄中的var/run/php-fpm.pid,建議開啓
error_log = log/php-fpm.log
- 錯誤日誌,默認在安裝目錄中的var/log/php-fpm.log
log_level = notice
- 錯誤級別. 可用級別爲: alert(必須當即處理), error(錯誤狀況), warning(警告狀況), notice(通常重要信息), debug(調試信息). 默認: notice.
emergency_restart_threshold = 60
emergency_restart_interval = 60s
- 表示在emergency_restart_interval所設值內出現SIGSEGV或者SIGBUS錯誤的php-cgi進程數若是超過 emergency_restart_threshold個,php-fpm就會優雅重啓。這兩個選項通常保持默認值。
process_control_timeout = 0
- 設置子進程接受主進程複用信號的超時時間. 可用單位: s(秒), m(分), h(小時), 或者 d(天) 默認單位: s(秒). 默認值: 0.
daemonize = yes
- 後臺執行fpm,默認值爲yes,若是爲了調試能夠改成no。在FPM中,可使用不一樣的設置來運行多個進程池。 這些設置能夠針對每一個進程池單獨設置。
listen = 127.0.0.1:9000
- 監聽端口,即nginx中php處理的地址,通常默認值便可。可用格式爲: 'ip:port', 'port', '/path/to/unix/socket'. 每一個進程池都須要設置.
listen.backlog = -1
- backlog數,-1表示無限制,由操做系統決定,此行註釋掉就行。
listen.allowed_clients = 127.0.0.1
- 容許訪問FastCGI進程的IP,設置any爲不限制IP,若是要設置其餘主機的nginx也能訪問這臺FPM進程,listen處要設置成本地可被訪問的IP。默認值是any。每一個地址是用逗號分隔. 若是沒有設置或者爲空,則容許任何服務器請求鏈接
listen.owner = www listen.group = www listen.mode = 0666
- unix socket設置選項,若是使用tcp方式訪問,這裏註釋便可。
user = www group = www
php-fpm 進程池優化方法
pm = dynamic
- 對於專用服務器,pm能夠設置爲static。 如何控制子進程,選項有static和dynamic。若是選擇static,則由pm.max_children指定固定的子進程數。若是選擇dynamic,則由下開參數決定:
pm.max_children
- 靜態方式下開啓的php-fpm進程數量,在動態方式下他限定php-fpm的最大進程數(這裏要注意pm.max_spare_servers的值只能小於等於pm.max_children)
pm.start_servers
pm.min_spare_servers
- 保證空閒進程數最小值,若是空閒進程小於此值,則建立新的子進程
pm.max_spare_servers
- 保證空閒進程數最大值,若是空閒進程大於此值,此進行清理
- 若是dm設置爲static,那麼其實只有pm.max_children這個參數生效。系統會開啓參數設置數量的php-fpm進程。php-fpm一個進程大概會佔20m-40m的內存,因此他的數字大小的設置要根據你的物理內存的大小來設置,還要注意到其餘的內存佔用,如數據庫,系統進程等,來肯定以上4個參數的設定值!
- 若是dm設置爲dynamic,4個參數都生效。系統會在php-fpm運行開始時啓動pm.start_servers個php-fpm進程,而後根據系統的需求動態在pm.min_spare_servers和pm.max_spare_servers之間調整php-fpm進程數。參數要求pm.start_servers的值在pm.min_spare_servers和pm.max_spare_servers之間。
pm.max_requests = 1000
- 設置每一個子進程重生以前服務的請求數.
- 最大處理請求數是指一個php-fpm的worker進程在處理多少個請求後就終止掉,master進程會從新respawn一個新的。 這個配置的主要目的是避免php解釋器或程序引用的第三方庫形成的內存泄露。
- 對於可能存在內存泄漏的第三方模塊來講是很是有用的. 若是設置爲 '0' 則一直接受請求. 等同於 PHP_FCGI_MAX_REQUESTS 環境變量. 默認值: 0.
pm.status_path = /status
- FPM狀態頁面的網址. 若是沒有設置, 則沒法訪問狀態頁面. 默認值: none. munin監控會使用到
ping.path = /ping
- FPM監控頁面的ping網址. 若是沒有設置, 則沒法訪問ping頁面. 該頁面用於外部檢測FPM是否存活而且能夠響應請求. 請注意必須以斜線開頭 (/)。
ping.response = pong
- 用於定義ping請求的返回相應. 返回爲 HTTP 200 的 text/plain 格式文本. 默認值: pong.
request_terminate_timeout = 0
- 設置單個請求的超時停止時間. 該選項可能會對php.ini設置中的'max_execution_time'由於某些特殊緣由沒有停止運行的腳本有用. 設置爲 '0' 表示 'Off'.當常常出現502錯誤時能夠嘗試更改此選項。
request_slowlog_timeout = 10s
- 當一個請求該設置的超時時間後,就會將對應的PHP調用堆棧信息完整寫入到慢日誌中. 設置爲 '0' 表示 'Off'
slowlog = log/$pool.log.slow
- 慢請求的記錄日誌,配合request_slowlog_timeout使用
rlimit_files = 1024
- 設置文件打開描述符的rlimit限制. 默認值: 系統定義值默承認打開句柄是1024,可以使用 ulimit -n查看,ulimit -n 2048修改。
rlimit_core = 0
- 設置核心rlimit最大限制值. 可用值: 'unlimited' 、0或者正整數. 默認值: 系統定義值.
chroot =
- 啓動時的Chroot目錄. 所定義的目錄須要是絕對路徑. 若是沒有設置, 則chroot不被使用.
chdir =
- 設置啓動目錄,啓動時會自動Chdir到該目錄. 所定義的目錄須要是絕對路徑. 默認值: 當前目錄,或者/目錄(chroot時)
catch_workers_output = yes
- 重定向運行過程當中的stdout和stderr到主要的錯誤日誌文件中. 若是沒有設置, stdout 和 stderr 將會根據FastCGI的規則被重定向到 /dev/null . 默認值: 空.`
clear_env = no
variables_order
variables_order參數詳解在另外一篇文章 url: juejin.im/post/5c4eea…
常見錯誤及解決辦法整理
請求的超時停止時間未設置
- request_terminate_timeout的值若是設置爲0或者過長的時間,可能會引發PHP 腳本會一直執行下去。這樣,當全部的 php-cgi 進程都卡在 file_get_contents() 函數時,這臺 Nginx+PHP 的 WebServer 已經沒法再處理新的 PHP 請求了,Nginx 將給用戶返回「502 Bad Gateway」。設置一個 PHP腳本最大執行時間是必要的,可是,治標不治本。例如改爲 30s,若是發生 file_get_contents() 獲取網頁內容較慢的狀況,這就意味着 150 個 php-cgi 進程,每秒鐘只能處理 5 個請求,WebServer 一樣很難避免"502 Bad Gateway"。解決辦法是request_terminate_timeout設置爲10s或者一個合理的值,或者給file_get_contents加一個超時參數!
max_requests參數配置不當
-
max_requests參數配置不當,可能會引發間歇性502錯誤: pm.max_requests = 1000
-
設置每一個子進程重生以前服務的請求數. 對於可能存在內存泄漏的第三方模塊來講是很是有用的. 若是設置爲 '0' 則一直接受請求. 等同於 PHP_FCGI_MAX_REQUESTS 環境變量. 默認值: 0. 這段配置的意思是,當一個 PHP-CGI 進程處理的請求數累積到 500 個後,自動重啓該進程。
-
可是爲何要重啓進程呢?
-
通常在項目中,咱們多多少少都會用到一些 PHP 的第三方庫,這些第三方庫常常存在內存泄漏問題,若是不按期重啓 PHP-CGI 進程,勢必形成內存使用量不斷增加。所以 PHP-FPM 做爲 PHP-CGI 的管理器,提供了這麼一項監控功能,對請求達到指定次數的 PHP-CGI 進程進行重啓,保證內存使用量不增加。
php-fpm的慢日誌,debug及異常排查神器
- request_slowlog_timeout設置一個超時的參數,slowlog設置慢日誌的存放位置,tail -f /var/log/www.slow.log便可看到執行過慢的php過程。 你們能夠看到常常出現的網絡讀取超過、Mysql查詢過慢的問題,根據提示信息再排查問題就有很明確的方向了。