php-fpm詳解

php-fpm詳解

原文連結：http://php-fpm.anight.org/
wiki：http://www.php-fpm.com/
翻譯：http://syre.blogbus.com/logs/20092011.html

什麼是 FastCGI

FastCGI 是一個可伸縮、高速的在web server和指令碼語言間通迅的介面。關於FastCGI技術的更多資訊可以在官方網站和Wikipedia看到。

FastCGI 被許多指令碼語言所支援，包括 php，如果用 --enable-fastcgi 選項編譯的話。

多數流行的web server都支援 FastCGI。包括Apache（mod_fastcgi和mod_fcgid），Zeus，nginx和lighttpd。

FastCGI 的主要優點是把動態語言和 web server 分離開來。這種技術允許 web server 和動態語言運行在不同的主機上。這可以改進可擴充性和安全性而沒有大的效率損失。

php-fpm 可以和任何支援外部 FastCGI 技術的 web server 一起使用。

php-fpm是做啥用的

很不幸，官方網站 php.net 上的 php 在將 FastCGI SAPI 用於生產環境方面有許多已知的問題。

下面是關於啟用 FastCGI SAPI 時的問題和 php-fpm 是如何解決他們的對比列表。

描述 php內建的 spawn-fcgi + spawn-php.sh + daemontools php-fpm

php守護進程化： pid file, log file, setsid(), setuid(), setgid(), chroot()	(-)	(+)	(+)
進程管理。可以用 "graceful" 來停止並啟動 php worker 進程而不會丟失請求。能夠平滑地升級配置和二進位程式而不丟失任何請求。	php4 (-), php5 (只有 graceful)	(-)	(+)
嚴格限制來源請求的 web server 的 ip 地址	php4 (-) php5 (+) (從 5.2.2 開始)	(-)	(+)
根據負載動態調整進程數	(-)	(-)	Todo
用不同的 uid/gid/chroot/environment 和不同的 php.ini 選項啟動 worder 進程。你不需要 safe mode 了！	(-)	(-)	(+)
記錄 worker 進程 stdout 和 stderr 日誌	(-)	(-)	(+)
如果使用最佳化器，在共用記憶體意外破壞的情況下緊急重啟所有的進程	(-)	(-)	(+)
如果 set_time_limit() 失敗，確保進程會結束	(-)	(-)	(+)
特色功能 Error header、最佳化的上傳支援、fastcgi_finish_request()

特色功能

所有這些特性都是“不打斷”的方式實現的。也就是說，如果你不使用它們，它們的存在不會影響php的功能性??他們都是“透明”的。

Error header
範圍：php.ini 選項
分類：便利性

預設情況下，如果被訪問的php指令碼包含語法錯誤，使用者會收到一個空的“200 ok”頁。這是不方便的。Error header 這個 php.ini 選項允許在這種情況下產生一個 HTTP 錯誤碼，比如“HTTP/1.0 550 Server Made Big Boo”，從而中斷web server請求並顯示一個正確的錯誤頁。

如果要實現這樣的功能，需要在 php.ini 中添加一條 fastcgi.error_header = "HTTP/1.0 550 Server Made Big Boo"

在 php-5.2.4 中添加了類似，但不相同的功能：如果被訪問的php指令碼包含語法錯誤，並且 display_errors = off，會立刻返回“HTTP/1.0 500 Internal Server Error”。

如果你需要設定一個 503 錯誤，或者想要使這個行為獨立於 display_errors 的設定，那麼可以使用fastcgi.error_header。如果你在 php-5.2.5 或以上版本上啟用 php-fpm，那麼 fastcgi.error_header的優先順序更高。

最佳化的上傳支援
實質：web server 支援
類型：最佳化

這個特性正如名字那樣，可以加速對大 POST 請求的處理速度，包括檔案上傳。最佳化是通過將請求體已寫入一個臨時檔案，然後 fastcgi 協議傳遞檔案名稱而不是請求體到來實現的。目前就我所知，只有 nginx0.5.9 以上才支援這個功能。顯然，這種模式只在 php 和 web server 在一台機器上的時候才能用。

nginx 範例配置：

