Nnginx Rewrite 和 location学习记录

Rewrite与Location区别：
　　Location是对一类路径做访问控制或反向代理
　　Rewrite是对同一域名内更改资源的路径

location  = / {
  # 精确匹配 / ，主机名后面不能带任何字符串
  [ configuration A ] 
}
location  / {
  # 因为所有的地址都以 / 开头，所以这条规则将匹配到所有请求
  # 但是正则和最长字符串会优先匹配
  [ configuration B ] 
}
location /documents/ {
  # 匹配任何以 /documents/ 开头的地址，匹配符合以后，还要继续往下搜索
  # 只有后面的正则表达式没有匹配到时，这一条才会采用这一条
  [ configuration C ] 
}
location ~ /documents/Abc {
  # 匹配任何以 /documents/ 开头的地址，匹配符合以后，还要继续往下搜索
  # 只有后面的正则表达式没有匹配到时，这一条才会采用这一条
  [ configuration CC ] 
}
location ^~ /images/ {
  # 匹配任何以 /images/ 开头的地址，匹配符合以后，停止往下搜索正则，采用这一条。
  [ configuration D ] 
}
location ~* \.(gif|jpg|jpeg)$ {
  # 匹配所有以 gif,jpg或jpeg 结尾的请求
  # 然而，所有请求 /images/ 下的图片会被 config D 处理，因为 ^~ 到达不了这一条正则
  [ configuration E ] 
}
location /images/ {
  # 字符匹配到 /images/，继续往下，会发现 ^~ 存在
  [ configuration F ] 
}
location /images/abc {
  # 最长字符匹配到 /images/abc，继续往下，会发现 ^~ 存在
  # F与G的放置顺序是没有关系的
  [ configuration G ] 
}
location ~ /images/abc/ {
  # 只有去掉 config D 才有效：先最长匹配 config G 开头的地址，继续往下搜索，匹配到这一条正则，采用
    [ configuration H ] 
}
location ~* /js/.*/\.js

已=开头表示精确匹配
如 A 中只匹配根目录结尾的请求，后面不能带任何字符串。
^~ 开头表示uri以某个常规字符串开头，不是正则匹配
~ 开头表示区分大小写的正则匹配;
~* 开头表示不区分大小写的正则匹配
/ 通用匹配, 如果没有其它匹配,任何请求都会匹配到

顺序 no优先级：
(location =) > (location 完整路径) > (location ^~ 路径) > (location ~,~* 正则顺序) > (location 部分起始路径) > (/)

上面的匹配结果
按照上面的location写法，以下的匹配示例成立：

/ -> config A
精确完全匹配，即使/index.html也匹配不了
/downloads/download.html -> config B
匹配B以后，往下没有任何匹配，采用B
/images/1.gif -> configuration D
匹配到F，往下匹配到D，停止往下
/images/abc/def -> config D
最长匹配到G，往下匹配D，停止往下
你可以看到任何以/images/开头的都会匹配到D并停止，FG写在这里是没有任何意义的，H是永远轮不到的，这里只是为了说明匹配顺序
/documents/document.html -> config C
匹配到C，往下没有任何匹配，采用C
/documents/1.jpg -> configuration E
匹配到C，往下正则匹配到E
/documents/Abc.jpg -> config CC
最长匹配到C，往下正则顺序匹配到CC，不会往下到E

实际使用建议

所以实际使用中，个人觉得至少有三个匹配规则定义，如下：
#直接匹配网站根，通过域名访问网站首页比较频繁，使用这个会加速处理，官网如是说。
#这里是直接转发给后端应用服务器了，也可以是一个静态首页
# 第一个必选规则
location = / {
    proxy_pass http://tomcat:8080/index
}
# 第二个必选规则是处理静态文件请求，这是nginx作为http服务器的强项
# 有两种配置模式，目录匹配或后缀匹配,任选其一或搭配使用
location ^~ /static/ {
    root /webroot/static/;
}
location ~* \.(gif|jpg|jpeg|png|css|js|ico)$ {
    root /webroot/res/;
}
#第三个规则就是通用规则，用来转发动态请求到后端应用服务器
#非静态文件请求就默认是动态请求，自己根据实际把握
#毕竟目前的一些框架的流行，带.php,.jsp后缀的情况很少了
location / {
    proxy_pass http://tomcat:8080/
}

Nginx Rewrite 规则相关指令

相关指令有if,rewrite,set,return,break等，其中最关键的就是rewrite.一个简单的Nginx Rewrite规则语法如下：

rewrite ^/b/(.*)\.html /play.php?video=$1 break;

1.break指令

默认值：none ;使用环境：server,location,if ;

