神仙的仙居

版权声明：转载时请以超链接形式标明文章原始出处和作者信息及本声明
http://syre.blogbus.com/logs/20092011.html

原文链接：http://php-fpm.anight.org/

fast-cgi是做啥用的

FastCGI是一个可伸缩的，高速地在web server和脚本语言间交互的接口。关于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用于生产环境时有许多已知的问题。

下面的一些证据足以表明为什么离开了php-fpm，就很难使用FastCGI SAPI。

特色功能

所有的这些功能都是用不打断的方式。也就是说，如果你不使用他们，他们的存在不会影响php的功能，也就是透明的。

Error header

类型：方便

默认情况下，如果被访问的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设为false，且没有进一步的设置，会立刻返回"HTTP/1.0 500 Internal Server Error"。如果你需要设定一个不同于500的错误码（已经在许多情况下被使用）。或者想要使这个行为独立于display_errors的设置，那么可以使用fastcgi.error_header。如果你同时使用php-5.2.5或以上版本和php-fpm，那么fastcgi.error_header的优先级更高。

优化的上传支持

类型：优化

这个特性，就如标题那样，可以加速大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处理请求的速度。如果有些处理可以在页面生成完后进行，就可以使用这种优化。比如，在memcached中保存session就可以在页面交给web server后进行。fastcgi_finisth_request()，这一特性可以结束响应输出，web server可以立即开始交给等不及的客户端，而此刻，php可以在请求的上下文环境中处理许多事情。比如保存session，转换上传的视频，处理统计等等。

fastcgi_finisth_request()会触发shutdown 函数运行。

FAQ

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

Q：php-fpm可以和ZendPlatform、xcache、eAccelerator、APCden等等的优化器一起用吗？
A：是的。php-frpm的架构和任何一种用于高速opcode缓存的共享内存都适用。唯一的限制是：所有的worker进程只能适用一个缓存，即使它们用不同的uid/gid运行。

Q：为什么要用root运行php-fpm呢？这安全吗？
A：用root启动php-fpm只有在你打算用不同uid/gid的php来处理请求时才有意义意。比如，在共享主机上的不同站点。因为只有在master进程用root运行的时候，才可以建立不同uid/gid的子进程。这是相当安全的。master进程自己从来不会去处理请求。
在任何情况下，php-fpm都不会用root身份来处理请求。

Q：php-fpm可以加速请求处理速度吗？
A：不，没有影响。不过，如果你使用一些特殊特性，对于一些特定的请求可以有些许性能提升。

Q：php-fpm将来会被官方的php包含吗？
A：我很尊重php开发团队和他们的工作。相信他们能做得完美。但不幸的是，就我的经历看来，他们太忙了，似乎讨论php-fpm这个补丁会用相当多的时间，而我则完全没时间。

简要说明：

php-fpm是根据最小惊奇原则构建的。这是对于缺乏文档的唯一理由。我保证很快会建立一个wiki。如果你有问题的话，请不要犹豫在上面列出的邮件组里写邮件。

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 平滑终止
SIGUSR2 平滑重载所有worker进程并重新载入配置和二进制模块

译注：创建补丁后，会产生一个补丁文件。在./configuire后会提示你打上。configure比较费时，如果直接打上补丁再./configure可以省些时间。
php-fpm还带有一个更方便的脚本，在$prefix/sbin/php-fpm。可以用php-fpm start|graceful|restart|stop来维护。稍编辑一下就可以让它使用配置文件。

这个文档原来基本都是俄文的。我是用google翻译先弄成英文，然后再翻成中文。这当中会产生些错误，可能是google的，也可能是我的。如果你发现了，请指出，谢谢。

 p.s. 先感谢下digitalsonic帮我挑了几个错。