与其他 location 配合

Nginx 世界的 location 是异常强大的，毕竟 Nginx 的主要应用场景是在负载均衡、API Server，在不同 server、location 之间跳转更是家常便饭。利用不同 location 的功能组合，我们可以实现 内部调用、流水线方式跳转、外部重定向 等几种不同形式的服务，下面将给大家介绍几个主要应用，就当抛砖引玉。

内部调用

例如对数据库、内部公共函数的统一接口，可以把它们放到统一的 location 中。通常情况下，为了保护这些内部接口，都会把这些接口设置为 internal 。这么做的最主要好处就是可以让这个 内部接口相对独立，不受外界干扰。

示例代码：

  1. location = /sum {
  2.     # 只允许内部调用
  3.     internal;
  5.     # 这里做了一个求和运算只是一个例子，可以在这里完成一些数据库、
  6.     # 缓存服务器的操作，达到基础模块和业务逻辑分离目的
  7.     content_by_lua_block {
  8.         local args = ngx.req.get_uri_args()
  9.         ngx.say(tonumber(args.a) + tonumber(args.b))
  10.     }
  11. }
  13. location = /app/test {
  14.     content_by_lua_block {
  15.         local res = ngx.location.capture(
  16.                         "/sum", {args={a=3, b=8}}
  17.                         )
  18.         ngx.say("status:", res.status, " response:", res.body)
  19.     }
  20. }

紧接着，稍微扩充一下，并行请求的效果，示例如下：

  1. location = /sum {
  2.     internal;
  3.     content_by_lua_block {
  4.         ngx.sleep(0.1)
  5.         local args = ngx.req.get_uri_args()
  6.         ngx.print(tonumber(args.a) + tonumber(args.b))
  7.     }
  8. }
  10. location = /subduction {
  11.     internal;
  12.     content_by_lua_block {
  13.         ngx.sleep(0.1)
  14.         local args = ngx.req.get_uri_args()
  15.         ngx.print(tonumber(args.a) - tonumber(args.b))
  16.     }
  17. }
  19. location = /app/test_parallels {
  20.     content_by_lua_block {
  21.         local start_time = ngx.now()
  22.         local res1, res2 = ngx.location.capture_multi( {
  23.                         {"/sum", {args={a=3, b=8}}},
  24.                         {"/subduction", {args={a=3, b=8}}}
  25.                     })
  26.         ngx.say("status:", res1.status, " response:", res1.body)
  27.         ngx.say("status:", res2.status, " response:", res2.body)
  28.         ngx.say("time used:", ngx.now() - start_time)
  29.     }
  30. }
  32. location = /app/test_queue {
  33.     content_by_lua_block {
  34.         local start_time = ngx.now()
  35.         local res1 = ngx.location.capture_multi( {
  36.                         {"/sum", {args={a=3, b=8}}}
  37.                     })
  38.         local res2 = ngx.location.capture_multi( {
  39.                         {"/subduction", {args={a=3, b=8}}}
  40.                     })
  41.         ngx.say("status:", res1.status, " response:", res1.body)
  42.         ngx.say("status:", res2.status, " response:", res2.body)
  43.         ngx.say("time used:", ngx.now() - start_time)
  44.     }
  45. }

测试结果：

  1. ➜  ~ curl 127.0.0.1/app/test_parallels
  2. status:200 response:11
  3. status:200 response:-5
  4. time used:0.10099983215332
  5. ➜  ~ curl 127.0.0.1/app/test_queue
  6. status:200 response:11
  7. status:200 response:-5
  8. time used:0.20199990272522

利用 ngx.location.capture_multi 函数，直接完成了两个子请求并行执行。当两个请求没有相互依赖时，这种方法可以极大地提高查询效率。 两个无依赖请求，各自是 100ms，顺序执行需要 200ms，但通过并行执行它们可以在 100ms 全部完成。实际生产中查询时间可能没这么规整，但思想大同小异，这个特性是很有用的。

图例

该方法，可以被广泛应用于广告系统（1：N 模型，一个请求，后端从 N 家供应商中获取条件最优广告）、高并发前端页面展示（并行无依赖界面、降级开关等）。

流水线方式跳转

现在的网络请求，已经变得越来越拥挤。各种不同 API 、下载请求混杂在一起，这就要求不同厂商针对下载的动态调整有不同的定制策略。而这些策略在一天的不同时间段，执行规则可能还不一样。这时候我们就可以效仿工厂的流水线模式，逐层过滤、处理。

示例代码：

  1. location ~ ^/static/([-_a-zA-Z0-9/]+).jpg {
  2.     set $image_name $1;
  3.     content_by_lua_block {
  4.         ngx.exec("/download_internal/images/"
  5.                 .. ngx.var.image_name .. ".jpg");
  6.     };
  7. }
  9. location /download_internal {
  10.     internal;
  11.     # 这里还可以有其他统一的 download 下载设置，例如限速等
  12.     alias ../download;
  13. }

注意，ngx.exec 方法与 ngx.redirect 是完全不同的，前者是个 纯粹的内部跳转 并且 没有引入任何额外 HTTP 信号。

这里的两个 location 更像是流水线上工人之间的协作关系。第一环节的工人完成自己的处理部分后，直接交给第二环节处理人（实际上可以有更多环节），它们之间的 数据流是定向 的。

图例

外部重定向

不知道大家什么时候开始注意的，百度的首页已经不再是 HTTP 协议，它已经全面修改到了 HTTPS 协议上。但是对于大家的输入习惯，估计还是在地址栏里面输入 baidu.com ，回车后发现它会自动跳转到 https://www.baidu.com ，这时候就需要的外部重定向了。

  1. location = /foo {
  2.     content_by_lua_block {
  3.         ngx.say([[I am foo]])
  4.     }
  5. }
  7. location = / {
  8.     rewrite_by_lua_block {
  9.         return ngx.redirect('/foo');
  10.     }
  11. }

执行测试，结果如下：

  1. ➜  ~  curl 127.0.0.1 -i
  2. HTTP/1.1 302 Moved Temporarily
  3. Server: openresty/1.9.3.2rc3
  4. Date: Sun, 22 Nov 2015 11:04:03 GMT
  5. Content-Type: text/html
  6. Content-Length: 169
  7. Connection: keep-alive
  8. Location: /foo
  10. <html>
  11. <head><title>302 Found</title></head>
  12. <body bgcolor="white">
  13. <center><h1>302 Found</h1></center>
  14. <hr><center>openresty/1.9.3.2rc3</center>
  15. </body>
  16. </html>
  18. ➜  ~  curl 127.0.0.1/foo -i
  19. HTTP/1.1 200 OK
  20. Server: openresty/1.9.3.2rc3
  21. Date: Sun, 22 Nov 2015 10:43:51 GMT
  22. Content-Type: text/html
  23. Transfer-Encoding: chunked
  24. Connection: keep-alive
  26. I am foo

当我们使用浏览器访问页面 http://127.0.0.1 就可以发现浏览器会自动跳转到 http://127.0.0.1/foo 。

与之前两个应用实例不同的，外部重定向是可以跨域名的。例如从 A 网站跳转到 B 网站是绝对允许的。在 CDN 场景的大量下载应用中，一般分为调度、存储两个重要环节。调度就是通过根据请求方 IP 、下载文件等信息寻找最近、最快节点，应答跳转给请求方完成下载。