zoukankan      html  css  js  c++  java
  • 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;

  • 相关阅读:
    hdu 3339 最短路+01背包
    hdu 3584 三维树状数组
    hdu 最短路径的特殊运用
    螺旋矩阵(NOIP2014 普及组第三题)
    子矩阵(NOIP2014 普及组第四题)
    金币(NOIP2015 普及组第一题)
    扫雷游戏(NOIP2015 普及组第二题)
    求和(NOIP2015 普及组第三题)
    推销员(NOIP2015 普及组第四题)
    魔法阵(NOIP2016 普及组第四题)
  • 原文地址:https://www.cnblogs.com/kaixn/p/13227853.html
Copyright © 2011-2022 走看看