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;
}
展开阅读全文

没有更多推荐了,返回首页

©️2019 CSDN 皮肤主题: 游动-白 设计师: 上身试试
应支付0元
点击重新获取
扫码支付

支付成功即可阅读