nginx经常使用变量/rewrite用法/location优先级

时间  2019-11-20
标签 nginx 经常 使用 变量 rewrite 用法 location 优先级 栏目 Nginx 繁體版
原文   原文链接

来源：https://blog.csdn.net/Powerful_Fyphp

变量 说明
$args 请求中的参数，如www.test.com/1.php?a=1&b=2的$args就是a=1&b=2
$content_length HTTP请求信息里的"Content-Length"
$conten_type HTTP请求信息里的"Content-Type"
$document_root nginx虚拟主机配置文件中的root参数对应的值
$document_uri 当前请求中不包含指令的URI，如www.123.com/1.php?a=1&b=2的$document_uri就是1.php,不包含后面的参数
$host 主机头，也就是域名
$http_user_agent 客户端的详细信息，也就是浏览器的标识，用curl -A能够指定
$http_cookie 客户端的cookie信息
$limit_rate 若是nginx服务器使用limit_rate配置了显示网络速率，则会显示，若是没有设置， 则显示0
$remote_addr 客户端的公网ip
$remote_port 客户端的port
$remote_user 若是nginx有配置认证，该变量表明客户端认证的用户名
$request_body_file 作反向代理时发给后端服务器的本地资源的名称
$request_method 请求方法，GET/PUT/DELETE等
$request_filename 当前请求的资源文件的路径名称，至关因而$document_root/$document_uri的组合
$request_uri 请求的连接，包括$document_uri和$args
$scheme 请求的协议，如ftp,http,https
$server_protocol 客户端请求资源使用的协议的版本，如HTTP/1.0，HTTP/1.1，HTTP/2.0等
$server_addr 服务器IP地址
$server_name 服务器的主机名
$server_port 服务器的端口号
$uri 和$document_uri相同
$http_referer 客户端请求时的referer，通俗讲就是该请求是经过哪一个连接跳过来的，用curl -e能够指定

@[TOC]css

rewrite在if中的用法

格式：if (条件判断) { 具体的rewrite规则 }html

if条件判断语句由Nginx内置变量、逻辑判断符号和目标字符串三部分组成。
其中，内置变量是Nginx固定的非自定义的变量，如，$request_method, $request_uri等。
逻辑判断符号，有=, !=, ~, ~*, !~, !~*
!表示相反的意思，~为匹配符号，它右侧为正则表达式，区分大小写，而~*为不区分大小写匹配。
目标字符串能够是正则表达式，一般不用加引号，但表达式中有特殊符号时，好比空格、花括号、分号等，须要用单引号引发来。

示例1：当http请求方法为post时，返回403状态码nginx

if ($request_method = POST)
{
    return 403; 
}

示例2：经过浏览器标识匹配关键字，禁止IE浏览器访问web

if ($http_user_agent ~* MSIE) 
{
    return 403;
}

限制多个浏览器：正则表达式

if ($http_user_agent ~* "MSIE|firefox|Chrome")
{
    return 403;
}

示例3：当请求的文件不存在时，进行重定向或return状态码等处理操做shell

if(!-f $request_filename)
{
    rewrite 语句;
}

示例4：判断uri中某个参数的内容后端

if($request_uri ~* 'gid=\d{6,8}/') 
{
    rewrite 语句;
}

#\d表示数字，{6,8}表示数字出现的次数是6到8次，当uri中gid参数的值包含6-8个数字那么执行rewrite语句浏览器

rewrite中break和last的用法

两个指令用法相同，但含义不一样，须要放到rewrite规则的末尾，用来控制重写后的连接是否继续被nginx配置执行(主要是rewrite、return指令)。服务器

1.break和last在location{}外部时

测试示例：

server{
    listen 80; 
    server_name test.com;
    root /data/wwwroot/test.com;

    rewrite /1.html /2.html;
    rewrite /2.html /3.html;
}

#请求1.html文件时，会被重定向到2.html，而后被重定向到3.html，最后返回的文件为3.html

示例1：在rewrite 指令后面添加break

server{
    listen 80; 
    server_name test.com;
    root /data/wwwroot/test.com;

    rewrite /1.html /2.html break;
    rewrite /2.html /3.html;
}

#请求1.html文件时，会被重定向到2.html，而后直接返回2.html，break在此处的做用就是当匹配第一个rewrite指令成功时，不执行后面的rewrite指令

示例2：当break后面还有location{}的状况