location ~ \.php$ {
fastcgi_pass_request_body off;
client_body_in_file_only clean;
fastcgi_param REQUEST_BODY_FILE $request_body_file;
...
fastcgi_pass ...;
}

在php中不需要配置任何東西。如果php收到了參數REQUEST_BODY_FILE，就讀取其中的請求體，如果沒有，就自行從fastcgi 協議中讀取請求體。

結合這個特性，可以考慮對臨時檔案使用記憶體檔案系統，例如tmpfs(linux)：

client_body_temp_path /dev/shm/client_body_temp;

fastcgi_finish_request()
範圍：php 函數
類型：最佳化

這個特性可以提高一些 php 請求的處理速度。如果有些處理可以在頁面產生完後進行，就可以使用這種最佳化。比如，在 memcached 中儲存 session 就可以在頁面交給 web server 後進行。fastcgi_finisth_request() ，這一特性可以結束響應輸出，web server 可以立即開始交給等不及的用戶端，而此刻，php 可以在請求的上下文環境中處理許多事情。比如儲存session，轉換上傳的視頻，處理統計等等。

fastcgi_finisth_request() 會觸發 shutdown 函數運行。

request_slowlog_timeout
範圍: php-fpm.conf 選項
分類: 方便

這個選項能讓你跟蹤執行緩慢的指令碼並把他們連同調用棧一起記錄再記錄檔中。例如如下設定：

5s
logs/slow.log

記錄的 slow.log 可能是這個樣子：

Sep 21 16:22:19.399162 pid 29715 (pool default)
script_filename = /local/www/stable/www/catalogue.php
[0x00007fff23618120] mysql_query() /srv/stable/common/Database/class.MySQLRequest.php:20
[0x00007fff23618560] getResult() /srv/stable/common/Database/class.Facade.php:106
[0x00007fff23618aa0] query() /srv/stable/common/mysite.com/ORM/class.UsersMapper.php:99
[0x00007fff23618d60] resolveByID() /srv/stable/common/mysite.com/ORM/class.User.php:629
[0x00007fff236193b0] getData() /srv/stable/common/class.DataEntity.php:90
[0x00007fff236195d0] load() /srv/stable/common/mysite.com/ORM/class.User.php:587
[0x00007fff23619a00] getIsHidden() /srv/stable/common/mysite.com/class.User.php:42
[0x00007fff2361a470] getName() /local/www/stable/www/catalogue.php:41

同時，在 error.log 中儲存了如下記錄：

Sep 21 16:22:19.399031 [WARNING] fpm_request_check_timed_out(), line 135: child 29715, script '/local/www/stable/www/catalogue.php' (pool default) executing too slow (5.018002 sec), logging

正如你再例子中看到的，指令碼運行了 5 秒以上，並很可能是由於 mysql 響應慢造成的（top backtrace）。

FAQ

Q：php-fpm 可以和 ZendOptimize 一起用嗎？
A：完全可以。

Q：php-fpm 可以和 ZendPlatform、xcache、eAccelerator、APC 等的最佳化器一起用嗎？
A：是的。php-fpm 的架構和任何一種用於高速 opcode 緩衝的共用記憶體都適用。唯一的限制是：所有的 worker 進程只能適用一個緩衝，即使它們用不同的 uid/gid 運行

Q：為什麼我要給 php 打補丁呢？spawn-fcgi 不需要這樣！
A：php-fpm 的建立是為了增強方便管理。沒有打過補丁的 php 不能做到：

平滑重啟 php 而不丟失請求，包括升級 php 二進位檔案 以及/或者 擴充。
用不同的 uid / gid / chroot 環境運行 worker 進程
所有的設定只有一個設定檔
根據負載動態請求 （TODO）
對 php 請求即時統計效能 （TODO）

Q：為什麼要用 root 運行 php-fpm 呢？這安全嗎？
A：用 root 啟動 php-fpm 只有在你打算用不同 uid/gid 的 php 來處理請求時才有意義。比如，在共用主機上的不同網站。因為只有在 master 進程用 root 啟動並執行時候，才可以建立不同 uid/gid 的子進程。這是相當安全的。master 進程自己從來不會去處理請求。
在任何情況下，php- fpm 都不會用 root 身份來處理請求。

