Nginx中指令

Rewrite模块

1 return指令

Syntax:	return code [text];
		return code URL;
		return URL;
Default:	—
Context:	server, location, if

返回状态码

• nginx自定义
  • 444：关闭连接
• HTTP1.0标准
  • 301：http1.0永久重定向
  • 302：临时重定向，禁止被缓存
• HTTP1.1标准
  • 303：临时重定向，允许改变方法，禁止被缓存
  • 307：临时重定向，不允许改变方式，禁止被缓存
  • 308：永久重定向，不允许改变方法

示例

server {
    server_name wiki.clay-wangzhi.com;
    listen 8080;

    root html/;
    error_page 404/403.html;
    return 403;
    location / {
        return 404 "find nothing!";
    }
}

return指令与errror_page

2 rewrite指令

Syntax:	rewrite regex replacement [flag];
Default:	—
Context:	server, location, if

功能

• 将regex指定的url替换成replacement这个新的url

  可以使用正则表达式及变量提取

• 当replacement以http://或者https://或者$schema开头，则直接返回302重定向

• 替换后的url根据flag指定的方式进行处理

  如果在同一级配置块中存在多个rewrite规则，那么会自下而下逐个检查；被某条件规则替换完成后，会重新一轮的替换检查，因此，隐含有循环机制；[flag]所表示的标志位用于控制此循环机制；

  • last：

    • 浏览器地址栏URL地址不变
    • 用replacement这个URI进行新的location匹配，重写完成后停止对当前URI在当前location中后续的其它重写操作，而后对新的URI启动新一轮重写检查；提前重启新一轮循环；

  • beak：

    • 浏览器地址栏URL地址不变
    • break指令停止当前脚本指令的执行，等价于独立的break指令,重写完成后停止对当前URI在当前location中后续的其它重写操作，而后直接跳转至重写规则配置块之后的其它配置；结束循环；

  • redirect：

    • 浏览器地址会显示跳转后的URL地址
    • 返回302临时重定向，

  • permanent：

    • 浏览器地址会显示跳转后的URL地址
    • 返回301永久重定向

功能一句话概括为：使用nginx提供的全局变量或自己设置的变量，结合正则表达式和标志位实现url重写以及重定向。

示例1

        root html/;
        location /first {
            rewrite /first(.*) /second$1 last;
            return 200 'first!';
        }

        location /second {
            rewrite /second(.*) /third$1 break;
            return 200 'second!';
        }

        location /third {
            return 200 'third!';
        }

访问/first/1.txt的结果为：html/third/1.txt的内容

访问/second/1.txt的结果为：html/third/1.txt的内容

访问/third/1.txt的结果为：third的内容

示例2

# http://www.test.com/test/abc/1.html ⇒ http://www.test.com/ccc/bbb/2.html
location /test {
    rewrite .* /ccc/bbb/2.html permanent;
}

# http://www.test.com/2015/ccc/bbb/2.html ==> http://www.test.com/2014/ccc/bbb/2.html
location /2015 {
    rewrite ^/2015/(.*)$ /2014/$1 permanent;
}

# http://www.test.com/2015/ccc/bbb/2.html  ==> http://jd.com/index.php
location /2015 {
    if ($host ~* test.com) {
        rewrite .* http://www.jd.com/index.php permanent;
    }
}

# http://www.test.com/kkk/1.html ==> http://jd.com/kkk/1.html
location / {
    root html;
    index index.html index.htm;
    if ($host ~* test.com) {
        rewrite .* http://www.jd.com/$request_uri permanent;
    }
}

# 有时候在访问一个二级子目录时会出现目录后的/无法补齐，如：
#  elinks --dump www.test.com/www  无法访问
#  elinks --dump www.test.com/www/可以访问
if (-d $request_filename) {
    rewrite ^(.*)([^/])$ http://$host$1$2/ permanent;
}
# ^/(.*)([^/])$表示以/符号开始并紧跟着任何字符，同时不是以/为结束的字符串，在我的url中，(.*)表示的ww，([^/])表示的w

# http://www.test.com/login/robin.html     ==>  http://www.test.com/reg/login.php?user=robin
location /login {
    rewrite ^/login/(.*)\.html$ /reg/login.php?user=$1 permanent;
}

# http://www.test.com/uplook/10-10-10.html  ==>  http://www.test.com/uplook/10/10/10.html
location /uplook {
    rewrite ^/uplook/([0-9]+)-([0-9]+)-([0-9]+)\.html$ /uplook/$1/$2/$3.html permanent;
}

# set 指令是用于定义一个变量，并且赋值。应用于server,location,if环境。
# http://robin.test.com ==> http://www.test.com/robin
# http://zorro.test.com ==> http://www.test.com/zorro
if ($host ~* "^www.test.com$") {
    break;
}
if ($host ~* "^(.*)\.test\.com$") {
    set $user $1;
    rewrite .* http://www.test.com/$user permanent;
}

last 一般写在server和if中，而break一般使用在location中

3 if指令

Syntax:	if (condition) { ... }
Default:	—
Context:	server, location

规则：条件condition为真，则执行大括号内的指令；遵循值指令的继承规则

if指令的条件表达式

• 检查变量为空或者值是否为0，直接使用
  • 当表达式只是一个变量时，如果值为空或任何以 0 开头的字符串都会当做 false
• 将变量与字符串做匹配，使用=或者!=
• 将变量与正则表达式做匹配
  • 大小写敏感，_或者!
  • 大小写不敏感，_*或者!*
• 检查文件是否存在，使用-f或者!-f
• 检查目录是否存在，使用-d或者!-d
• 检查文件、目录、软连接是否存在，使用-e或者!-e
• 检查是否为可执行文件，使用-x或者!-x

示例

if ($http_user_agent ~ MSIE) {
    rewrite ^(.*)$ /msie/$1 break;
}
if ($http_cookie ~* "id=([^;]+)(?:;|$)") {
    set $id $1;
}
if ($repuest_method = POST) {
    return 405;
}
if ($slow) {
    limit_rate 10k;
}
if ($invalid_referer) {
    return 403;
}

4 rewrite_log指令

Syntax: rewrite_log on | off;
Default:    rewrite_log off;
Context:    http, server, location, if