Nginx系列教程03

发表于 | 分类于
字数统计: 1,070 | 阅读时长 ≈ 5

本文主要介绍nginx服务器的rewrite规则。

1.Nginx URL重写（rewrite）介绍

rewrite功能是实现RUL地址的重定向。Nginx的rewrite功能需要PCRE软件的支持，即通过perl兼容正则表达式语句进行规则匹配的。

  • rewrite语法格式及参数语法：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    rewrite <regex> <replacement> [flag]
    关键字   正则     替代内容    flag标记

    关键字：其中关键字error_log不能改变
    正则：perl兼容正则表达式语句进行规则匹配
    替代内容：将正则匹配的内容替换成replacement
    flag标记：rewrite支持的flag标记

    flag标记说明：
    last			#本条规则匹配完成后，继续向下匹配新的location URI规则
    break			#本条规则匹配完成即终止，不再匹配后面的任何规则
    redirect		#返回302临时重定向，浏览器地址会显示跳转后的URL地址
    permanent		#返回301永久重定向，浏览器地址栏会显示跳转后的URL地址

  • rewrite参数的标签段位置

    1
    server,location,if

  • regex常用正则表达式说明
    | 字符 | 描述 |
    | - | :-: |
    | \ | 转移字符，如”\n”匹配一个换行符，而”\$”则匹配”$” |
    | ^ | 匹配输入字符串的起始位置 |
    | $ | 匹配输入字符串的结束位置 |
    | | 匹配前面的字符零次或多次。如”ol“能匹配”o”及”ol”、”oll” |
    | + | 匹配前面的字符一次或多次。如“ol+”能匹配“ol”及“oll”、“oll”，但不能匹配“o” |
    | ? | 匹配前面的字符零次或一次，例如“do(es)?”能匹配“do”或者“does”，”?”等效于”{0,1}” |
    | . | 匹配除“\n”之外的任何单个字符 |
    | (pattern) | 常用$0…$9属性获取小括号中的匹配内容，要匹配圆括号字符需要(Content) |

示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
location = / {  
    #规则A  
}  
location = /login {  
    #规则B  
}  
location ^~ /static/ {  
    #规则C  
}  
location ~ \.(gif|jpg|png|js|css)$ {  
    #规则D  
}  
location ~* \.png$ {  
    #规则E  
}  
location !~ \.xhtml$ {  
    #规则F  
}  
location !~* \.xhtml$ {  
    #规则G  
}  
location / {  
    #规则H  
}

2.常用的变量

$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相同。

3.rewrite应用

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
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://mysite.com/ permanent;
} //如果query string中包含"post=140"，永久重定向到mysite.com

  • 301永久定向到新域名

    1
    2
    3
    4
    5
    6
    server {
        listen 80;
        listen 443 ssl;
        server_name www.old-name.com old-name.com;
        return 301 $scheme://www.new-name.com;
    }

  • 不带www的域名301跳转到带www的域名

    1
    2
    3
    4
    5
    6
    server {
        listen 80;
        listen 443 ssl;
        server_name mysite.com;
        return 301 $scheme://www.mysite.com$request_uri;
    }

  • http站点301跳转到https站点

    1
    2
    3
    4
    5
    server {
        listen 80;
        server_name www.mysite.com;
        return 301 https://www.mysite.com$request_uri;
    }
---------------- The End ----------------