该指令的作用是完成当前的规则集，不再处理rewrite指令。

2.if指令

默认值：none ;使用环境：server,location

该指令用于检查一个条件是否符合，如果条件符合，则执行大括号内的语句。If指令不支持嵌套，不支持多个条件&&和||处理。

A.变量名，错误的值包括：空字符串""或者任何以0开始的字符串

B.变量比较可以使用"="(表示等于)和"!="(表示不等于)

C.正则表达式模式匹配可以使用"~*"和"~"符号

D."~"符号表示区分大小写字母的匹配

E."~*"符号表示不区分大小写字母的匹配

F."!~"和"!~*"符号的作用刚好和"~"、"~*"相反，表示不匹配

G."-f"和"!-f"用来判断文件是否存在

H."-d"和"!-d"用来判断目录是否存在

I."-e"和"!-e"用来判断文件或目录是否存在

J."-x"和"!-x"用来判断文件是否为可执行

K.部分正则表达式可以在()内，用$1~$9来访问

3.return指令

语法：return code ;使用环境：server,location,if ;

该指令用于结束规则的执行并返回状态码给客户端。

示例：如果访问的URL以".sh"或".bash"结尾，则返回403状态码

location ~ .*\.(sh|bash)?$

{

return 403;

}

4.rewrite 指令

语法：rewrite regex replacement flag

默认值：none ; 使用环境：server,location,if

该指令根据表达式来重定向URI，或者修改字符串。指令根据配置文件中的顺序来执行。注意重写表达式只对相对路径有效。如果你想配对主机名，你应该使用if语句，示例如下：

if( $host ~* www\.(.*) )

{

set $host_without_www $1;

rewrite ^(.*)$ http://$host_without_www$1 permanent;

}

rewrite指令的最后一项参数为flag标记，支持flag标记有：

1.last 相当于apache里面的[L]标记，表示rewrite。

2.break本条规则匹配完成后，终止匹配，不再匹配后面的规则。

3.redirect 返回302临时重定向，浏览器地址会显示跳转后的URL地址。

4.permanent 返回301永久重定向，浏览器地址会显示跳转后的URL地址。

使用last和break实现URI重写，浏览器地址栏不变。而且两者有细微差别，使用alias指令必须用last标记;使用proxy_pass指令时，需要使用break标记。Last标记在本条rewrite规则执行完毕后，会对其所在server{......}标签重新发起请求，而break标记则在本条规则匹配完成后，终止匹配。

一般在跟location中(location /{...})或直接在server标签中编写rewrite规则，推荐使用last标记；在非根location中(location /cms/{...})，则使用break。

如果URI中含有参数(/app/test.php?id=5)，默认情况下参数会被自动附加到替换串上，你可以通过在替换串的末尾加上?标记来解决这一问题。

例如：rewrite ^/test(.*)$ http://www.xiaozhe.com/home permanent;

访问http://www.xiaozhe.com/test?id=5 会跳转到 http://www.xiaozhe.com/home?id=5

例如：如果我们将类似URL /photo/123456 重定向到 /path/to/photo/12/1234/123456.png

Rewrite "/photo/([0-9]{2})([0-9]{2})([0-9]{2})" /path/to/photo/$1/$1$2/$1$2$3.png ;

注：如果正则表达式里面有花括号"{"或"}" ，应该使用双引号或单引号。

5.Set指令

语法：set variable value ; 默认值:none ; 使用环境：server,location,if;

该指令用于定义一个变量，并给变量赋值。变量的值可以为文本、变量以及文本变量的联合。

示例：set $varname "hello world";

6.Uninitialized_variable_warn指令

语法：uninitialized_variable_warn on|off

使用环境：http,server,location,if

该指令用于开启和关闭未初始化变量的警告信息，默认值为开启。

7.Nginx Rewrite可以用到的全局变量

$args ,$content_length ,$content_type ,$document_root ,$document_uri ,$host ,$http_user_agent ,$http_cookie ,$limit_rate ,$request_body_file ,$request_method ,$remote_addr ,$remote_port ,$remote_user ,$request_filename ,$request_uri ,$query_string ,$scheme ,$server_protocol ,$server_addr ,$server_name ,$server_port ,$uri .

Nginx的Rewrite规则编写实例

1.当访问的文件和目录不存在时，重定向到某个php文件

if( !-e $request_filename )

{

rewrite ^/(.*)$ index.php last;

}

2.目录对换 /123456/xxxx ====> /xxxx?id=123456

rewrite ^/(\d+)/(.+)/ /$2?id=$1 last;

3.如果客户端使用的是IE浏览器，则重定向到/ie目录下

if( $http_user_agent ~ MSIE)

