php-fpm解釋的範例程式碼分享

約定幾個目錄

• /usr/local/php/sbin/php-fpm

• /usr/local/php/etc/php-fpm.conf

• #/usr/local/php/etc/php.ini

一，php-fpm的啟動參數

#测试php-fpm配置/usr/local/php/sbin/php-fpm -t
/usr/local/php/sbin/php-fpm -c 
/usr/local/php/etc/php.ini -y 
/usr/local/php/etc/php-fpm.conf -t
#启动
php-fpm/usr/local/php/sbin/php-fpm
/usr/local/php/sbin/php-fpm -c 
/usr/local/php/etc/php.ini -y 
/usr/local/php/etc/php-fpm.conf
#关闭
php-fpmkill -INT `cat 
/usr/local/php/var/run/php-fpm.pid`
#重启
php-fpmkill -USR2 `cat 
/usr/local/php/var/run/php-fpm.pid`

二，php-fpm.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
#fpm监听端口，即nginx中php处理的地址，一般默认值即可。可用格式为: 'ip:port', 'port', '/path/to/unix/socket'. 每个进程池都需要设置.

listen.backlog = -1
#backlog数，-1表示无限制，由操作系统决定，此行注释掉就行。backlog含义参考：http://www.3gyou.cc/?p=41

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
#启动进程的帐户和组

pm = dynamic #对于专用服务器，pm可以设置为static。
#如何控制子进程，选项有static和dynamic。如果选择static，则由pm.max_children指定固定的子进程数。如果选择dynamic，则由下开参数决定：
pm.max_children #，子进程最大数
pm.start_servers #，启动时的进程数
pm.min_spare_servers #，保证空闲进程数最小值，如果空闲进程小于此值，则创建新的子进程
pm.max_spare_servers #，保证空闲进程数最大值，如果空闲进程大于此值，此进行清理

pm.max_requests = 1000
#设置每个子进程重生之前服务的请求数. 对于可能存在内存泄漏的第三方模块来说是非常有用的. 
如果设置为 '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'因为某些特殊原因没有中止运行的脚本有用. 

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 . 默认值: 空.

三，

常見錯誤

及解決辦法整理

1,request_terminate_timeout引起的資源問題

request_terminate_timeout的值如果設定為0或過長的時間，可能會造成file_get_contents的資源問題。

如果file_get_contents請求的遠端資源如果反應過慢，file_get_contents就會一直卡在那裡不會逾時。我們知道php.ini 裡面max_execution_time 可以設定 PHP 腳本的最大執行時間，但是，在 php-cgi(php-fpm) 中，這個參數不會起效。真正能夠控制 PHP 腳本最大執行時間的是 php-fpm.conf 設定檔中的request_terminate_timeout參數。

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加上一個逾時參數。

$ctx = stream_context_create(array(    
'http' => array(       
'timeout' => 10    
//设置一个超时时间，单位为秒
    )
));
file_get_contents($str, 0, $ctx);

2,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 進程進行重啟，確保記憶體使用量不會成長。

正是因為這個機制，在高並發的站點中，經常導致 502 錯誤，我猜測原因是 PHP-FPM 對從 NGINX 過來的請求隊列沒處理好。不過我目前用的還是 PHP 5.3.2，我不知道 PHP 5.3.3 是否還存在這個問題。

目前我們的解決方法是，把這個數值盡量設定大些，盡可能減少 PHP-CGI 重新 SPAWN 的次數，同時也能提升整體效能。在我們自己實際的生產環境中發現，記憶體洩漏並不明顯，因此我們將這個值設定得非常大（204800）。大家要依照自己的實際狀況設定這個數值，不能盲目地加大。

話說回來，這套機制目的只為保證 PHP-CGI 不過分地佔用內存，為何不通過檢測內存的方式來處理呢？我非常認同高春輝所說的，透過設定進程的峰值內在佔用量來重啟 PHP-CGI 進程，會是更好的解決方案。

3,php-fpm的慢日誌，debug及異常排查神器： request_slowlog_timeout設定一個逾時的參數，slowlog設定慢日誌的存放位置

# tail -f /var/log/www.slow.log

上面的指令可以看到執行過慢的php過程。 大家可以看到常出現的網路讀取超過、

MySQL######查詢###過慢的問題，根據提示資訊再排查問題就有很明確的方向了。 #########php-fpm 5.3+ 如何關閉 重新啟動？ #########php 5.3+ 下的php-fpm 不再支援php-fpm 先前具有的/usr/local/php/sbin/php-fpm (start|stop|reload)等指令，需要使用訊號控制：######master進程可以理解以下訊號######INT, TERM 立即終止QUIT 平滑終止USR1 重新開啟日誌檔案USR2 平滑重載所有worker進程並重新載入設定和二進位模組# #####範例：######php-fpm 關閉：######kill -INT ###cat /usr/local/php/var/run/php-fpm.pid#### ######php-fpm 重新啟動：######kill -USR2 ###cat /usr/local/php/var/run/php-fpm.pid######

查看php-fpm進程數：

ps aux | grep -c php-fpm

8.命令列下執行php，提示找不到命令

-bash: /usr/bin/php: No such file or directory

#vi /etc/profile

在檔案底部增加一行設定
export PATH=/usr/local/php /bin:$PATH

儲存退出

source /etc/profile

#

以上是php-fpm解釋的範例程式碼分享的詳細內容。更多資訊請關注PHP中文網其他相關文章！