Nginx(语法):05---Nginx配置文件语法

配置文件由“配置块”和“配置项”组成。格式如下:
<section> {
<directive> <parameters>;
<section> {
<directive> <parameters>;
...
}
...
}
一、配置块

配置块也称为“节”或“部分”
配置块由一个块配置项名和一对大括号组成。例如:
events {

}
配置块是可以嵌套的,内层块直接继承外层块。当内外层块中的配置发生冲突时,究竟是以内层块还是外层块的配置为准,取决于解析这个配置项的模块。例如下面的案例中,server块里的任意配置都是基于http块里的已有配置的
http {
upstream backend {
server 127.0.0.1:8080;
}
gzip on;
server {
location /webstatic {
gzip off;
}
}
}
二、配置项

配置项是最基本的配置单位
格式如下:
首先,在行首的是配置项名,这些配置项名必须是Nginx的某一个模块想要处理的,否则Nginx会认为配置文件出现了非法的配置项名。配置项名输入结束后,将以空格作为分隔符
其次是配置项值,它可以是数字或字符串(当然也包括正则表达式)。针对一个配置 项,既可以只有一个值,也可以包含多个值,配置项值之间仍然由空格符来分隔。当然,一 个配置项对应的值究竟有多少个,取决于解析这个配置项的模块
最后,每行配置的结尾需要加上分号
配置项名 配置项值1 配置项值2 ... ;
注意:如果配置项值中包括语法符号,比如空格符,那么需要使用单引号或双引号括住配置项值,否则Nginx会报语法错误。例如:
log_format main '$remote_addr - $remote_user [$time_local] "$request" ';
配置项的注释

如果有一个配置项暂时需要注释掉,那么可以加“#”注释掉这一行配置
例如:
#pid logs/nginx.pid;
配置项的单位

大部分模块遵循一些通用的规定,如指定空间大小时不用每次都定义到字节、指定时间 时不用精确到毫秒
当指定空间大小时,可以使用的单位包括:
K或者k千字节(KiloByte,KB)、M或者m兆字节(MegaByte,MB)
例如:
gzip_buffers 4 8k;
client_max_body_size 64M;
当指定时间时,可以使用的单位包括:
ms(毫秒)、s(秒)、m(分钟)、h(小时)、d(天)、w(周,包含7天)、M(月,包含30天)、y(年,包含365天)
例如:
expires 10y;
proxy_read_timeout 600;
client_body_timeout 2m;
注意:配置项后的值究竟是否可以使用这些单位,取决于解析该配置项的模块。如 果这个模块使用了Nginx框架提供的相应解析配置项方法,那么配置项值才可以携带单位
三、在配置中使用变量

有些模块允许在配置项中使用变量,如在日志记录部分
例如:remote_addr是一个变量,使用它的时候前面要加上$符号。需要注意的是,这种变量只有少数模块支持,并不是通用的
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';
许多模块在解析请求时都会提供多个变量(如http core module、http proxy module、http upstream module等),以使其他模块的配置可以即时使用。我们在学习某 个模块提供的配置说明时可以关注它是否提供变量
四、内嵌其他配置文件(include关键字)

include可以在一个配置文件中用来包含另一个配置文件
语法格式:
include 配置文件名;
使用注意事项:
include文件也要遵循Nginx配置文件的语法
如果路径中出现通配符,表示可以配置多个文件
如果在本配置文件中与include的配置文件中出现相同的配置,那么以最后一次定义的为标准,后面的会覆盖前面的
例如下面是几个演示案例:
include /opt/local/etc/nginx/mime.types;
include /opt/local/etc/nginx/vhost/*.conf;
如果你想在运行nginx前测试一下配置文件语法是否有错误,可以使用nginx的-t参数。例如:
/usr/local/nginx/sbin/nginx -t demo.conf
五、提示

在执行configure命令时,我们已经把许多模块编译进Nginx中,但是否启用这些模块,一般取决于配置文件中相应的配置项。换句话说,每个Nginx模块都有自己感兴趣 的配置项,大部分模块都必须在nginx.conf中读取某个配置项后才会在运行时启用。例如,只 有当配置http{...}这个配置项时,ngx_http_module模块才会在Nginx中启用,其他依赖 ngx_http_module的模块也才能正常使用
六、配置演示案例

例如,下面是一个简单的配置文件
user nobody;

worker_processes 8;
error_log varlog/nginx/error.log error;

#pid logs/nginx.pid;

events {
use epoll;
worker_connections 50000;
}

http {
include mime.types;
default_type application/octet-stream;

log_format main '$remote_addr [$time_local] "$request" '
'$status $bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';

access_log logs/access.log main buffer=32k;

原文地址:https://www.cnblogs.com/kaixn/p/13227853.html