php+php-fom+nginx配置参数调优详解

拼搏现实的明天。 2024-04-19 11:36 7阅读 0赞

### 文章目录 ###

*   *  一、前言
     *   *  1、mysql配置参数：
         *  2、注意
     *  二、php参数配置及讲解
     *   *  1、phpini的基本设置
         *  2、php参数设置
     *  三、php-fpm设置
     *   *  1、设置子进程数，增加并发量
         *  2、防止频繁出现502错误
         *  3、php-fpm中的慢日志设置
         *   *  （1）慢日志的主要参数
             *  （2）利用sort/uniq命令分析汇总php-fpm慢日志：
         *  4、php-fpm中的backlog是干啥的？
     *  四、nginx配置参数调优
     *   *  1、nginx中的一些层级关系
         *  2、nginx.conf 实例及解释
         *  3、对于conf.d文件夹中的配置
         *  4、保存编辑之后检查配置文件的正确性
         *   *  （1）检查配置文件是否正确
             *  （2）检查子级配置文件是否正确
             *  （3）======= 2019/9/20问题修正========
     *  五、影响程序超时的参数
     *   *  1、关于php和php-fpm超时时间的设置
         *  2、nginx中的超时设置
         *  3、nginx中的keepalive\_timeout
         *  4、总结

## 一、前言 ##

对于一台新的服务器，安装`LNMP`环境只是第一步，第二步当然是要修改默认的配置参数，让这些程序变得好用，性能也提升起来。这篇文章主要讲述`php+php-fpm+nginx`的配置参数，机器是`4GB`内存的服务器，相关配置都是按照`4GB`内存的服务器来配置的。

### 1、mysql配置参数： ###

[mysql配置参数调优(8GB内存和64GB内存)][mysql_8GB_64GB]  
[mysql配置文件构成以及具体的配置demo][mysql_demo]

### 2、注意 ###

下面给出的一些配置都是相对来说会影响性能或者必须要配置的地方，没有提及的配置都是按照默认的来。这三个程序的配置参数很多，咱们的服务器刚开始也着实用不到太复杂的配置，下面的配置主要是为了尽量提升高并发能力以及尽量提高程序的性能。

**php和php-fpm都是5.6版本的。(一切都是为了兼容老项目，，苦逼)**

## 二、php参数配置及讲解 ##

### 1、phpini的基本设置 ###

（1）safe_mode  这份的配置采用默认的
    （2）disable_functions  在默认的基础上，加上eval()函数
    （3）expose_php = off
    （4）register_globals和magic_quotes_gpc参数都在php5.4.0后被移除了
    （5）错误提示以及日志部分采用默认的就行，现在大部分使用的都是框架，
    查看框架的错误日志更方便

这几个参数是网上经常提及的，不过咱们这边并不是都要按照他们的配置来，毕竟年代已久，很多`bug`或者性能问题都已经被修复。

### 2、php参数设置 ###

**（1）max\_execution\_time = 300**

脚本运行的最长时间，超出规定时间，脚本会自动杀死这个请求，为了能上传大文件，所以这个值设置的大一些。这个值太小也会造成程序502错误。

**（2）memory\_limit = 128M**

每个脚本使用的最大内存

**（3）max\_inpit\_time = 300**

每个脚本等待输入数据的最长时间

**（4）upload\_max\_filesize = 20M**

上传文件的最大许可大小

**（5）allow\_url\_fopen = off**

禁止打开远程地址

**（6）post\_max\_size = 20M**  
      `post`上传的大小，要`>=upload_max_filesize`

**（7）;cgi.fix\_pathinfo=1**  
      默认打开，目前高版本的`php`已经避免了这个漏洞，`php-fpm`的`security.limit_extensions` 默认值早就是 `.php`了。所以咱们这个参数使用默认的就行。  
参考：[php fpm 设置项 cgi.fix\_pathinfo=1 漏洞不再出现][php fpm _ cgi.fix_pathinfo_1]

关于`php.ini`，要设置的参数就是这些了，主要是增加程序的运行时间，增加上传文件大小等，可以方便我们平时的`php`开发。

## 三、php-fpm设置 ##

### 1、设置子进程数，增加并发量 ###

log_level = notice		//notice级别的日志，默认的
    rlimit_files = 4048		//调整最大打开文件数量
    pm选用动态变化的dynamic
    
    process.max = 150		// 最大子进程，设置成和max_children一样就行
    pm = dynamic
    pm.max_children = 150	//最大子进程，假如一个进程30M，4G内存的话最大为：4048/30 = 135，取150
    pm.start_servers = 20
    pm.min_spare_servers = 6
    pm.max_spare_serveres = 30   
    //计算公式是：min_spare_servers ≤ start_servers ≤ max_spare_servers ≤ max_children

