Home >Backend Development >PHP Tutorial > php-fpm.conf 配备详解

php-fpm.conf 配备详解

WBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWB
WBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOriginal
2016-06-13 12:39:38847browse

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> . 默认值: 空.
Statement:
The content of this article is voluntarily contributed by netizens, and the copyright belongs to the original author. This site does not assume corresponding legal responsibility. If you find any content suspected of plagiarism or infringement, please contact admin@php.cn