nginx的轉(zhuǎn)發(fā)模塊ngx_http_rewrite_module包含以下指令:
break
if
return
rewrite
rewrite_log
set
uninitialized_variable_warn
break
break指令用來(lái)停止當(dāng)前的ngx_http_rewrite_module指令集合(current set of ngx_http_rewrite_module directives)噪矛。
比如：
if ($slow) {
limit_rate 10k;
break;
}
if
條件判斷，如果滿足條件取募，括號(hào)內(nèi)的指令將被執(zhí)行获搏。條件可以為：
變量名：true or false
比較運(yùn)算： = or !=
正則表達(dá)式： ~(區(qū)分大小寫匹配case-sensitive matching)or ~*(不區(qū)分大小寫匹配case-insensitive matching)
-f: 判斷文件是否存在
-d：判斷文件休溶，文件夾，符號(hào)連接是否存在
-x: 檢查文件是否可執(zhí)行
例如：
if ($http_user_agent ~ MSIE) {
rewrite ^(.*)$ /msie/$1 break;
}
if ($http_cookie ~* "id=([^;]+)(?:;|$)") {
set $id $1;
}
if ($request_method = POST) {
return 405;
}
if ($slow) {
limit_rate 10k;
}
if ($invalid_referer) {
return 403;
}
return
停止處理并發(fā)揮特殊的http code 給客戶端。
return (301 | 302 | 303 | 307) url;
return (1xx | 2xx | 4xx | 5xx) ["text"];
rewrite
rewrite regex URL [flag];
如果請(qǐng)求的URI滿足regex未妹，則URI被替換。如果替換的URI是http或https開頭空入，則停止以后處理并返回給客戶端络它。
flag的可選值為：
last:停止當(dāng)前的ngx_http_rewrite_module指令并以替換的URI來(lái)查找新的location。
break:停止當(dāng)前的ngx_http_rewrite_module指令****集合****歪赢。
redirect:返回302.
permanent:返回永久的轉(zhuǎn)發(fā):301 code.
注意：last指令會(huì)重新查找新的location,而break會(huì)跳出當(dāng)前的location or if direct化戳。
因此，當(dāng)使用于location內(nèi)部中時(shí)，last會(huì)跳出后重新匹配点楼。
location /download/ {
rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 break;
rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra break;
return 403;
}
假如你訪問URL:/download/a/media/a.mp3扫尖。
上面將匹配：/download/a/mp3/a.mp3。
如果掠廓，將break更換為last:
location /download/ {
rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 last;
rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra last;
return 403;
}
那么過程就變成了：
/download/a/media/a.mp3-->/download/a/mp3/a.mp3-->
/download/a/mp3/a.mp3-->403
set
設(shè)置變量换怖。eg:
set $is_mobile "pc";
if ( $http_user_agent ~* "(Android|iPhone|iPod|Symbian|IEMobile|BlackBerry)"){
set $is_mobile "mobile";
}
應(yīng)用
例子來(lái)自于:nginx blog:
server {
listen 80;
server_name www.old-name.com old-name.com;
return 301 $scheme://www.new-name.com$request_uri;
#return 301 $scheme://www.new-name.conm;
#rewrite ^ $scheme://www.new-name.com$request_uri permanent;
#rewrite ^/(.*)$ $scheme://www.new-name.com/$1 permanent;
}
add or remove www
# add 'www'
server {
listen 80;
listen 443 ssl;
server_name domain.com;
return 301 $scheme://www.domain.com$request_uri;
#rewrite ^(.*)$ $scheme://www.domain.com$1 permanent;
}
# remove 'www'
server {
listen 80;
listen 443 ssl;
server_name www.domain.com;
return 301 $scheme://domain.com$request_uri;
}
默認(rèn)轉(zhuǎn)發(fā)：
server {
listen 80 default_server;
listen 443 ssl default_server;
server_name _;
return 301 $scheme://www.domain.com;
}
強(qiáng)制HTTPS：
server {
listen 80;
server_name www.domain.com;
return 301 https://www.domain.com$request_uri;
}
或者:
# NOT RECOMMENDED
if ($scheme != "https") {
rewrite ^ https://www.mydomain.com$uri permanent;
}
這種，需要額外處理蟀瞧，不推薦使用沉颂。
location / {
try_files $uri $uri/ /index.php?$args;
}
移除不支持文件：
location ~ \.(aspx|php|jsp|cgi)$ {
return 410;
#deny all;
}
自定義路由：
rewrite ^/listings/(.*)$ /listing.html?listing=$1 last;
微信公眾賬號(hào)：myersguo
參考資料
https://www.nginx.com/blog/creating-nginx-rewrite-rules/
http://nginx.org/en/docs/http/ngx_http_rewrite_module.html