server{
    listen 80; 
    server_name test.com;
    root /data/wwwroot/test.com;

    rewrite /1.html /2.html break;
    rewrite /2.html /3.html;
    location /2.html {
        return 403;
    }
}

#请求1.html文件时，会返回403状态码，当1.html被重定向到2.html时，break不会匹配后面的rewrite规则，但条件2.html匹配location{}定义的文件2.html，因此会执行return 403

#以上两个示例中，将break换成last效果同样

2.break和last在location{}内部时

测试示例：

server{
    listen 80; 
    server_name test.com;
    root /data/wwwroot/test.com;
    
    location / {
        rewrite /1.html /2.html;
        rewrite /2.html /3.html;
    }
    location /2.html
    {
        rewrite /2.html /a.html;
    }
    location /3.html
    {
        rewrite /3.html /b.html;
    }
}

#请求1.html，会通过两次重定向到3.html，3.html又恰好匹配location /3.html{}，因此返回b.html，当请求2.html时，会直接返回a.html，由于location /2.html {} 更精准，优先匹配

示例1：在rewrite后面添加break

server{
    listen 80; 
    server_name test.com;
    root /data/wwwroot/test.com;
    
    location / {
        rewrite /1.html /2.html break;
        rewrite /2.html /3.html;
    }
    location /2.html
    {
        rewrite /2.html /a.html;
    }
    location /3.html
    {
        rewrite /3.html /b.html;
    }
}

#请求1.html，会返回2.html，不会返回a.html，当break再location {} 内部时，遇到break后，当前location{} 以及后面的location{} 的指令都再也不执行

示例2：在rewrite后面添加last

server{
    listen 80; 
    server_name test.com;
    root /data/wwwroot/test.com;
    
    location / {
        rewrite /1.html /2.html last;
        rewrite /2.html /3.html;
    }
    location /2.html
    {
        rewrite /2.html /a.html;
    }
    location /3.html
    {
        rewrite /3.html /b.html;
    }
}

#请求1.html时，会返回a.html，在location {} 内部遇到last，当前location {}中剩下的指令不会再执行，但被重定向的url会从新匹配一遍location {}

3.break和last用法总结

1.当rewrite规则在location{}外，break和last做用同样，遇到break或last后，其后续的rewrite/return语句再也不执行。但后续有location{}的话，还会近一步执行location{}里面的语句,前提是请求能匹配该location 2.当rewrite规则在location{}里，遇到break后，本location{}与其余location{}的全部rewrite/return规则都再也不执行 3.当rewrite规则在location{}里，遇到last后，本location{}里后续rewrite/return规则不执行，但重写后的url再次从头匹配全部location

return的用法

该指令通常用于对请求的客户端直接返回响应状态码。在该做用域内return后面的全部nginx配置都是无效的，可使用在server、location以及if配置中，除了支持跟状态码，还能够跟字符串或者url连接。

示例1：直接返回状态码

server{
    listen 80;
    server_name www.test.com;
    return 403;
    rewrite www.test.net;  
}

#访问时，直接返回403状态码，return返回内容后，后面的配置rewrite不会执行

示例2：当return在if 判断中时

server {
.....

if ($request_uri ~ "\.password|\.bak")
{
    return 404;
    rewrite /(.*) /index.html;  
}
.....
}

#请求的文件包含.password或.bak时，直接返回404，rewrite不会执行，但if {}外的配置会继续执行，return只在当前做用域中生效

示例3：返回字符串

server{
    listen 80;
    server_name www.test.com;
    return 200 "hello";
}

#返回字符串必须加上状态码，不然会报错

示例4：返回nginx变量

location /1.html {
    return 200 "$host $request_uri";
}

示例5：返回url

server{
    listen 80;
    server_name www.test.com;
    return http://www.test.com/index2.html;
}

#返回url时，必须以http://或https://开头

示例6：返回html代码

if ($http_referer ~ 'baidu.com') 
{
    return 200 "<html><script>window.location.href='//$host$request_uri';</script></html>";
}

#当网站被黑了的时候，从百度点进网站是连接都会跳转到其余网站，可使用该方法暂时处理 #注意：return http://$host$request_uri; 在浏览器中会提示"重定向的次数过多"

rewrite的语法规则

格式：rewrite regex replacement [flag]

rewrite 配置能够在server、location以及if配置段内生效

regex 是用于匹配URI的正则表达式，其不会匹配到$host（域名）

replacement 是目标跳转的URI，能够以http://或者https://开头，也能够省略掉$host，直接写$request_uri部分

