php-fpm.conf 配置详解
转?http://www.cnblogs.com/zoro/archive/2012/01/10/2317964.html
?
运行时配置<br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">FPM 配置文件为php-fpm.conf，其语法类似 php.ini 。<br style="margin: 0px; padding: 0px;">php-fpm.conf 全局配置段pid <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">string</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">PID文件的位置. 默认为空.<br style="margin: 0px; padding: 0px;">error_log <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">string</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">错误日志的位置. 默认： 安装路径#INSTALL_PREFIX#/log/php-fpm.log.<br style="margin: 0px; padding: 0px;">log_level <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">string</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">错误级别. 可用级别为: alert（必须立即处理）, error（错误情况）, warning（警告情况）, notice（一般重要信息）, debug（调试信息）. 默认: notice.<br style="margin: 0px; padding: 0px;">emergency_restart_threshold <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">int</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">如果子进程在emergency_restart_interval设定的时间内收到该参数设定次数的SIGSEGV 或者 SIGBUS退出信息号，则FPM会重新启动。 <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800080;">0</span> 表示 <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">关闭该功能</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span>. 默认值: <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800080;">0</span> (关闭).<br style="margin: 0px; padding: 0px;">emergency_restart_interval mixed<br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">emergency_restart_interval用于设定平滑重启的间隔时间. 这么做有助于解决加速器中共享内存的使用问题. 可用单位: s(秒), m(分), h(小时), 或者 d(天). 默认单位： s(秒). 默认值: <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800080;">0</span> (关闭).<br style="margin: 0px; padding: 0px;">process_control_timeout mixed<br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">设置子进程接受主进程复用信号的超时时间. 可用单位: s(秒), m(分), h(小时), 或者 d(天) 默认单位: s(秒). 默认值: <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800080;">0</span>.<br style="margin: 0px; padding: 0px;">daemonize boolean<br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">设置FPM在后台运行. 设置 <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">no</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span> 将 FPM 保持在前台运行用于调试. 默认值: yes.<br style="margin: 0px; padding: 0px;">运行配置区段<br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">在FPM中，可以使用不同的设置来运行多个进程池。 这些设置可以针对每个进程池单独设置。<br style="margin: 0px; padding: 0px;">listen <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">string</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">设置接受FastCGI请求的地址. 可用格式为: <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">ip:port</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span>, <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">port</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span>, <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">/path/to/unix/socket</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span>. 每个进程池都需要设置.<br style="margin: 0px; padding: 0px;">listen.backlog <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">int</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">设置 listen(<span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800080;">2</span>) 的半连接队列长度. <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">-1</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span> 表示无限制. 默认值: -<span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800080;">1</span>.<br style="margin: 0px; padding: 0px;">listen.allowed_clients <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">string</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">设置允许连接到FastCGI的服务器IPV4地址. 等同于PHP FastCGI (<span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800080;">5.2</span>.<span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800080;">2</span>+)中的 FCGI_WEB_SERVER_ADDRS环境变量. 仅对TCP监听起作用. 每个地址是用逗号分隔. 如果没有设置或者为空，则允许任何服务器请求连接. 默认值: any.<br style="margin: 0px; padding: 0px;">listen.owner <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">string</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">如果使用，表示设置Unix套接字的权限. 在Linux中，读写权限必须设置，以便用于WEB服务器连接. 在很多BSD派生的系统中可以忽略权限允许自由连接. 默认值: 运行所使用的用户合租, 权限为0666.<br style="margin: 0px; padding: 0px;">listen.group <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">string</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">参见 listen.owner.<br style="margin: 0px; padding: 0px;">listen.mode <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">string</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">参见 listen.owner.<br style="margin: 0px; padding: 0px;">user <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">string</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">FPM 进程运行的Unix用户. 必须设置.<br style="margin: 0px; padding: 0px;">group <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">string</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">FPM 进程运行的Unix用户组. 如果没有设置，则默认用户的组被使用.<br style="margin: 0px; padding: 0px;">pm <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">string</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">设置进程管理器如何管理子进程. 可用值: <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">static</span>, dynamic. 必须设置.<br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;"><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">static</span> - 子进程的数量是固定的 (pm.max_children).<br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">dynamic - 子进程的数量在下面配置的基础上动态设置: pm.max_children, pm.start_servers, pm.min_spare_servers, pm.max_spare_servers.<br style="margin: 0px; padding: 0px;">pm.max_children <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">int</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">子进程的数量，pm 设置为 <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">static</span> 时表示创建的， pm 设置为 dynamic 时表示最大可创建的. 必须设置.<br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">该选项设置可以同时提供服务的请求数限制. 类似 Apache 的 mpm_prefork 中 MaxClients 的设置和 普通PHP FastCGI中的 PHP_FCGI_CHILDREN 环境变量.<br style="margin: 0px; padding: 0px;">pm.start_servers <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">in</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">设置启动时创建的子进程数目. 仅在 pm 设置为 dynamic 时使用. 默认值: min_spare_servers + (max_spare_servers - min_spare_servers) / <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800080;">2</span>.<br style="margin: 0px; padding: 0px;">pm.min_spare_servers <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">int</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">设置空闲服务进程的最低数目. 仅在 pm 设置为 dynamic 时使用. 必须设置.<br style="margin: 0px; padding: 0px;">pm.max_spare_servers <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">int</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">设置空闲服务进程的最大数目. 仅在 pm 设置为 dynamic 时使用. 必须设置.<br style="margin: 0px; padding: 0px;">pm.max_requests <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">int</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">设置每个子进程重生之前服务的请求数. 对于可能存在内存泄漏的第三方模块来说是非常有用的. 如果设置为 <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">0</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span> 则一直接受请求. 等同于 PHP_FCGI_MAX_REQUESTS 环境变量. 默认值: <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800080;">0</span>.<br style="margin: 0px; padding: 0px;">pm.status_path <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">string</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">FPM状态页面的网址. 如果没有设置, 则无法访问状态页面. 默认值: none.<br style="margin: 0px; padding: 0px;">ping.path <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">string</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">FPM监控页面的ping网址. 如果没有设置, 则无法访问ping页面. 该页面用于外部检测FPM是否存活并且可以响应请求. 请注意必须以斜线开头 (/).<br style="margin: 0px; padding: 0px;">ping.response <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">string</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">用于定义ping请求的返回相应. 返回为 HTTP <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800080;">200</span> 的 text/plain 格式文本. 默认值: pong.<br style="margin: 0px; padding: 0px;">request_terminate_timeout mixed<br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">设置单个请求的超时中止时间. 该选项可能会对php.ini设置中的<span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">max_execution_time</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span>因为某些特殊原因没有中止运行的脚本有用. 设置为 <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">0</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span> 表示 <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">Off</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span>. Available units: s(econds)(<span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">default</span>), m(inutes), h(ours), or d(ays). Default value: <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800080;">0</span>.<br style="margin: 0px; padding: 0px;">request_slowlog_timeout mixed<br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">当一个请求该设置的超时时间后，就会将对应的PHP调用堆栈信息完整写入到慢日志中. 设置为 <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">0</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span> 表示 <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">Off</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span>. 可用单位: s(秒)(默认), m(分), h(小时), 或者 d(天). 默认值: <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800080;">0</span>.<br style="margin: 0px; padding: 0px;">slowlog <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">string</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">慢请求的记录日志. 默认值: #INSTALL_PREFIX#/log/php-fpm.log.slow.<br style="margin: 0px; padding: 0px;">rlimit_files <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">int</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">设置文件打开描述符的rlimit限制. 默认值: 系统定义值.<br style="margin: 0px; padding: 0px;">rlimit_core <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">int</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">设置核心rlimit最大限制值. 可用值: <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">unlimited</span><span style="margin: 0px; padding: 0px; line-height: 1.5; color: #800000;">'</span> 、0或者正整数. 默认值: 系统定义值.<br style="margin: 0px; padding: 0px;">chroot <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">string</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">启动时的Chroot目录. 所定义的目录需要是绝对路径. 如果没有设置, 则chroot不被使用.<br style="margin: 0px; padding: 0px;">chdir <span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">string</span><br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">设置启动目录，启动时会自动Chdir到该目录. 所定义的目录需要是绝对路径. 默认值: 当前目录，或者/目录（chroot时）.<br style="margin: 0px; padding: 0px;">catch_workers_output boolean<br style="margin: 0px; padding: 0px;"><br style="margin: 0px; padding: 0px;">重定向运行过程中的stdout和stderr到主要的错误日志文件中. 如果没有设置, stdout 和 stderr 将会根据FastCGI的规则被重定向到 /dev/<span style="margin: 0px; padding: 0px; line-height: 1.5; color: #0000ff;">null</span> . 默认值: 空.
