php-fpm文档中文翻译

版权声明:转载时请以超链接形式标明文章原始出处和作者信息及本声明
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自带的 spawn-fcgi + spawn-php.sh + daemontools php-fpm php守护程序: pid file, log file, setsid(), setuid(), setgid(), chroot() (-) (+) (+) 进程控制,可以平滑地重启、重新载入配置和二进制模块而不丢失请求 php4 – php5 只能平滑停止 (-) (+) 限制ip地址,可以满足web server的要求 php4 (-) php5 (+) (从 5.2.2 开始) (-) (+) 根据负载动态调整进程数 (-) (-) Todo 使用用不同的uid / gid / chroot / 环境变量,不同的 php.ini 选项,不需要safe mode (-) (-) (+) 记录work process的stdout和stderr (-) (-) (+) 如果使用优化器,在遇到opcode缓存随机损坏的时候紧急重启所有进程 (-) (-) (+) 如果set_time_limit没有起作用,强制结束过期进程 (-) (-) Todo 特色功能 Error header、优化的上传支持、fastcgi_finish_request()

特色功能

所有的这些功能都是用不打断的方式。也就是说,如果你不使用他们,他们的存在不会影响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帮我挑了几个错。