{

rewrite ^(.*)$ /ie/$1 break;

}

4.禁止访问多个目录

location ~ ^/(cron|templates)/

{

deny all;

break;

}

5.禁止访问以/data开头的文件

location ~ ^/data

{

deny all;

}

6.禁止访问以.sh,.flv,.mp3为文件后缀名的文件

location ~ .*\.(sh|flv|mp3)$

{

return 403;

}

7.设置某些类型文件的浏览器缓存时间

location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$

{

expires 30d;

}

location ~ .*\.(js|css)$

{

expires 1h;

}

Http核心模块的内置变量：

$uri:当前请求的uri，不带参数；$uri不包含主机名，如”/foo/bar.html”。
$request_uri ： 包含请求参数的原始URI，不包含主机名，如：”/foo/bar.php?arg=baz”。
$host:http请求报文中的host首部，如果请求中没有host首部，则以处理次请求的虚拟主机的主机名代替
$host ： 请求主机头字段，否则为服务器名称。
$hostname：nginx服务运行在的主机的主机名
$limit_rate ： 这个变量可以限制连接速率。
$remote_addr ： 客户端的IP地址。
$remote_port:客户端端口
$remote_user:已经经过Auth Basic Module验证的用户名。
$request_filename ： 当前请求的文件路径，由root或alias指令与URI请求生成。
$request_method:请求方法 POST|GET
$server_addr:服务器地址
$server_name:服务器名称
$server_port:服务器端口
$server_protocol:请求使用的协议，通常是HTTP/1.0或HTTP/1.1。
$scheme ： HTTP方法（如http，https）。
$http_user_agent ： 客户端agent信息
$http_cookie ： 客户端cookie信息
$http_HEADER:匹配请求报文中指定的HEADER，例如$http_host 匹配请求报文中的host首部
$sent_http_header:匹配响应报文中指定的header 例如$http_content_type匹配响应报文中的content_type首部
$document_root ： 当前请求在root指令中指定的值。
$args ： #这个变量等于请求行中的参数，同$query_string
$content_length ： 请求头中的Content-length字段。
$content_type ： 请求头中的Content-Type字段。

Nginx和Apache的Rewrite规则实例对比

1.一般简单的Nginx和Apache规则的区别不大，基本能够完全兼容，例如：

Apache: RewriteRule ^/abc/$ /web/abc.php [L]

Nginx: rewrite ^/abc/$ /web/abc.php last ;

我们可以看出来只要把Apache的RewriteRule改为Nginx的rewrite，Apache的[L]改为last 即可。

如果将Apache的规则改为Nginx规则后，用命令Nginx -t 检查发现错误，则我们可以尝试给条件加上引号，例如：

rewrite “^/([0-9]{5}).html$” /x.php?id=$1 last;

2.Apache和Nginx的Rewrite规则在URL跳转时有细微区别：

Apache: RewriteRule ^/html/([a-zA-Z]+)/.*$ /$1/ [R=301,L]

Nginx: rewrite ^/html/([a-zA-Z]+)/.*$ http://$host/$1/ premanent ;

我们可以看到在Nginx的跳转中，我们需要加上http://$host，这是在Nginx中强烈要求的。

3.下面是一些Apache和Nginx规则的对应关系

a.Apache的RewriteCond对应Nginx的if

b.Apache的RewriteRule对应Nginx的rewrite

c.Apache的[R]对应Nginx的redirect

d.Apache的[P]对应Nginx的last

e.Apache的[R,L]对应Nginx的redirect

f.Apache的[P,L]对应Nginx的last

g.Apache的[PT,L]对应Nginx的last

例如：允许指定的域名访问本站，其他的域名一律转向www.xiaozhe.com

Apache:

RewriteCond %{HTTP_HOST} !^(.*?)\.aaa\.com$ [NC]

RewriteCond %{HTTP_HOST} !^localhost$

RewriteCond %{HTTP_HOST} !^192\.168\.0\.(.*?)$

RewriteRule ^/(.*)$ http://www.xiaozhe.com [R,L]

Nginx:

if( $host ~* ^(.*)\.aaa\.com$ )

{

set $allowHost ‘1’;

}

if( $host ~* ^localhost )

{

set $allowHost ‘1’;

}

if( $host ~* ^192\.168\.1\.(.*?)$ )

{

set $allowHost ‘1’;

}

if( $allowHost !~ ‘1’ )

{

rewrite ^/(.*)$ http://www.xiaozhe.com redirect ;

}

posted on 2015-11-18 14:13 王翊辰阅读(148) 评论(0) 收藏举报

刷新页面返回顶部

AWHANE

Nnginx Rewrite 和 location学习记录

实际使用建议

导航

公告