flag 用来设置rewrite对URI的处理行为，其中有break、last、rediect、permanent，其中break和last在前面已经介绍过，rediect和permanent的区别在于，前者为临时重定向(302)，然后者是永久重定向(301)，对于用户经过浏览器访问，这二者的效果是一致的。 可是，对于搜索引擎爬虫来讲就有区别了，使用301更有利于SEO。因此，建议replacemnet是以http://或者https://开头的，flag使用permanent。

示例1：域名跳转

location / {
    rewrite /(.*) http://www.test.com/$1 permanent;
}

# .*为正则表达式，表示uri，用()括起来，在后面的uri中能够调用它，第一次出现的()用$1调用，第二次出现的()用$2调用，以此类推。

示例2：域名跳转的第二种写法

location / {
    rewrite /.* http://www.test.com$request_uri permanent;
}

示例3：文件跳转

server{
    listen 80;
    server_name www.test.com;
    root /data/wwwroot/test.com;
    index index.html;
    if ($request_uri !~ '^/web/')
    {
        rewrite /(.*) /web/$1 redirect;
    }
}

#将uri请求的文件重定向到web/目录中去寻找

错误写法1：

server{
    listen 80;
    server_name www.test.com;
    root /data/wwwroot/test.com;
    index index.html;
    rewrite /(.*) /web/$1 redirect;
}

#这样写会反复循环，直到浏览器最大循环限制次数，哪怕uri包含web/目录了，也会继续重定向/web/web/$1

错误写法2：

server{
    listen 80;
    server_name www.test.com;
    root /data/wwwroot/test.com;
    index index.html;
    rewrite /(.*) /web/$1 break;
}

#添加break后不会致使循环，但若是uri中包含web/目录的状况下也会被重定向一次，重定向后的uri就是web/web/$1

rewrite应用实例

1.域名跳转（域名重定向）

单个域名的状况：

server{
    listen 80;
    server_name www.test.com;
    rewrite /(.*) http://www.test.net/$1 permanent;    
}

多个域名的状况：

server{
    listen 80;
    server_name www.test.com www.test.net;
    if ($host != 'www.test.net')
    {
        rewrite /(.*) http://www.test.net/$1 permanent;
    }
}

2.http跳转https

server{
    listen 80;
    server_name www.test.com;
    rewrite /(.*) https://www.test.com/$1 permanent;
}

3.跳转二级目录

server{
    listen 80;
    server_name bbs.test.com;
    rewrite /(.*) http://www.test.com/bbs/$1 last;
}

4.动静态请求分离

server{
    listen 80;
    server_name www.test.com;
    location ~* .*\.(jpg|jpeg|gif|css|png|js)$
    {
        rewrite /(.*) http://img.test.com/$1 permanent;
    }
}

#假设www.test.com的服务器在国外，访问速度较慢，img.test.com的服务器在国内，访问速度正常，能够将访问www.test.com静态文件的请求重定向到img.test.com，提升文件返回速度

第二种写法：

server{
    listen 80;
    server_name www.test.com;
    if ( $uri ~* 'jpg|jpeg|gif|css|png|js$')
    {
        rewrite /(.*) http://img.test.com/$1 permanent;
    }
}

5.防盗链配置

server{
    listen 80;
    server_name www.test.com;
    location ~* ^.+.(jpg|jpeg|gif|css|png|js|rar|zip|flv)$
    {
        valid_referers none blocked server_names *.test.com
        if ($invalid_referer)
        {
            return 403;
        }
    }
}

#配置防盗链避免别的网站引用www.test.com不想被引用的图片等文件

http_referer表示从哪儿点击进网站的，好比从百度搜索引擎访问的 valid_referers：白名单 invalid_referer：无效的（未在白名单中定义的） none：容许referer为空（也就是容许直接访问，未从其余站点跳转的请求） blocked：容许来源地址不含http/https

6.伪静态（将静态页面重写为动态）

location /  {
    rewrite ^([^\.]*)/topic-(.+)\.html$ $1/portal.php?mod=topic&topic=$2 last;
    rewrite ^([^\.]*)/forum-(\w+)-([0-9]+)\.html$ $1/forum.php?mod=forumdisplay&fid=$2&page=$3 last;
    rewrite ^([^\.]*)/thread-([0-9]+)-([0-9]+)-([0-9]+)\.html$ $1/forum.php?mod=viewthread&tid=$2&extra=page%3D$4&page=$3 last;
    rewrite ^([^\.]*)/group-([0-9]+)-([0-9]+)\.html$ $1/forum.php?mod=group&fid=$2&page=$3 last;
    rewrite ^([^\.]*)/space-(username|uid)-(.+)\.html$ $1/home.php?mod=space&$2=$3 last;
    rewrite ^([^\.]*)/(fid|tid)-([0-9]+)\.html$ $1/index.php?action=$2&value=$3 last;
}

