2.2.2 配置项的语法格式

从上文的示例可以看出,最基本的配置项语法格式如下:


配置项名 配置项值 1 配置项值 2……;


下面解释一下配置项的构成部分。

首先,在行首的是配置项名,这些配置项名必须是Nginx的某一个模块想要处理的,否则Nginx会认为配置文件出现了非法的配置项名。配置项名输入结束后,将以空格作为分隔符。

其次是配置项值,它可以是数字或字符串(当然也包括正则表达式)。针对一个配置项,既可以只有一个值,也可以包含多个值,配置项值之间仍然由空格符来分隔。当然,一个配置项对应的值究竟有多少个,取决于解析这个配置项的模块。我们必须根据某个Nginx模块对一个配置项的约定来更改配置项,第4章将会介绍模块是如何约定一个配置项的格式。

最后,每行配置的结尾需要加上分号。

注意 如果配置项值中包括语法符号,比如空格符,那么需要使用单引号或双引号括住配置项值,否则Nginx会报语法错误。例如:


log_format main'$remote_addr-$remote_user[$time_local]"$request"';