nginx中的rewrite语句

红色多瑙河

　　rewrite命令使用正则表达式来匹配请求URI，被匹配到的URI将会被重写，可以实现内部URL重写或URL重定向。rewrite命令可以出现在server、location、if语句块中。多个rewrite语句按照它们在配置文件中出现的位置从上往下顺序执行，匹配到某一条rewrite语句后是否会继续向下执行或后续如何处理，由那条语句决定。
　　命令语法格式：
　　rewrite  正则表达式  新URI  [flag];

• 　　"正则表达式"用于匹配"请求URI"，匹配到的URI将会被替换成"新URI"。
  

• 　　"新URI"可以是单纯的URI，也可以是一个完整的URL地址：
  
  
  
  • 　　当"新URI"是单纯的URI时，称作内部URL重写。此时本条rewrite语句会按照规则将请求URL重写成新的URL，但重写完成后的行为则受 [flag] 选项控制。
    
  • 　　当"新URI"是一个完整的URL地址，即以"http://"、"https://"或"$scheme"开头的地址时，称作URL重定向。此时本条rewrite规则重写完成后，服务端不再进行进一步处理，它会立刻将得到的新URL返回给客户端(301、302等重定向的形式)，服务端处理完成，客户端则会重新发起对新URL的请求。
    
  
  

• 　　[flag] 选项用于调控重写的行为，它的取值可能是：
  
  
  
  • 　　last：重写完成后，会停止继续处理当前区块所有属于ngx_http_rewrite_module模块的语句(即不会继续匹配当前区块余下的rewrite语句或其它属于该模块的语句)。重写得到的新URL会重新匹配所有location语句，以进行进一步处理。
    
  • 　　break：重写完成后，会停止继续处理当前区块所有属于ngx_http_rewrite_module模块的语句(即不会继续匹配当前区块余下的rewrite语句或其它属于该模块的语句)，就像break命令一样，不会有进一步的动作。
    
  • 　　redirect：重写完成后，返回带有302代码(临时重定向)的新URL给客户端，服务端处理完成。该flag只有在"新URI"不是完整的URL地址时才会生效。
    
  • 　　permanent：重写完成后，返回带有301代码(永久重定向)的新URL给客户端，服务端处理完成。
    
  
  

　　示例：
　　先在网页根目录下创建一些目录和文件用于后续测试。
　　[root@gw ~]# mkdir -p /usr/local/nginx/html/dir/subdir1
　　[root@gw ~]# mkdir -p /usr/local/nginx/html/dir/subdir2
　　[root@gw ~]# echo 'subdir1 testfile.html' > /usr/local/nginx/html/dir/subdir1/testfile.html
　　[root@gw ~]# echo 'subdir2 testfile.html' > /usr/local/nginx/html/dir/subdir2/testfile.html
　　修改nginx配置文件，定义rewrite规则，可以在server语句块中定义。
　　[root@gw ~]# vim /usr/local/nginx/conf/nginx.conf
　　server {
　　rewrite  ^/dir/(.*)/.*$  /dir/$1/testfile.html  break;
　　}
　　上面rewrite规则的含义是：若请求URI符合^/dir/(.*)/.*$，则将其重写为/dir/$1/testfile.html。$1是引用请求URI中第一个括号括起来的内容，$2、$3等类似（如果有的话）。这样，当请求是http://172.16.111.114/dir/subdir1/whaterver这种时，它将变成访问/dir/subdir1/testfile.html；若请求是http://172.16.111.114/dir/subdir2/whaterver时，它将访问/dir/subdir2/testfile.html这个文件。如下所示：

　　打开浏览器，按下F12键，切换到网络选项卡，再在浏览器地址栏中输入要访问的URL地址，就可以看到是否有URL重写或重定向：