#示例为discuz的伪静态配置

7.多个if并用

location /{
    set $a 0;
    if ($document_uri !~ '^/abc')
    {
        set $a "${a}1";		#uri不以/abc开头时，$a的值变为01
    }
    if ($http_user_agent ~* 'ie6|firefox')
    {
       set $a "${a}2";		#浏览器标识包含ie6或者Firefox时，$a的值变为012
    }
    if ($a = "012")			#当知足前两个if判断时，重写url
    {
        rewrite /(.*) /abc/$1 redirect;
    }
}

#nginx配置文件语法不支持if嵌套，须要经过多个if并用判断时，使用标识变量值的方式处理

补充：shell中能够直接写 set $a "$a1" ，$a的值会变为01，nginx中须要将变量名用{}标识：set $a "${a}1"

Nginx location优先级详解：

nginx location语法规则：location [=|~|~*|^~|/] /uri/ { … } nginx的location匹配的变量是$uri

符号 说明
= 表示精确匹配
^~ 表示uri以指定字符或字符串开头
~ 表示区分大小写的正则匹配
~* 表示不区分大小写的正则匹配
/ 通用匹配，任何请求都会匹配到

优先级规则：

= 高于 ^~ 高于 ~* 等于 ~ 高于 /

规则示例：

location = "/12.jpg" { ... } 如： www.test.com/12.jpg 匹配 www.test/abc/12.jpg 不匹配

location ^~ "/abc/" { ... } 如： www.test/abc/123.html 匹配 www.test.com/a/abc/123.jpg 不匹配

location ~ "png" { ... } 如： www.test.com/aaa/bbb/ccc/123.png 匹配 www.test.com/aaa/png/123.html 匹配

location ~* "png" { ... } 如： www.test.com/aaa/bbb/ccc/123.PNG 匹配 www.test.com/aaa/png/123.html 匹配

location /admin/ { ... } 如： www.test.com/admin/aaa/1.php 匹配 www.test.com/123/admin/1.php 不匹配

对比 / 和 ~ 示例1：

server{
    listen 80;
    server_name www.test.com;
    root /tmp/123.com;

    location /abc/
    {
        echo "/";
    }
    location ~ 'abc'
    {
        echo "~";
    }
}

测试命令：curl -x127.0.0.1:80 'www.test.com/abc/1.png' 结果是：~

对比 ~ 和 ~* 示例2：

server
{
    listen 80;
    server_name www.test.com;
    root /tmp/123.com;

    location ~ 'abc'
    {
        echo '~';
    }
    location ~* 'abc'
    {
        echo '~*';
    }
}

测试命令：curl -x127.0.0.1:80 'www.test.com/abc/123.html' 结果是：~

示例3：

server
{
    listen 80;
    server_name www.test.com;
    root /tmp/123.com;

    location ~* 'abc'
    {
        echo '~*';
    }
    location ~ 'abc'
    {
        echo '~';
    }
}

测试命令：curl -x127.0.0.1:80 'www.test.com/abc/123.html' 结果是：~*

结论：~ 和 ~*优先级实际上是同样的，若是两个同时知足条件，配置文件中哪一个location靠前，哪一个生效。

对比 ^~ 和 ~ 示例4：

server
{
    listen 80;
    server_name www.test.com;
    root /tmp/123.com;

    location ~ '/abc'
    {
        echo '~';
    }
    location ^~ '/abc'
    {
        echo '^~';
    }
}

测试命令：curl -x127.0.0.1:80 'www.test.com/abc/123.html 结果是：^~

对比 = 和 ^~ 示例5：

server
{
    listen 80;
    server_name www.test.com;
    root /tmp/123.com;

    location ^~ '/abc.html'
    {
        echo '^~';
    }
    location = '/abc.html'
    {
        echo '=';
    }
}

测试命令：curl -x127.0.0.1:80 'www.test.com/abc.html 结果是：=

补充： location不支持 ! 取反 错误示例：location !~ .*.jpg {...} 可使用if：if ( $uri !~ '.jpg') {...}

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程