这块很多人都建议，如果你的内存比较大，那么设置静态的`pm = static`，这个时候，起作用的只有`max_children`参数，初始的时候就有`max_children`个进程，刚开始一个`php-fpm`进程只占用`3M`左右内存，我们`4GB`的机器按照一个进程`20M`计算，可以设置`max_children` 为`200`或者`150`。如果是专门的`php`服务器，建议是设置为静态的，性能最佳。

如果设置成动态的也可以，这样的话是`start_servers`等程序起作用，会随着业务的增加而不断新增进程，不过最大进程数是不能超过`max_children`的。博主这边考虑到机器内存小而且机器上还跑了`mysql`，`redis`等，还是选用了动态的，这样一开始不会有很大的压力，等访问量上来了，可能会修改为静态的。

### 2、防止频繁出现502错误 ###

**（1）process\_control\_timeout = 20**

`php-fpm`给子进程分配的时间间隔

**（2）request\_terminate\_timeout = 320s**

表示等待`320`秒后，结束那些没有自动结束的`php`脚本，以释放占用的资源。设置`320s`主要是因为`php`的程序运行时间是`300s`，所以对于`php-fpm`来说，这个值应该是大于`php`脚本规定的运行时间的（因为`php`脚本的运行可能还会带有`mysql`服务或者其他的一些服务，这个参数是杀掉这个进程，包括着纯`php`脚本以及其他服务）。

**（3）自动重启设置**

#表示在emergency_restart_interval所设值内出现SIGSEGV或者SIGBUS错误的php-cgi进程数如果
    #超过emergency_restart_threshold个php-fpm就会优雅重启。这两个选项一般保持默认值
    
    emergency_restart_threshold = 30
    emergency_restart_interval = 60s	//一分钟内出现30次上述信号即重启php-fpm

**（4）pm.max\_requests = 1000**

每一个子进程的最大请求服务数量，如果超过了这个值，该子进程会被自动重启。

比如`max_requests`这个参数，如果设置很大的话，那这个子进程要运行很多次才会重启，假如这个请求发生了错误或者内存泄漏，那么这个值设置很大是不合适的。但如果请求没有问题，这个值设置小的话就会频繁的重启，这样也会碰到不少`502`的问题，所以要仁者见仁，智者见智的设置了，这里初始化设置`1000`，如果测试没有内存泄漏等问题，可以再大一些。

### 3、php-fpm中的慢日志设置 ###

`mysql`中有慢日志这个概念，可以记录查询速度比较慢的`sql`，同样的，`php-fpm`也可以开启慢日志，记录执行速度比较慢的`php`请求，方便我们后续的调试和优化。

#### （1）慢日志的主要参数 ####

**request\_slowlog\_timeout ：** 默认是注释的，打开注释，设置为1，代表请求超过1s，就会记录这个脚本到慢日志文件中。也可以的更大，按照需求来。  
**slowlog ：** 默认也是注释的，可以打开注释使用默认的慢日志路径，也可以自定义路径。

这里开启慢日志，如下：

request_slowlog_timeout = 2   # 记录超过2s的请求
    slowlog = /var/log/php-fpm/www-slow.log	#慢日志路径

#### （2）利用sort/uniq命令分析汇总php-fpm慢日志： ####

**参数解释：**

sort: 对单词进行排序
    uniq -c: 显示唯一的行，并在每行行首加上本行在文件中出现的次数
    sort -k1,1nr: 按照第一个字段，数值排序，且为逆序
    head -10: 取前10行数据

### 4、php-fpm中的backlog是干啥的？ ###

如果`worker`进程不够用，`master`进程会`prefork`更多进程，如果`prefork`达到了`pm.max_children`上限，`worker`进程又全都繁忙，这时`master`进程会把请求挂起到连接队列`backlog`里，而`backlog`默认值是`511`，除了加大`pm.max_children`，调整`backlog`也是有必要的。

也就说这个`backlog`是在优化高并发的时候必须要设置的，这个值的大小和`fpm`的`qps`也有关。`backlog`太大，`fpm`处理不过来照样会报错`504`（超时）。这个对于目前的机器来说，我设置的`max_children = 150`，然而`backlog`的默认值是`511`，所以在短期内是完全够用的，不过也可以在`php-fpm.conf`里面显式的制定`backlog`的值，比如制定：`listen.backlog = 1024 #2的n次幂`

