nginx - 全局变量和指令
nginx - 全局变量和指令
全局变量
下面是可以用作if判断的全局变量
$args ： 这个变量等于请求行中的参数，同$query_string
$content_length ： 请求头中的Content-length字段。
$content_type ： 请求头中的Content-Type字段。
$document_root ： 当前请求在root指令中指定的值。
$host ： 请求主机头字段，否则为服务器名称。
$http_user_agent ： 客户端agent信息
$http_cookie ： 客户端cookie信息
$limit_rate ： 这个变量可以限制连接速率。
$request_method ： 客户端请求的动作，通常为GET或POST。
$remote_addr ： 客户端的IP地址。
$remote_port ： 客户端的端口。
$remote_user ： 已经经过Auth Basic Module验证的用户名。
$request_filename ： 当前请求的文件路径，由root或alias指令与URI请求生成。
$scheme ： HTTP方法（如http，https）。
$server_protocol ： 请求使用的协议，通常是HTTP/1.0或HTTP/1.1。
$server_addr ： 服务器地址，在完成一次系统调用后可以确定这个值。
$server_name ： 服务器名称。
$server_port ： 请求到达服务器的端口号。
$request_uri ： 包含请求参数的原始URI，不包含主机名，如：”/foo/bar.php?arg=baz”。
$uri ： 不带请求参数的当前URI，$uri不包含主机名，如”/foo/bar.html”。
$document_uri ： 与$uri相同。
$host_host变量，和$host区别如下：
$host不带端口，$http_host带端口
$host：localhost
$server_port：88
$request_uri：http://localhost:88/test1/test2/test.php
$document_uri：/test1/test2/test.php
$document_root：/var/www/html
$request_filename：/var/www/html/test1/test2/test.php
if判断指令
语法为if(condition){...}，对给定的条件condition进行判断。如果为真，大括号内的rewrite指令将被执行，if条件(conditon)可以是如下任何内容：
- 当表达式只是一个变量时，如果值为空或任何以0开头的字符串都会当做false
- 直接比较变量和内容时，使用
=或!= ~正则表达式匹配，~*不区分大小写的匹配，!~区分大小写的不匹配
注意：使用正则表达式字符串一般不需要加引号，但是如果含有右花括号“}”或者分号“；”字符时，必须要给整个正则表达式加引号
其他指令：
-f和!-f用来判断是否存在文件
-d和!-d用来判断是否存在目录
-e和!-e用来判断是否存在文件或目录
-x和!-x用来判断文件是否可执行
break指令
用于中断当前相同作用域中的Nginx配置，和Java中的break语法类似，可以在server块和location以及if块中使用。
语法：break;
return指令
该指令用于完成对请求的处理，直接向客户端响应状态的代码。和Java中的return语法类似。可以再server块和location以及if块中使用。
语法：return code URL; #code表示状态码，URL表示返回给客户单的URL地址
或者：return URL: #当状态码是302或者307的时候，可以使用，返回的URL必须包含“http://”、“https://”或者直接使用“$scheme”变量(RequestScheme代表传输协议，
Nginx内置变量)
或者 return [text]; #为返回给客户端的响应体内容，支持变量的使用
rewrite指令
该指令通过正则表达式的使用来改变URI.可以同时存在一个或者多个指令，按照顺序一次对URL进行匹配和处理。该指令可以在server块后者location块中配置
语法：
指令语法：rewrite regex replacement [flag];
rewrite：是实现URL重定向的重要指令，
regex：用来匹配URI的正则表达式；
replacement：匹配成功后用来替换URI中被截取内容的字符串，默认情况如果该字符串包含“http://”、"https://"开头，则不会继续向下对URI进行其他处理。直接返回重写的URI给客户端
flag：用来设置rewrite对URI的处理行为,包含如下数据：
传参
rewrite ^/test.php /new permanent; //重写向带参数的地址
rewrite ^/test.php /new? permanent; //重定向后不带参数
rewrite ^/test.php /new?id=$arg_id? permanent; //重定向后带指定的参数
rewrite_log指令
该指令用于是否开启URL重写日志的输出，
语法：
rewrite_log on | off
默认是off，如果配置为on，URL重写的相关日志将以notice级别输出到error_log指令配置的日志文件中
set指令
用来设置新的变量，
语法: set variable value;
variable,这个是变量的名称，这个符号的“$”必须作为变量第一个字符，并且不能和Nginx服务器预设的全局变量同名
value,为变量的值。
比如 set $id “3”; #设置id为3
uninitialized_variable_warn指令
这个指令用来配置会用未初始化的变量时，是否记录警告日志，
语法： unitialized_variable_warn on | off
默认设置时on状态
防盗链
语法：
valid_referers none | blocked | server_name | string ...;
这里表示请求头部Referer域是否匹配上面值，如果匹配了$invalid_referer 的值为0，没有相匹配就是1；
example:
if (-f $request_filename){
… #判断请求的文件是否存在，存在就执行这里面的代码块
}
if ($http_user_agent ~ MSIE) {
rewrite ^(.*)$ /msie/$1 break;
} //如果UA包含"MSIE"，rewrite请求到/msid/目录下
if ($http_cookie ~* "id=([^;]+)(?:;|$)") {
set $id $1;
} //如果cookie匹配正则，设置变量$id等于正则引用部分
if ($request_method = POST) {
return 405;
} //如果提交方法为POST，则返回状态405（Method not allowed）。return不能返回301,302
if ($slow) {
limit_rate 10k;
} //限速，$slow可以通过 set 指令设置
if (!-f $request_filename){
break;
proxy_pass http://127.0.0.1;
} //如果请求的文件名不存在，则反向代理到localhost 。这里的break也是停止rewrite检查
if ($args ~ post=140){
rewrite ^ http://example.com/ permanent;
} //如果query string中包含"post=140"，永久重定向到example.com
location ~* \.(gif|jpg|png|swf|flv)$ {
valid_referers none blocked www.jefflei.com www.leizhenfang.com;
if ($invalid_referer) {
return 404;
} //防盗链
}
