该ngx_http_rewrite_module模块用于使用PCRE正则表达式更改请求URI,返回重定向,以及有条件地选择配置。rewrite指令的功能就是,使用nginx提供的全局变量或自己设置的变量,然后结合正则表达式和标志位实现url重写以及重定向。 因此需要检查pcre是否安装
[root@]# rpm -q pcre pcre-8.32-17.el7.x86_64 break break语法 语法 break; 默认 - 应用位置 server,location,if 停止处理任何rewrite的相关指令。如果出现在location里面,那么所有后面的rewrite模块指令都不会再执行,也不发起内部重定向,而是直接用新的URI进一步处理请求。
例子 location = /testbreak { break; return 200 $request_uri; } 当uri中包含testbreak时,那么会停止执行后面的rewrite模块的命令,return属于rewrite模块。
if if语法 语法 if (condition) { ... } 默认 - 应用位置 server,location if中的几种判断条件 当变量的值为空字符串或“ 0”时,变量为false ;在1.0.1版之前,任何以“ 0” 开头的字符串都被视为false值。 使用“ =”和“ !=”运算符比较变量和字符串; 变量使用“ ~”(对于区分大小写的匹配)和“ ~*”(对于不区分大小写的匹配)运算符与正则表达式进行匹配。正则表达式可以包含可供以后在$1.. $9变量中重用的捕获。也可以使用!取反。 使用“ -f”和“ !-f”运算符检查文件是否存在; 使用“ -d”和“ !-d”运算符检查目录是否存在; 使用“ -e”和“ !-e”运算符检查文件,目录或符号链接是否存在; 使用“ -x”和“ !-x”运算符检查可执行文件。 例子: if ($request_method = POST ) { return 405; }
if ( !-f $filename ) {
break;
}
return
停止处理并为客户端返回状态码,没有状态码的URL将被视为一个302状态码。
return语法
语法 return code [text];return code URL;return URL; 默认 - 应用位置 server,location 例子:
return code [text];
location = /1 { return 200 "this is 1"; }
return code URL;
location = / { return 302 http://www.wanger.com; }
return URL;
location = / {
return http://www.wanger.com;
}
rewrite
应用场景
URL访问跳转,支持开发设计。 页面跳转、兼容性支持(新旧版本更迭)、展示效果(网址精简)等。
SEO优化(Nginx伪静态的支持)
后台维护、流量转发等。
安全(动态界面进行伪装)。
rewrite语法
语法 rewrite regex replacement [flag];
默认 -
应用位置 server,location,if
例子:
rewrite ^(.*) http://wanger.com/$1 permanent;
如果()里的正则表达式与请求的URI匹配,那么URI将根据replacement字符串中的指定进行更改,匹配成功将跳转到http://wanger.com/$1 ,$1的值是前面()里的正则匹配到的值,而后面的permanent是永久重定向301的标志,当rewrite 后面没有任何 flag 时就顺序执行
可选flag参数可以是以下之一: flag标记 说明 last 本条规则匹配完成后继续匹配新的URI规则 break 本条规则匹配完成后不在进行新的URI匹配 redirect 302临时重定向,浏览器会显示跳转后的URL地址,当nginx 服务关闭的时候,将无法定向到特定的网站 permanent 301永久重定向,浏览器会显示跳转后的URL地址,除非客户端清理浏览器缓存 last与break的区别 last 和 break一样 它们都会终止此 location 中其他它rewrite模块指令的执行,last会重新将rewrite后的地址作为一个新的URI在server块中请求,而break会直接请求重写后的地址,并不会再进行新的请求
举个例子: location ~ ^/break { rewrite ^/break /test/ break; } location ~ ^/last { rewrite ^/last /test/ last; } location /test/ { default_type application/json; return 200 '{"status":"success"}'; } 当我请求127.0.0.1/break时,浏览器返回的是404,因为break不会去请求/test/块,而网站根目录下test目录根本不存在,当我请求127.0.0.1/last时,浏览器返回的是{"status":"success"},因为last将地址重写后生成了新的请求,新的请求地址为/test/,然后与/test/块进行匹配,返回200状态码以及{"status":"success"}
set 用于定义一个变量,变量的值可以包含文本,变量或者是它们的组合形式。
set语法 语法 set $variable value; 默认 - 应用位置 server,location,if 例子 location /wanger { # return 302 http://60.205.177.168/huazai; root html; index index.html; set $var1 "client address is "; set $var2 $remote_addr; return 200 "$var1$var2"; } 效果如下: curl 127.0.0.1/wanger client address is 127.0.0.1 rewrite的一些实例 if ($host = "wanger.com"){ rewrite ^/(.)$ http://www.wanger.com/$1 permanent; } if (!-f $request_filename) { rewrite ^/(.) http://www.wanger.com/index.html; } if (!-e $request_filename) { rewrite ^/(.*)$ /index.php?$1 last; }