**参考:**

[PHP参数调优][PHP]  
[nginx报错502：connect() to unix:/var/run/php5-fpm.sock failed (2: No such file or directory)][nginx_502_connect_ to unix_var_run_php5-fpm.sock failed _2_ No such file or directory]  
[php-fpm进程数管理][php-fpm]  
[关于PHP-FPM的backlog的默认值][PHP-FPM_backlog]  
[PHP-FPM中backlog参数变更的一些思考][PHP-FPM_backlog 1]  
[PHP-fpm][]

## 四、nginx配置参数调优 ##

### 1、nginx中的一些层级关系 ###

一般打开`nginx`配置文件，会发现有`http`，`server`,`location`等，那么他们的层级关系是什么样的呢？

**答案是：** 一个`http`里面可以有多个`server`，一个`server`里面可以有多个`location`。

我们配置的时候，各个`server`共用的部分可以配置在`http`模块里面。每个`server`自己特有的一些部分，按照各自的需求配置在`server`模块里面。同样的，对于`location`是分的更细的，按照每个`server`的每个`location`需求来配置。

其次是如果在`conf.d`文件夹下有其他的配置文件，那么我们的`nginx.conf`就是公用的配置文件了，一些公用的部分都可以配置在`nginx.conf文件`中，各个站点特殊的配置就放在`conf.d`文件下。

**参考：**  
[nginx短篇(4)：模块、配置指令、块之间的关系][nginx_4]

### 2、nginx.conf 实例及解释 ###

