nginx配置url重定向_Nginx rewrite重定向配置详解

访问重写 rewrite 是 Nginx HTTP 请求处理过程中的一个重要功能,它是以模块的形式存在于代码中的,其功能是对用户请求的 URI 进行 PCRE 正则重写,然后返回 30× 重定向跳转或按条件执行相关配置。

rewrite 模块内置了类似脚本语言的 set、if、break、return 配置指令,通过这些指令,用户可以在 HTTP 请求处理过程中对 URI 进行更灵活的操作控制。rewrite 模块提供的指令可以分两类,一类是标准配置指令,这部分指令只是对指定的操作进行相应的操作控制;另一类是脚本指令,这部分指令可以在 HTTP 指令域内以类似脚本编程的形式进行编写。

1、标准配置指令

常用的标准配置指令如下面表格所示。

表:rewrite 日志记录指令

名称

rewrite 日志记录指令

指令

rewrite_log

作用域

http, server, location

默认值

off

指令值选项

on 或 off

指令说明

当指令值为 on 时,rewrite 的执行结果会以 notice 级别记录到 Nginx 的 error 日志文件中

配置样例如下:

http {

rewrite_log off;

}

表:未初始化变量告警日志记录指令

名称

未初始化变量告警日志记录指令

指令

uninitialized_variable_warn

作用域

http, server, location

默认值

on

指令值选项

on 或 off

指令说明

指令值为 on 时,会将未初始化的变量告警记录到日志中

配置样例如下:

http {

uninitialized_variable_warn off;

}

表:rewrite 指令

名称

rewrite 指令

指令

rewrite

作用域

server, location

默认值

on

指令值选项

on 或 off

指令说明

对用户的 URI 用正则表达式的方式进行重写,并跳转到新的 URI

配置样例如下:

http {

rewrite ^/users/(.*)$ /show?user=$1 last;

}

rewrite 访问重写是通过 rewrite 指令实现的,rewrite 指令的语法格式如下:

rewrite regex replacement [flag];

1) regex 是 PCRE 语法格式的正则表达式。

2) replacement 是重写 URI 的改写规则。当改写规则以“http://”“https://”或“$scheme”开头时,Nginx 重写该语句后将停止执行后续任务,并将改写后的 URI 跳转返回客户端。

3) flag 是执行该条重写指令后的操作控制符。操作控制符有如下 4 种:

last:执行完当前重写规则跳转到新的 URI 后继续执行后续操作;

break:执行完当前重写规则跳转到新的 URI 后不再执行后续操作。不影响用户浏览器 URI 显示;

redirect:返回响应状态码 302 的临时重定向,返回内容是重定向 URI 的内容,但浏览器网址仍为请求时的 URI;

permanent:返回响应状态码 301 的永久重定向,返回内容是重定向 URI 的内容,浏览器网址变为重定向的 URI。

2、脚本指令

常见的脚本指令如下面表格所示。

表:设置变量指令

名称

设置变量指令

指令

set

作用域

server, location, if

指令说明

set 指令,可以用来定义变量

配置样例如下:

http {

server{

set $test "check";

}

}

http{

server {

listen 8080;

location /foo {

set $a hello;

rewrite ^ /bar;

}

location /bar {

# 如果这个请求来自“/foo”,$a的值是“hello”。如果直接访问“/bar”,$a的值为空

echo “a = [$a]”;

}

}

}

用 set 指令创建变量后,变量名是 Nginx 配置全局域可用的,但变量值只在有该变量赋值操作的 HTTP 处理流程中可用。

http{

server {

listen 8080;

location /foo {

set $a hello;

rewrite ^ /bar;

}

location /bar {

# 如果这个请求来自“/foo”,$a的值是“hello”。如果直接访问“/bar”,$a的值为空

if ( $a = “hello” ){

rewrite ^ /newbar;

}

}

}

}

当 set 指令后只有变量名时,系统会自动创建该变量,变量值为空。

http {

server{

set $test;

}

}

变量插值如下:

http {

server{

set $test "check ";

if ( "${test}nginx" = "nginx" ){ #${test}nginx的值为"check nginx"

}

}

}

表:条件判断指令

名称

条件判断指令

指令

if

作用域

server, location

指令说明

条件判断指令

配置样例如下:

http {

server {

if ($http_cookie ~* "id=([^;]+)(?:;|$)") {

set $id $1;

}

}

}

1) 当判断条件为一个变量时,变量值为空或以 0 开头的字符串都被判断为 false。

2) 变量内容字符串比较操作运算符为“=”或“!=”。

3) 进行正则表达式比较时,有以下 4 个操作运算符:

“~”:区分大小写匹配;

“~*”:不区分大小写匹配;

“!~”:区分大小写不匹配;

“!~*”:不区分大小写不匹配。

4) 进行文件或目录比较时,有以下 4 个操作运算符:

“-f”:判断文件是否存在,可在运算符前加“!”表示反向判断。

“-d”:判断目录是否存在,可在运算符前加“!”表示反向判断。

“-e”:判断文件、目录或链接符号是否存在,可在运算符前加“!”表示反向判断。

“-x”:判断文件是否为可执行文件,可在运算符前加“!”表示反向判断。

表:终止指令

名称

终止指令

指令

break

作用域

server, location, if

指令说明

终止后续指令的执行

配置样例如下:

http {

server {

if ($slow) {

limit_rate 10k;

break;

}

}

}

表:跳转指令

名称

跳转指令

指令

return

作用域

server, location, if

指令说明

向客户端返回响应状态码或执行跳转

配置样例如下:

http {

server {

if ($request_method = POST) {

return 405;

}

}

}

1) return 的指令值有以下 4 种方式。

return code:向客户端返回指定 code 的状态码,当返回非标准的状态码 444 时,Nginx 直接关闭连接,不发送响应头信息。

return code text:向客户端发送带有指定 code 状态码和 text 内容的响应信息。因要在客户端显示 text 内容,所以 code 不能是 30×。

return code URL:这里的 URL 可以是内部跳转或变量 $uri,也可以是有完整 scheme 标识的 URL,将直接返回给客户端执行跳转,code 只能是 30×。

return URL:此时默认 code 为 302,URL 必须是有完整 scheme 标识的 URL。

2) return 也可以用来调试输出 Nginx 的变量。

你可能感兴趣的:(nginx配置url重定向)