[转]php-fpm配置详解

[转]php-fpm配置详解

php-fpm详解原文链接：http://php-fpm.anight.org/
wiki：http://www.php-fpm.com/
翻译：http://syre.blogbus.com/logs/20092011.html什么是 FastCGIFastCGI 是一个可伸缩、高速的在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）。FAQQ：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 开发团队，并被建议包含。邮件列表如果你有问题的话，请不要犹豫在邮件组里写邮件。English: highload-php-en Russian: highload-php-ru文档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.pidmaster进程可以理解以下信号：

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.Money15/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.ha97.com/95.html来源：http://blog.chinaunix.net/uid-10565106-id-3313429.html

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.conf重要参数详解

三，常见错误及解决办法整理

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加一个超时参数。

2,max_requests参数配置不当，可能会引起间歇性502错误：

设置每个子进程重生之前服务的请求数. 对于可能存在内存泄漏的第三方模块来说是非常有用的. 如果设置为 ’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设置慢日志的存放位置上面的命令即可看到执行过慢的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-fpm8.命令行下执行php，提示找不到命令-bash: /usr/bin/php: No such file or directoryvi /etc/profile在文件底部增加一行配置
export PATH=/usr/local/php/bin:$PATH保存退出source /etc/profile

来源：http://www.cnblogs.com/argb/p/3604340.html

php-fpm参数优化

php-fpm进程设置多少合适，设成动态还是静态？《lnmp一键安装包》中会根据你服务器内存调整php-fpm进程数。下面是摘自Google讨论话题：《 PHP-FPM on highload tips 》[墙外，翻墙可参考goagent]。When you running a highload website with PHP-FPM via FastCGI, the following tips may be useful to you
如果你的高负载网站使用PHP-FPM管理FastCGI，也许下面这些技巧对你有用1. Compile PHP's modules as less as possible, the simple the best (fast);
尽量少安装PHP模块，最简单是最好（快）的2. Increas PHP FastCGI child number to 100 and even more. Sometime, 200 is OK! ( On 4GB memory server);
把你的PHP FastCGI子进程数调到100或以上，在4G内存的服务器上200就可以（建议压力测试来得出自己服务器合理的值）3. Using SOCKET PHP FastCGI, and put into /dev/shm on Linux;
socket连接FastCGI，/dev/shm是内存文件系统，socket放在内存中肯定会快些4. Increase Linux "max open files", using the following command (must be root):
Linux下增加文件打开数，命令如下：cat >> /etc/security/limits.conf <<EOF
* soft nproc 65535
* hard nproc 65535
* soft nofile 65535
* hard nofile 65535
EOF5. Increase PHP-FPM open file description rlimit:
增加 PHP-FPM 打开文件描述符的限制：# vi $php_install_dir/etc/php-fpm.conf
rlimit_files = 512006. Using PHP code accelerator, e.g eAccelerator, XCache. And set "cache_dir" to /dev/shm on Linux.
使用php代码加速器，例如 eAccelerator, XCache.在Linux平台上可以把`cache_dir`指向 /dev/shm/usr/local/php/etc/php-fpm.conf重要优化参数详解：pm = dynamicpm参数指定了进程管理方式，有两种可供选择：static或dynamic，从字面意思不难理解，为静态或动态方式。如果是静态方式，那么在php-fpm启动的时候就创建了指定数目的进程，在运行过程中不会再有变化(并不是真的就永远不变)；而动态的则在运行过程中动态调整，当然并不是无限制的创建新进程，受pm.max_spare_servers参数影响；动态适合小内存机器，灵活分配进程，省内存。静态适用于大内存机器，动态创建回收进程对服务器资源也是一种消耗pm.max_children = 24static模式下创建的子进程数或dynamic模式下同一时刻允许最大的php-fpm子进程数量pm.start_servers = 16#动态方式下的起始php-fpm进程数量pm.min_spare_servers = 12#动态方式下服务器空闲时最小php-fpm进程数量pm.max_spare_servers = 24#动态方式下服务器空闲时最大php-fpm进程数量一般php-fpm进程占用20~30m左右的内存就按30m算。如果单独跑php-fpm，动态方式起始值可设置物理内存Mem/30M，由于大家一般Nginx、MySQL都在一台机器上，于是预留一半给它们，即php-fpm进程数为$Mem/2/30。LNMP在一台机器上参数（仅供参考，建议压力测试得出）：Mem=`free -m | awk '/Mem:/{print $2}'` #我的机器内存是987M
sed -i "s@^pm.max_children.*@pm.max_children = $(($Mem/2/20))@" $php_install_dir/etc/php-fpm.conf
sed -i "s@^pm.start_servers.*@pm.start_servers = $(($Mem/2/30))@" $php_install_dir/etc/php-fpm.conf
sed -i "s@^pm.min_spare_servers.*@pm.min_spare_servers = $(($Mem/2/40))@" $php_install_dir/etc/php-fpm.conf
sed -i "s@^pm.max_spare_servers.*@pm.max_spare_servers = $(($Mem/2/20))@" $php_install_dir/etc/php-fpm.conf987M内存：pm = dynamic
pm.max_children = 24
pm.start_servers = 16
pm.min_spare_servers = 12
pm.max_spare_servers = 24

来源：https://blog.linuxeye.com/380.html