[置顶] linux Nginx配置篇:rewrite模块参数详解
2017-08-04 13:13
417 查看
nginx官方用户手册:http://nginx.org/en/docs/http/ngx_http_rewrite_module.html
rewrite和location的功能有点相像,都能实现跳转,主要区别在于rewrite常用于同一域名内更改获取资源的路径,而location是对一类路径做控制访问和反向代理,可以proxy_pass到其他服务器,在此说明下rewrite和location的执行先后顺序:
1.执行server块中的rewrite;
2.执行location;
3.执行location中的rewrite;
如果其中某步url被重写,则重新循环执行2-3步,直到找到按该url可以访问的文件,循环次数不超过10。
rewrite模块包含的指令有break,if,return,rewrite,rewrite_log,set等,还有另外两个指令uninitialized_variable_warn和Internal Implementation,用的比较少,可能我还没理解他们的用途,在此不做说明。下面一一说明常用指令的用处和用法。
1. break
参数项:break,用于停止执行rewrite模块的指令,但是其他模块不受影响。
配置位置:server,location,if
示例:
测试链接:http://192.168.88.38/breaktest ,请求到达server块后,被break终止执行rewrite指令集,return属于rewrite模块指令
4000
集,所以return
200 “this is breaktest...”不会执行;因为没有返回结果,所以继续执行location匹配,请求匹配到location = /breaktest{}之后,break终止return 200 $request_uri,而proxy_pass属于ngx_http_proxy_module,仍会继续执行,反向代理后的新url匹配到location
/{},因此最终返回结果为 http200,/other,如下图:
2.set
配置位置:server,location,if,用于为变量赋值
示例:
测试链接http://192.168.88.38/breaktest,使用效果如下图:
3.if
配置位置:server,location,用于依据指定的条件,决定是否执行if块中的语句
判断条件:
3.1.变量值为空或为0,都为false;
示例:
3.2.变量与字符串比较,=为等于,!=为不等
3.3.变量与正则表达式匹配,~为区分大小写匹配,~*为不区分大小写匹配,!~,!~*前面两者的非操作
示例:
3.4.检查文件是否存在,-f存在即为true,!-f不存在即为true
3.5.检查目录是否存在,-d存在即为true,!-d不存在即为true
3.6.检查文件或目录是否存在,-e存在即为true,!-e不存在即为true
3.7.检查文件是否可执行,-x可执行即为true,!-x不可执行即为true
示例:
4.return
配置位置:server,location,if
参数值:return code [text]返回状态码及文本、return url重定向、return code url重定向
5.rewrite
配置位置:server,location,if
参数值:rewrite regex replacement [flag],用于以正则表达式匹配特定格式的url并重写url.
regex为正则表达式,replacement为重写的内容,flag为rewrite的标识位
replacement:重写的url带http,表示重定向
示例:
replacement:重写的url不带http,单纯的重写url
示例:
flag:用于设置重写url后的进一步操作,有break,last,redirect,permanent,rewrite不带flag时,多个rewrite指令顺序执行,当location中没有可执行的rewrite模块指令时,重新发起一次location匹配,下面说明各个flag的用途:
示例:
last和break的区别在于,last会发起新的location匹配,而break不会。
示例:
测试链接:http://192.168.88.38/test1 匹配到 location / {}后,被重写为/test2,顺序执行再次被重写为/test3,因为flag为last,所以不会继续重写为/test4,而是发起一次location匹配,匹配到location
/test3{},所以最终返回结果为http200及/test3;
如果把location /{}中的last改为break,被重写为/test3后,不再重写为/test4,也不会发起location,最终没有可匹配的资源,返回http404。
6.正则匹配URL的参数传递
小括号()之间匹配的内容,可以在后面通过 $下标 来引用,如$1表示引用第一个小括号匹配的内容,$表示引用第二个小括号匹配的内容。
示例:
最终返回结果:
附nginx内置全局变量:
rewrite和location的功能有点相像,都能实现跳转,主要区别在于rewrite常用于同一域名内更改获取资源的路径,而location是对一类路径做控制访问和反向代理,可以proxy_pass到其他服务器,在此说明下rewrite和location的执行先后顺序:
1.执行server块中的rewrite;
2.执行location;
3.执行location中的rewrite;
如果其中某步url被重写,则重新循环执行2-3步,直到找到按该url可以访问的文件,循环次数不超过10。
rewrite模块包含的指令有break,if,return,rewrite,rewrite_log,set等,还有另外两个指令uninitialized_variable_warn和Internal Implementation,用的比较少,可能我还没理解他们的用途,在此不做说明。下面一一说明常用指令的用处和用法。
1. break
参数项:break,用于停止执行rewrite模块的指令,但是其他模块不受影响。
配置位置:server,location,if
示例:
server { listen 80; server_name localhost; #===== break && rewrite test ===== #这里如果注释掉break,所有请求进来都是返回http200,this is breaktest... break; return 200 "this is breaktest..."; location = /breaktest { break; return 200 $request_uri; proxy_pass http://192.168.88.38/other; } location / { return 200 $request_uri; }
测试链接:http://192.168.88.38/breaktest ,请求到达server块后,被break终止执行rewrite指令集,return属于rewrite模块指令
4000
集,所以return
200 “this is breaktest...”不会执行;因为没有返回结果,所以继续执行location匹配,请求匹配到location = /breaktest{}之后,break终止return 200 $request_uri,而proxy_pass属于ngx_http_proxy_module,仍会继续执行,反向代理后的新url匹配到location
/{},因此最终返回结果为 http200,/other,如下图:
2.set
配置位置:server,location,if,用于为变量赋值
示例:
server { listen 80; server_name localhost; #===== break && rewrite test ===== #这里如果注释掉break,所有请求进来都是返回http200,this is breaktest... break; return 200 "this is breaktest..."; location = /breaktest { break; return 200 $request_uri; proxy_pass http://192.168.88.38/other; } location / { #set赋值,可以直接赋字符串,或是变量,如下是变量和字符串的组合 set $set_value_test “112233 $request_uri”; return 200 $set_value_test; }
测试链接http://192.168.88.38/breaktest,使用效果如下图:
3.if
配置位置:server,location,用于依据指定的条件,决定是否执行if块中的语句
判断条件:
3.1.变量值为空或为0,都为false;
示例:
set $if_value_test “0”; #注意这里if、()和{}要空格,否则会报错..略坑,不过这也是代码规范了 if ($if_value_test) { #不会执行,因为$if_value_test值为0,false return 200; }
3.2.变量与字符串比较,=为等于,!=为不等
3.3.变量与正则表达式匹配,~为区分大小写匹配,~*为不区分大小写匹配,!~,!~*前面两者的非操作
示例:
if ($request_uri ~ “^/breaktest$”) { #测试链接http://192.168.88.38/breaktest,最终返回http200 return 200; }
3.4.检查文件是否存在,-f存在即为true,!-f不存在即为true
3.5.检查目录是否存在,-d存在即为true,!-d不存在即为true
3.6.检查文件或目录是否存在,-e存在即为true,!-e不存在即为true
3.7.检查文件是否可执行,-x可执行即为true,!-x不可执行即为true
示例:
if (-e /usr/local/nginx/conf) { return 200; }
4.return
配置位置:server,location,if
参数值:return code [text]返回状态码及文本、return url重定向、return code url重定向
5.rewrite
配置位置:server,location,if
参数值:rewrite regex replacement [flag],用于以正则表达式匹配特定格式的url并重写url.
regex为正则表达式,replacement为重写的内容,flag为rewrite的标识位
replacement:重写的url带http,表示重定向
示例:
location / { #测试链接http://192.168.88.38/test/,被重定向到百度首页,后面的语句不会再执行 rewrite /test/(.*) http://www.baidu.com; set $set_value_test "112233 $request_uri"; return 200 $set_value_test; }
replacement:重写的url不带http,单纯的重写url
示例:
location / { #测试链接http://192.168.88.38/test/,匹配到location /{}后url被重写为http://192.168.88.38/breaktest,继续搜索匹配 #匹配到location = /breaktest{},最终返回http200及this is breaktest rewrite /test/(.*) /breaktest; } location = /breaktest { return 200 "this is breaktest"; }
flag:用于设置重写url后的进一步操作,有break,last,redirect,permanent,rewrite不带flag时,多个rewrite指令顺序执行,当location中没有可执行的rewrite模块指令时,重新发起一次location匹配,下面说明各个flag的用途:
break:和上面讲的break用途及用法一样,终止执行rewrite模块指令集; last:终止执行rewrite模块指令集,并开始搜寻重写url后匹配的location; redirect:临时重定向 permanent:永久重定向
示例:
location / { #测试链接http://192.168.88.38/test1,匹配到location / {} rewrite ^/test1 /test2;#被重写为/test2,继续往下执行rewrite rewrite ^/test2 /test3;#被重写为/test3,往下没有可执行的rewrite模块指令,发起一次location匹配,匹配到location /test3 {},最终返回http200及/test3 } location /test2 { return 200 "/test2"; } location /test3 { return 200 "/test3"; }
last和break的区别在于,last会发起新的location匹配,而break不会。
示例:
location / { rewrite ^/test1 /test2; rewrite ^/test2 /test3 last; rewrite ^/test3 /test4; } location /test2 { return 200 "/test2"; } location /test3 { return 200 "/test3"; } location /test4 { return 200 "/test4"; }
测试链接:http://192.168.88.38/test1 匹配到 location / {}后,被重写为/test2,顺序执行再次被重写为/test3,因为flag为last,所以不会继续重写为/test4,而是发起一次location匹配,匹配到location
/test3{},所以最终返回结果为http200及/test3;
如果把location /{}中的last改为break,被重写为/test3后,不再重写为/test4,也不会发起location,最终没有可匹配的资源,返回http404。
6.正则匹配URL的参数传递
小括号()之间匹配的内容,可以在后面通过 $下标 来引用,如$1表示引用第一个小括号匹配的内容,$表示引用第二个小括号匹配的内容。
示例:
location / { rewrite ^/(test1)/(test2)/(test3) /$2/$3; return 200 $2-$3; }
最终返回结果:
附nginx内置全局变量:
$args : #这个变量等于请求行中的参数,同$query_string $content_length : 请求头中的Content-length字段。 $content_type : 请求头中的Content-Type字段。 $document_root : 当前请求在root指令中指定的值。 $host : 请求主机头字段,否则为服务器名称。 $http_user_agent : 客户端agent信息 $http_cookie : 客户端cookie信息 $limit_rate : 这个变量可以限制连接速率。 $request_method : 客户端请求的动作,通常为GET或POST。 $remote_addr : 客户端的IP地址。 $remote_port : 客户端的端口。 $remote_user : 已经经过Auth Basic Module验证的用户名。 $request_filename : 当前请求的文件路径,由root或alias指令与URI请求生成。 $scheme : HTTP方法(如http,https)。 $server_protocol : 请求使用的协议,通常是HTTP/1.0或HTTP/1.1。 $server_addr : 服务器地址,在完成一次系统调用后可以确定这个值。 $server_name : 服务器名称。 $server_port : 请求到达服务器的端口号。 $request_uri : 包含请求参数的原始URI,不包含主机名,如:”/api/data?arg=abc”。 $uri : 不带请求参数的当前URI,$uri不包含主机名,如”/html/abc.html”。 $document_uri : 与$uri相同。
相关文章推荐
- [置顶] MySQL架构之逻辑模块组成配置详解
- Rsync模块配置及命令参数详解
- LAMP(php动态扩展模块,httpd的rewrite,php错误日志,php.ini配置详解)
- ElasticSearch 各模块介绍及参数配置详解
- Samba配置文件常用参数详解
- redis配置参数详解 (转)
- mysql 优化配置参数详解
- nginx配置详解之main模块
- SAP系统配置参数详解
- CentOS RedHat 5 Yum源使用配置及相关参数详解
- Flume中hdfs sink配置参数详解
- MongoDB配置参数详解
- Oracle安装Linux内核参数配置详解Centos6.4+11GR2
- 比较完整的Nginx配置文件nginx.conf常用参数中文详解
- 结合Control.FirefoxDialog控件,构造优秀的参数配置管理模块
- log4j配置参数详解——按日志文件大小、日期切分日志文件
- linux modprobe命令参数及用法详解--linux加载模块命令
- HUE配置文件hue.ini 的desktop模块详解(图文详解)(分HA集群)
- php-fpm 启动参数及重要配置详解
- JVM参数配置及详解 -Xms -Xmx -Xmn -Xss 调优总结