> For the complete documentation index, see [llms.txt](https://huataihuang.gitbook.io/cloud-atlas-draft/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://huataihuang.gitbook.io/cloud-atlas-draft/develop/php/nginx_php-fpm_configuration_optimizing_tips.md). # Nginx php-fpm配置优化Tips ## Nginx Tip 1: 组织Nginx配置文件 Nginx配置文件位于`/etc/nginx`目录，一种较好的组织方式是采用Debian/Ubuntu Apache风格设置： ``` ## Main configuration file ## /etc/nginx/nginx.conf ## Virtualhost configuration files on ## /etc/nginx/sites-available/ /etc/nginx/sites-enabled/ ## Other config files on (if needed) ## /etc/nginx/conf.d/ ``` 虚拟主机文件有2个目录，由于`site-available`目录可以包含任何内容，例如测试配置，以及复制和创建的配置，旧配置等。而`sites-enabled`目录则只包含实际激活的配置，并且只需要从`sites-available`目录建立以恶软链接到`sites-enabled`目录下就可以。 不过，记住要在`nginx.conf`配置文件最后包含以下两行 ``` ## Load virtual host conf files. ## include /etc/nginx/sites-enabled/*; ## Load another configs from conf.d/ ## include /etc/nginx/conf.d/*; ``` ## Nginx Tip 2: 设置Nginx `work_processes` 和 `worker_connections` 默认的`worker_processes`和`worker_connections`的设置够用，但是这值可以按照以下公式做一些优化： `max_clients = worker_processes * worker_connections` 默认的基础配置职能处理大约1000个连接 ``` worker_processes 1; worker_connections 1024; ``` 对于繁忙的网站上述配置会导致缓慢响应，因为Nginx被I/O操作锁住了。要避免锁情况发生，可以采用 `每个服务器处理器核心对应一个worker_process`的设置方式，类似： ``` worker_processes [number of processor cores]; ``` 要检查你的服务器CPU核心数量，可以采用 ``` cat /proc/cpuinfo | grep processor | wc -l ``` 例如，输出 `24` 则设置Nginx的`worker_processes`如下 ``` worker_processes 24; ``` `worker_connections`默认设置值`1024`通常可以满足要求（我感觉可能和应用有关，对于不同的web应用这个数值可以上下调整）。 ## Nginx Tip 3: 隐藏Nginx服务器Tokens/版本号 隐藏服务器tokens/版本号通常对于一些过期版本有好处，只需要在 `http/server/location`段落设置： ``` server_tokens off; ``` ## Nginx Tip 4: Nginx请求/上传最大Body size（`client_max_body_size`） 如果你希望允许用户通过HTTP上传文件，可能需要增加`post`的限制大小。这个设置是通过`client_max_body_size`在`http/server/location`段落设置。默认是`1Mb`，可以修改为`20Mb`并且增加相应的缓存大小： ``` client_max_body_size 20m; client_body_buffer_size 128k; ``` 如果在看到以下错误就表明`client_max_body_size`设置过小了：`Request Entity Too Large`(413) ## Nginx Tip 5: Nginx静态文件缓存控制（浏览器缓存控制指令） 浏览器缓存对于节约服务器资源和带宽非常重要。在Nginx中设置以下基本配置（logging关闭并且失效头部设置为360天）： ``` location ~* \.(jpg|jpeg|gif|png|css|js|ico|xml)$ { access_log off; log_not_found off; expires 360d; } ``` ## Nginx Tip 6: 传递PHP请求给`php-fpm` 这里可以设置默认的`tcp/ip`堆栈或者直接使用Unix socket连接。需要设置PHP-FPM监听在准确的相同`ip:port`或者unix socket（注意：socket的权限）。默认设置是使用`ip:port`（也就是`127.0.0.1:9000`）： ``` # Pass PHP scripts to PHP-FPM location ~* \.php$ { fastcgi_index index.php; fastcgi_pass 127.0.0.1:9000; #fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock; include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_param SCRIPT_NAME $fastcgi_script_name; } ``` 也可以将PHP-FPM和Nginx运行在不同的服务器上。 ## Nginx Tip 7: 保护（拒绝）访问Nginx的隐含文件 要注意服务器根目录或者其他公共目录下的隐含文件，也就是以`.`开头的不希望网站用户访问的文件。例如公共目录下包含的版本控制文件和目录，例如`.svn`以及一些IDE属性文件和`.htaccess`文件。使用以下配置拒绝所有隐藏文件等访问并关闭日志 ``` location ~ /\. { access_log off; log_not_found off; deny all; } ``` ## PHP-FPM Tip 1 - `php-fpm`配置文件 通常PHP-FPM配置文件位于`/etc/php-fpm.conf`和`/etc/php-fpm.d`目录下。比较好的方法是将所有pool配置都存放在`/etc/php-fpm.d`目录下。需要在`php-fpm.conf`配置中使用 ``` include=/etc/php-fpm.d/*.conf ``` ## PHP-FPM Tip 2 - PHP-FPM 全局配置微调 默认`emergency_restart_threshold`，`emergency_restart_interval` 和 `process_control_timeout` 都设置成关闭。不过，建议使用如下配置 ``` emergency_restart_threshold 10 emergency_restart_interval 1m process_control_timeout 10s ``` 上述配置表示如果10个PHP-FPM子进程以`SIGSEGV`或者`SIGBUS`信号方式在1分钟内连续退出，则PHP-FPM就会自动重启。这个设置也子进程在从master进程获得reaction信号的等待时间限制为10秒。 ## PHP-FPM Tip 3 - PHP-FPM pool配置 PHP-FPM可以针对不同网站使用不同的pool并且非常精确地分配资源，甚至对每个pool使用不同的用户和组身份。以下是针对3个不同站点的PHP-FPM pool的文件结构： ``` /etc/php-fpm.d/site.conf /etc/php-fpm.d/blog.conf /etc/php-fpm.d/forums.conf ``` 以及每个pool的案例配置 * `/etc/php-fpm.d/site.conf` ``` [site] listen = 127.0.0.1:9000 user = site group = site request_slowlog_timeout = 5s slowlog = /var/log/php-fpm/slowlog-site.log listen.allowed_clients = 127.0.0.1 pm = dynamic pm.max_children = 5 pm.start_servers = 3 pm.min_spare_servers = 2 pm.max_spare_servers = 4 pm.max_requests = 200 listen.backlog = -1 pm.status_path = /status request_terminate_timeout = 120s rlimit_files = 131072 rlimit_core = unlimited catch_workers_output = yes env[HOSTNAME] = $HOSTNAME env[TMP] = /tmp env[TMPDIR] = /tmp env[TEMP] = /tmp ``` * `/etc/php-fpm.d/blog.conf` ``` [blog] listen = 127.0.0.1:9001 user = blog group = blog request_slowlog_timeout = 5s slowlog = /var/log/php-fpm/slowlog-blog.log listen.allowed_clients = 127.0.0.1 pm = dynamic pm.max_children = 4 pm.start_servers = 2 pm.min_spare_servers = 1 pm.max_spare_servers = 3 pm.max_requests = 200 listen.backlog = -1 pm.status_path = /status request_terminate_timeout = 120s rlimit_files = 131072 rlimit_core = unlimited catch_workers_output = yes env[HOSTNAME] = $HOSTNAME env[TMP] = /tmp env[TMPDIR] = /tmp env[TEMP] = /tmp ``` * `/etc/php-fpm.d/forums.conf` ``` [forums] listen = 127.0.0.1:9002 user = forums group = forums request_slowlog_timeout = 5s slowlog = /var/log/php-fpm/slowlog-forums.log listen.allowed_clients = 127.0.0.1 pm = dynamic pm.max_children = 10 pm.start_servers = 3 pm.min_spare_servers = 2 pm.max_spare_servers = 4 pm.max_requests = 400 listen.backlog = -1 pm.status_path = /status request_terminate_timeout = 120s rlimit_files = 131072 rlimit_core = unlimited catch_workers_output = yes env[HOSTNAME] = $HOSTNAME env[TMP] = /tmp env[TMPDIR] = /tmp env[TEMP] = /tmp ``` ## PHP-FPM Tip 4 - PHP-FPM Pool 进程管理器(pm)配置 使用PHP-FPM进程管理等最佳方式是使用动态进程管理，这样PHP-FPM进程就只会在需要的时候启动。这个设置类似Nginx `worker_processes` 和 `worker_connections`设置。每个进程都会消耗内存，所以如果网站非常繁忙并且服务器有充足内存则可以设置较大值，如果用于内存缺乏的VPS则针对每秒少量请求，设置较小的值。 建议先测试服务器能够处理多少PHP-FPM进程：首先启动Nginx和PHP-FPM并加载一些PHP页面，特别是一些大型页面。然后检查每个PHP-FPM进程消耗掉内存量，可以使用`top`或`htop`。假设服务器准备预留220Mb内存运行PHP-FPM，而每个进程大约消耗24Mb内存（一些使用插件的大型内容管理系统的每个页面请求会轻易消耗20-40Mb），则简单的计算`max_children`值就是：`220/24 = 9.17`。 此时`pm.max_children`建议设置为`9`，案例可以参考下面的配置 ``` pm.max_children = 9 pm.start_servers = 3 pm.min_spare_servers = 2 pm.max_spare_servers = 4 pm.max_requests = 200 ``` 默认的每个进程可以处理的最大请求是没有限制的，不过最好设置一个较低的值，例如`200`以避免一些内存问题。 ## 参考 * [Nginx and PHP-FPM Configuration and Optimizing Tips and Tricks](https://www.if-not-true-then-false.com/2011/nginx-and-php-fpm-configuration-and-optimizing-tips-and-tricks/) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://huataihuang.gitbook.io/cloud-atlas-draft/develop/php/nginx_php-fpm_configuration_optimizing_tips.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.