php fpm官方文档,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帮我挑了几个错。