Nginx学习之Rewrite(3)

140 阅读3分钟

Nginx学习之Rewrite(3)

本笔记是参考《黑马程序员Nginx教程》总结,供学习查阅

1.介绍

主要的作用是用来实现URL的重写。

注意:Nginx服务器的Rewrite功能的实现依赖于PCRE的支持,因此在编译安装Nginx服务器之前,需要安装PCRE库。Nginx使用的是ngx_http_rewrite_module模块来解析和处理Rewrite功能的相关配置。

重写与转发区别

  • 地址重写浏览器地址会发生变化而地址转发则不变
  • 一次地址重写会产生两次请求而一次地址转发只会产生一次请求
  • 地址重写到的页面必须是一个完整的路径而地址转发则不需要
  • 地址重写因为是两次请求所以request范围内属性不能传递给新页面而地,址转发因为是一次请求所以可以传递值
  • 地址转发速度快于地址重写

2.相关指令

2.1 set指令

该指令用来设置一个新的变量。

语法set $variable value;
默认值
位置server、location、if

variable:变量的名称,该变量名称要用"$"作为变量的第一个字符,且不能与Nginx服务器预设的全局变量同名。 value:变量的值,可以是字符串、其他变量或者变量的组合等。

2.2 if 指令

该指令用来支持条件判断,并根据条件判断结果选择不同的Nginx配置。

语法if (condition){...}
默认值
位置server、location

condition为判定条件,可以支持以下写法

  1. 变量名。如果变量名对应的值为空或者是0,if都判断为false,其他条件为true。
if ($param){
}
  1. 使用"="和"!="比较变量和字符串是否相等,满足条件为true,不满足为false
if ($request_method = POST){
	return 405;
}

注意:此处和Java不太一样的地方是字符串不需要添加引号

3.使用正则表达式对变量进行匹配,匹配成功返回true,否则返回false。变量与正则表达式之间使用"","","!","!"来连接

""代表匹配正则表达式过程中区分大小写, ""代表匹配正则表达式过程中不区分大小写 "!~"和"!~"刚好和上面取相反值,如果匹配上返回false,匹配不上返回true

更多请参考官网

2.3 break指令

该指令用于中断当前相同作用域中的其他Nginx配置。与该指令处于同一作用域的Nginx配置中,位于它前面的指令配置生效,位于后面的指令配置无效。

语法break;
默认值
位置server、location、if
location /{
	if ($param){
		set $id $1;
		break;
    	limit_rate 10k;
    }
}

2.4 return指令

该指令用于完成对请求的处理,直接向客户端返回响应状态代码。在return后的所有Nginx配置都是无效的。

语法return code [text]; return code URL; return URL;
默认值
位置server、location、if

code:为返回给客户端的HTTP状态代理。可以返回的状态代码为0~999的任意HTTP状态代理

text:为返回给客户端的响应体内容,支持变量的使用

URL:为返回给客户端的URL地址

2.5 rewrite指令

该指令通过正则表达式的使用来改变URI。可以同时存在一个或者多个指令,按照顺序依次对URL进行匹配和处理。

语法rewrite regex replacement [flag];
默认值
位置server、location、if

2.6 rewrite_log指令

该指令配置是否开启URL重写日志的输出功能。

语法rewrite_log on|off;
默认值rewrite_log off;
位置http、server、location、if

开启后,URL重写的相关日志将以notice级别输出到error_log指令配置的日志文件汇总。

3.常用全局变量

变量说明
$args变量中存放了请求URL中的请求指令。比如htt p://192.168.200.133:8080?arg1=value1&arg s2=value2中 的"arg1=value1&arg2=value2",功能和 $query_string一样
$http_user_agent变量存储的是用户访问服务的代理信息(如果 通过浏览器访问,记录的是浏览器的相关版本 信息)
$host变量存储的是访问服务器的server_name值
$document_uri变量存储的是当前访问地址的URI。比如htt p://192.168.200.133/server?id=10&name=z hangsan中的"/server",功能和$uri一样
$document_root变量存储的是当前请求对应location的root 值,如果未设置,默认指向Nginx自带html目 录所在位置
$content_length变量存储的是请求头中的Content-Length的 值
$content_type变量存储的是请求头中的Content-Type的值
$http_cookie变量存储的是客户端的cookie信息,可以通过 add_header Set-Cookie 'cookieName=cookieValue'来添加cookie数 据
变量说明
$limit_rate变量中存储的是Nginx服务器对网络连接速率 的限制,也就是Nginx配置中对limit_rate指令 设置的值,默认是0,不限制。
$remote_addr变量中存储的是客户端的IP地址
$remote_port变量中存储了客户端与服务端建立连接的端口 号
$remote_user变量中存储了客户端的用户名,需要有认证模 块才能获取
$scheme变量中存储了访问协议
$server_addr变量中存储了服务端的地址
$server_name变量中存储了客户端请求到达的服务器的名称
$server_port变量中存储了客户端请求到达服务器的端口号
$server_protocol变量中存储了客户端请求协议的版本,比 如"HTTP/1.1"
$request_body_file变量中存储了发给后端服务器的本地文件资源 的名称
$request_method变量中存储了客户端的请求方式,比 如"GET","POST"等
$request_filename变量中存储了当前请求的资源文件的路径名
$request_uri变量中存储了当前请求的URI,并且携带请求 参数,比如http://192.168.200.133/server?id =10&name=zhangsan中的"/server? id=10&name=zhangsan"

4.案例

域名跳转 、域名镜像 、独立域名 、防盗链 等