Rewrite主要的功能是实现URL重写,Nginx 的 Rewrite 规则采用 PCRE Perl 兼容正则表达式的语法进行规则匹配,如相使用 Nginx 的 Rewrite 功能,在编译 Nginx 前要编译安装 PCRE 库。
一,Nginx使用if进行条件匹配
Nginx可以用if进行条件匹配,语法规则类似C
if (条件){...} ( 可用于: server,location ) ## 检查一个条件是否符合,如果条件符合,则执行大括号内的语句。不支持嵌套,不支持多条件 && ||
例如:if ($http_user_agent ~ MSIE) {rewrite ^(.*)$ /msie/$1 break;}
1、正则表达式匹配,其中:
~ 为区分大小写匹配
~* 为不区分大小写匹配
!~和!~*分别为区分大小写不匹配及不区分大小写不匹配
2、文件及目录匹配,其中:
-f和!-f用来判断是否存在文件
-d和!-d用来判断是否存在目录
-e和!-e用来判断是否存在文件或目录
-x和!-x用来判断文件是否可执行
例如:if (!-f $request_filename) {proxy_pass http://127.0.0.1;}
Wordpress的重定向规则:if (!-e $request_filename) {rewrite ^/(index|atom|rsd)\.xml$ http://feed.shunz.net last;rewrite ^([_0-9a-zA-Z-]+)?(/wp-.*) $2 last;rewrite ^([_0-9a-zA-Z-]+)?(/.*\.php)$ $2 last;rewrite ^ /index.php last;}
return ( 可用于: server,location,if ) ## 用于结束规则的执行并反回状态码给客户端。 状态码可以是 :204/400/402~406/408/410/411/413/416/500~504
如:location ~ .*\.(sh|bash)?$ { return 403; } ## 访问的 URL 以 .sh .bash 结尾的,则返回 403 。204 No Content 400 Bad Request 402 Payment Required 403 Forbidden 404 Not Found 405 Method Not Allowed 406 Not Acceptable 408 Request Timeout 410 Gone 411 Length Required 413 Request Entity Too Large 416 Requested Range Not Satisfiable 500 Internal Server Error 501 Not Implemented 502 Bad Gateway 503 Service Unavailable 504 Gateway Timeout
二,Nginx使用rewrite
rewrite ( 可用于: server,location,if ) ## 重写 URL ,或修改字符串。重写 URL 只对相对路径有效,如想对主机名,要使用 if 语句。
例1:if ($host ~* www\.(.*)) { set $host_without_www $1; rewrite ^(.*)$ http://$host_without_www$1 permanent; } ## 如果替换串以 http:// 开头,将会采用 301 或 302 跳转进行 URL 重定向。 例2:rewrite ^/feed/$ http://feed.shunz.net last;
Nginx的Rewrite规则与Apache几乎完全一致,所不同的是最后的flag标记,Nginx的rewrite指令后支持的标记有last,break,redirect,permanent
last 相当于Apache里的[L]标记,表示完成rewrite,不再匹配后面的规则
break ( 可用于: server,location,if ) ## 本条规则匹配完成后,终止匹配,不再匹配后面的规则
如:rewrite ^/b/(.*)\.html /play.php?video=$1 break;
redirect 返回302临时重定向,浏览器会显示跳转后的URL地址
permanent 返回301永久重定向,浏览器会显示跳转后的URL地址
last/break用来实现URL重写,浏览器地址栏的URL不变,但在服务器端访问的路径发生了变化。
redirect/permanent实现URL跳转,浏览器地址栏URL会显示跳转后的URL。
使用 alias 指令时必须用 last 标记 ,使用 proxy_pass 指令时要用 break 表示。last 标记在本条 rewrite 规则执行完毕后,会对其所在 server{....}标签重新发起请求,而 break 标记则在本条规则匹配完成后,终止匹配。
如:location /cms/ { proxy_pass http://test.abc.com; rewrite "^/cms/(.*)\.html$" /cms/index.html break; } ## 这条规则如果使用 last 会导致死循环。 ## 一般在根 location 中(即 location / {....})或直接在 server 标签编写 rewrite 规则,推荐使用 last 标记, 在非根 location 中 (即 location /cms/ {...}),则使用 break 标记。
Nginx $document_uri参数的使用
$document_uri 表示访问的url 现在我的需求是,访问 www.abc.com 请求到 www.abc.com/abc/
在nginx配置文件中加入
if ($document_uri !~ 'abc')
{
rewrite ^/(.*)$ http://www.abc.com/abc/$1 permanent;
}
而不是单独加一句 rewrite ^/(.*)$ http://www.abc.com/abc/$1 permanent;
如果只加rewrite 规则,而不限定条件,那么会造成死循环。 会访问到 http://www.abc.com/abc/abc/abc/abc/....