Q：php-fpm 可以加速 php 指令碼處理速度嗎？
A：不，它不會影響處理速度。不過，如果你使用一些特殊特性，對於一些特定的請求還是可以有效能提升的。

Q：如果我把我的網站從 mod_php 遷移到 php-fpm ，我會得到效能提升嗎？
A：通常，當有伺服器上有大量空閑記憶體可用時，能從遷移到 php-fpm 中得到的效能提升可能不大。但是如果記憶體並不充裕，效能提升還是很可觀的，在某些情況下可以達到 300-500%。這可能是由於 nginx + php-fpm 一般會比 Apache + mod_php 使用更少的記憶體。而且 VFS 緩衝會由於更多的空餘記憶體而更有效地工作。

Q：php- fpm 將來會被官方的 php 包含嗎？
A：我希望如此。目前，php-fpm 代碼的協議是 GPL 。所以現在 php-fpm 的代碼與 php 協議（類似 bsd）並不匹配。這是臨時性措施。這樣的選擇是為了簡化開發過程。一旦代碼的功能完備，比如自適應產生子進程和其他一些東西，協議會改為一個相匹配的。之後，php-fpm 會正式發布給 php Team Dev，並被建議包含。

文檔

php-fpm 已經在 Linux、MacOSX、Solaris 和 FreeBSD 上測試通過。

確信 libxml2（在某些系統上叫做libxml2-devel）已經安裝。

下載最小的 php 和 php-fpm

$ bzip2 -cd php-5.2.5.tar.bz2 | tar xf -
$ gzip -cd php-5.2.5-fpm-0.5.7.diff.gz | patch -d php-5.2.5 -p1
$ cd php-5.2.5
$ ./configure --enable-fastcgi --enable-fpm
$ make all install

編輯

$prefix/etc/php-fpm.conf

運行

$prefix/bin/php-cgi --fpm

仔細檢查

$prefix/logs/php-fpm.log

運行 phpinfo() 檢查你的網站是否還正常運行

master 進程的 pid 被存放在

$prefix/logs/php-fpm.pid

master進程可以理解以下訊號：

SIGINT, SIGTERM	立刻終止
SIGQUIT	平滑終止
SIGUSR1	重新開啟記錄檔
SIGUSR2	平滑重載所有worker進程並重新載入配置和二進位

關於

嗨，我的名字叫 Andrei Nigmatulin， 我是 php-fpm 的作者。

從 2004 年開始，我就在等有什麼人讓 PHP FastCGI 能滿足產品環境，但我等不下去了。

php-fpm 是在數個項目種使用 PHP 的 FastCGI SAPI 中的知識、經驗和想法的產物。

php-fpm 可以在 GPL 協議下用在公用用途。和 php-fpm 綁定的修改版的 libevent 是在 BSD 協議下發布的。

我需要得到您的反饋??新的想法和建議??來改進和最佳化 php FastCGI SAPI。 如果您有什麼想法、意見、補充和建議，我會很高興，很原意聽取，也許還會實現他們。給給我發郵件吧。（地址在本頁的末尾）。

如果你想支援 php-fpm 的開發，可以作一些捐贈： Paypal Yandex.Money

15/05/2007 - 第一次提交到 php-fpm.

andrei dot nigmatulin at gmail dot com
譯註：
php-fpm還帶有一個更方便的指令碼，在$prefix/sbin/php-fpm。可以用php-fpm start|graceful|restart|stop來維護。稍編輯一下就可以讓它使用設定檔。

後記：

最開始，php-fpm 只有俄文文檔，弄的我很鬱悶，於是我先用 google 翻譯先弄成英文，然後再人工翻成中文。這當中會難免會在我自己的英文水平引起的錯誤之外，再多些錯誤出來。後來終於有了一個英文的 wiki，並邀請我提供中文翻譯。同時，距上一次翻譯（2008年5月）以後，原來的文檔也已經有了更新。於是我就根據英文 wiki ，重新翻譯了一遍。

轉：http://www.21andy.com/blog/20100219/1700.html