user www-data;
    worker_processes auto; #自动检测CPU的核数
    worker_rlimit_nofile 65535;  #worker进程的最大打开文件数限制
    error_log   /var/log/nginx/error.log;
    include /etc/nginx/modules-enabled/*.conf;
    pid /run/nginx.pid;
    
    events {
        worker_connections  10240;  #子进程最大连接数，总连接数：worker_processes * worker_connections
        use epoll; #使用epoll模型
    }
    
    http {
        include       mime.types; # #文件扩展名与文件类型映射表
        default_type  application/octet-stream;  #这个类型会让浏览器认为响应是普通的文件流，并提示用户下载文件
    
            #记录都有哪些变量可以记录到log_format
            log_format  main  '$remote_addr $host $remote_user [$time_local] "$request" '
                          '$status $body_bytes_sent "$http_referer" '
                          '"$http_user_agent" "$http_accept_language" "$request_time" '
                          '"$upstream_response_time" "$upstream_addr" "$upstream_status" "$http_x_real_ip" "$proxy_add_x_forwarded_for"';
    
        sendfile        on;  #立即将数据从磁盘读到OS缓存
        tcp_nopush      on;  #告诉nginx在一个数据包里发送所有头文件
        tcp_nodelay     on;  # 告诉nginx不要缓存数据，而是一段一段的发送
        keepalive_timeout  30; #服务器将在这个超时时间过后关闭链接
        types_hash_max_size 2014;
    
        #resolver xxx;  #用于解析上游服务器名称的名称服务器配置到地址中
        gzip_static on;
        gzip  on;
        gzip_http_version 1.1;
        gzip_vary off;
        gzip_comp_level 4;  #数据的压缩等级，9是最慢但是压缩比最大的
        gzip_proxied off;
        gzip_buffers 16 8k;
        gzip_disable "MSIE [1-6]\.(?!.*SV1)";
        #设置需要压缩的数据格式
        gzip_types text/plain text/css application/json application/x-javascript text/xml application/xml application/xml+rss text/javascript application/hero-res;
    
        client_max_body_size 20m;  #设置网页上传文件的最大值，和php.ini中的上传设置保持一致
        server_names_hash_max_size 2048;  #保存服务器名字的hash表
    
        include /etc/nginx/client.conf;
        include /etc/nginx/conf.d/*.conf;
    }

**（1）worker\_rlimit\_nofile**

更改worker进程的最大打开文件数限制。

查看当前进程可以打开的文件数：

ulimit-n			
    //结果：65535

查看当前系统可以打开的最大文件数：

ljf@hx:cat /proc/sys/fs/file-max
    813544

**(2)log\_format中的内容**

参考官网：https://nginx.org/en/docs/http/ngx\_http\_core\_module.html\#var\_status

remote_addr：对应客户端的地址
    remote_user：是请求客户端请求认证的用户名，如果没有开启认证模块的话是值为空。
    time_local：表示nginx服务器时间
    request：表示request请求头的行
    status：表示response的返回状态
    body_bytes_sent：表示从服务端返回给客户端的body数据大小
    http_referer：表示请求的上一级页面
    http_user_agent：表示agent信息
    http_x_forwarded_for：会记录每一级请求中信息

**（3）gzip压缩相关解释**

参考：https://www.jb51.net/article/95041.htm

**（4）client\_max\_body\_size设置**

这个参数规定客户端上传的`body`的最大值,和`php.ini`中的最大上传数保持一致，不然的话，就算`php.ini`设置上传的最大文件是`1G`，如果`nginx`  
不设置这个参数的话，那么上传一样会报错的。

### 3、对于conf.d文件夹中的配置 ###

**（1）配置实例代码**

server{
          listen IP:80;
        server_name xxx;
        access_log  /var/log/nginx/access.log;  #access日志
    
        fastcgi_intercept_errors on; #支持nginx404重定向
    
        index index.php index.html  index.htm;
    
        root /product/ucool/production/manage/htdocs/backend/web/;
    
            send_timeout 15;
            #客户端与服务器建立连接后发送request body的超时时间(小于keepalive_timeout)
            client_body_timeout 20;
            #客户端向服务器发送一个完整的request header的超时时间(小于keepalive_timeout)
            client_header_timeout 20;
            fastcgi_connect_timeout         300;    #指定连接到后端FastCGI的超时时间
            fastcgi_send_timeout            300;    #指定向FastCGI传送请求的超时时间
            fastcgi_read_timeout            300;    #指定接收FastCGI应答的超时时间
            fastcgi_buffer_size 64k;               #指定读取FastCGI应答第一部分需要用多大的缓冲区
            fastcgi_buffers 4 64k;                 #定本地需要用多少和多大的缓冲区来缓冲FastCGI的应答请求
    
    
          location ~* ^.+\.(git|svn|sql|bak|old|rar|tgz|7z|bz2|tar|idea)$ {
            return 404;
          }
          location ~ \.php$ {
                    fastcgi_pass unix:/var/run/php/php5.6-fpm.sock;
                    fastcgi_index index.php;
                    fastcgi_param SCRIPT_FILENAME $document_root/$fastcgi_script_name;
                    include fastcgi_params;
                    proxy_set_header Host $host;
                    proxy_set_header X-Real-IP $remote_addr;
                    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
          }
            location ~ /\.git { deny all; }
    }

**（2）主要是fastcgi的一些配置**

这里不考虑负载均衡和反向代理，关于`fastcgi`的优化可以参考：

https://www.jb51.net/article/145222.htm

**（3）关于send\_timeout**

send_timeout 15;
        #客户端与服务器建立连接后发送request body的超时时间(小于keepalive_timeout)
        client_body_timeout 20;
        #客户端向服务器发送一个完整的request header的超时时间(小于keepalive_timeout)
        client_header_timeout 20;

这几个参数最好是再小一些，包括`keepalive_timeout`，小一些的话，能处理更多的有效请求，有利于提升`nginx`的处理性能，大佬们的设置如下：

client_body_timeout 12;
    client_header_timeout 12;
    keepalive_timeout 15;
    send_timeout 10;

### 4、保存编辑之后检查配置文件的正确性 ###

#### （1）检查配置文件是否正确 ####

ljf@hx:/etc/nginx$ sudo nginx -t
    nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
    nginx: configuration file /etc/nginx/nginx.conf test is successful

返回`successful`并且没有报错信息的话，说明配置文件里面的语法是没问题的，如果报错了那就是语法出错了，导致配置无法正常读取。

#### （2）检查子级配置文件是否正确 ####

nginx -t -c /etc/nginx/conf.d/xxx.conf

例如：

ljf@hx:/etc/nginx$ sudo nginx -t -c /etc/nginx/conf.d/api.conf
    nginx: [emerg] "server" directive is not allowed here in /etc/nginx/conf.d/api.conf:1
    nginx: configuration file /etc/nginx/conf.d/api.conf test failed

很明显配置文件是错的。

#### （3）======= 2019/9/20问题修正======== ####

nginx -t -c /etc/nginx/conf.d/xxx.conf

这种检验子配置的方式，一直都会报错：

ljf@hx:$ sudo nginx -t -c /etc/nginx/conf.d/api.conf
    nginx: [emerg] "server" directive is not allowed here in /etc/nginx/conf.d/api.conf:1
    nginx: configuration file /etc/nginx/conf.d/api.conf test failed

**就是这个错误，让博主一直以为自己的配置是写错的，但是现在放上域名之后，是可以正常访问的，所以这个配置主要是检验`nginx.conf`的，子配置的话，因为只有一个`server{}` ,所以报错也情有可原。。抱歉各位，这里更正一下。**

## 五、影响程序超时的参数 ##

php.ini中有max_execution_time 参数。
    php-fpm中有request_terminate_timeout参数
    nginx.conf中有 fastcgi_connect_timeout 等参数。

### 1、关于php和php-fpm超时时间的设置 ###

首先是`max_execution_time` 这个值限定了脚本的最大执行时间，但是仅限于`php`脚本，对于脚本中的流操作和数据库操作等耗费的时间是不算进去的。而`php-fpm`的`request_terminate_timeout` 代表单个请求的超时中止时间，并不会受其他脚本影响，定义`10s`结束，那么`10s`就准时结束该`php`脚本的运行。所以配置超时时间的时候，`request_terminate_timeout` 可以比`max_execution_time` 稍微大一些。

还有一种说法，在服务器正常运行的时候，`php-fpm.conf`中的`request_terminate_timeout` 会覆盖`php.ini`中的`max_execution_time`，所以`request_terminate_timeout` 的值更代表我们对于脚本执行时间的预期。如果服务器性能足够好，可以设置`request_terminate_timeout = 0`代表永不超时。

当程序运行时间大于规定的参数的时候，`php-fpm`会终止该`php`子进程。

### 2、nginx中的超时设置 ###

`nginx`的`fastcgi_connect_timeout` 操作影响的是`ningx`的超时，一般来说，如果是`php`或者`php-fpm`超时，那么报错`502 Bad Gateway（网关错误）` 。如果是`nginx`超时的话，报错是：`504 Gateway Time-out （网关超时）` ，到时候我们可以根据这个报错信息来定位问题。一般来说，为防止频繁的出现超时错误，设置`fastcgi_connect_timeout` 相关时间为`300s`是合适的。

假如设置`fastcgi_read_timeout=10`，`test.php`执行时间`100`秒，则`10`秒后`webserver`会关闭和`PHP`的连接。也就是说当程序运行时间大于规定的参数的时候，`webserver`会关闭和`PHP`的连接，出现超时错误。所以这个`fastcgi`的超时时间最好是和`php-fpm`中的`request_terminate_timeout` 保持一致。

### 3、nginx中的keepalive\_timeout ###

`keepalive_timeout`参数是一个请求完成之后还要保持连接多久，不是请求时间多久，目的是保持长连接，减少创建连接过程给系统带来的性能损耗，类似于线程池，数据库连接池。

### 4、总结 ###

对于程序超时时间来说，并不能单纯的设置`php`或者设置`php-fpm`就能完全解决这个问题。因为它们是协调工作的，所以设置这几个参数的时候是要相互考虑的，防止因为木桶原理，最低的那个板子影响系统的性能。

以上就是对于`php+php-fpm+nginx`的参数调优，这些配置在我本地都是设置过的，并没有什么问题，修改的值也是尽可能的发挥咱们服务器的性能。实际的效果还要放到生产环境来检验，不过肯定是比默认的配置性能好滴。

**后续我也会不断根据生产环境的反馈来更新这些参数，如果各位大佬有好意见或者不同的看法，欢迎沟通交流~**

**end**

[mysql_8GB_64GB]: https://blog.csdn.net/LJFPHP/article/details/100751502
[mysql_demo]: https://blog.csdn.net/LJFPHP/article/details/100838927
[php fpm _ cgi.fix_pathinfo_1]: https://blog.csdn.net/sun_cainiao/article/details/79601904
[PHP]: https://blog.51cto.com/11233559/2124007
[nginx_502_connect_ to unix_var_run_php5-fpm.sock failed _2_ No such file or directory]: https://blog.csdn.net/LJFPHP/article/details/79892710
[php-fpm]: https://blog.csdn.net/qq_15766181/article/details/89928260
[PHP-FPM_backlog]: https://shipengliang.com/software-exp/%E5%85%B3%E4%BA%8Ephp-fpm%E7%9A%84backlog%E7%9A%84%E9%BB%98%E8%AE%A4%E5%80%BC.html
[PHP-FPM_backlog 1]: http://i.iivey.com/thread-909-1-1.html
[PHP-fpm]: https://www.kancloud.cn/digest/php-src/136260
[nginx_4]: http://www.zsythink.net/archives/3155