Nginx Rewrite

break

语法:break

作用域:server,location,if
Example:

if ($slow) {
   limit_rate 10k;
   break;
}

if

语法:if ( condition ) { … }

作用域:server,location

条件可以是:

  • 变量,空字符串或”0″为false
  • 使用=或!=运算符的比较变量
  • 使用正则匹配
  • ~ 为区分大小写匹配
  • ~* 为不区分大小写匹配
  • !~和!~*分别为区分大小写不匹配及不区分大小写不匹配
  • -f和!-f 判断是否存在文件
  • -d和!-d 判断是否存在目录
  • -e和!-e 判断是否存在文件或目录
  • -x和!-x 判断文件是否可执行

正则匹配到的值可以在之后使用$1-$9访问

Examples of use:

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;
}

if ($args ~ post=140){
rewrite ^ http://example.com/ permanent;
}

return

语法:
return code [ text ]
return code URL
return URL
作用域:server,location,if

rewrite

语法:rewrite regex replacement [ flag ]

作用域:server,location,if

flag标记有:

  • last 相当于Apache里的[L]标记,表示完成rewrite
  • break 终止匹配, 不再匹配后面的规则
  • redirect 返回302临时重定向 地址栏会显示跳转后的地址
  • permanent 返回301永久重定向 地址栏会显示跳转后的地址
    Example:
rewrite "/photos/([0-9]{2})([0-9]{2})([0-9]{2})" /path/to/photos/$1/$1$2/$1$2$3.png;
server {
server_name www.example.com;
rewrite ^ http://example.com$request_uri? permanent;
}

rewrite_log

语法:
rewrite_log on | off
default: rewrite_log off
作用域:
http, server, if-in-server, location, if-in-location

附:Rewrite可能使用到的全局变量

$args  此变量与请求行中的参数相等
$content_length 等于请求行的“Content_Length”的值。
$content_type 等同与请求头部的”Content_Type”的值
$document_root 等同于当前请求的root指令指定的值
$document_uri 与$uri一样
$host 与请求头部中“Host”行指定的值或是request到达的server的名字(没有Host行)一样
$limit_rate 允许限制的连接速率
$request_method 等同于request的method,通常是“GET”或“POST”
$remote_addr 客户端ip
$remote_port 客户端port
$remote_user 等同于用户名,由ngx_http_auth_basic_module认证
$request_filename 当前请求的文件的路径名,由root或alias和URI request组合而成
$request_body_file
$request_uri 含有参数的完整的初始URI
$query_string 与$args一样
$server_protocol 等同于request的协议,使用“HTTP/1.0”或“HTTP/1.1”
$server_addr request到达的server的ip,一般获得此变量的值的目的是进行系统调用。为了避免系统调用,有必要在listen指令中指明ip,并使用bind参数。
$server_name 请求到达的服务器名
$server_port 请求到达的服务器的端口号
$uri 等同于当前request中的URI,可不同于初始值,例如内部重定向时或使用index

参考:http://wiki.nginx.org/HttpRewriteModule