map指令简单介绍

当然这里写的都是官方文档是已经写过的，我简单抄一下哈。

map指令来自于 ngx_http_map_module 模块，提供的核心能力是 基于一个变量创建一个新变量，大概是这意思。

语法: 只能配置在http块内
map string $variable {...}

直接看这个语法好像看不出来它能干什么，所以官方文档上给了几个例子:

map $http_host $name {
    hostnames;
    default       0;
    example.com   1;
    *.example.com 1;
    example.org   2;
    *.example.org 2;
    .example.net  3;
    wap.*         4;
}

解析一下上面👆这个例子的意思👇:

map: 关键字，开辟一段内存空间声明一个map
$http_host: 获取host请求头：eg: www.baidu.com
$name: 新变量，具体取值是什么取决于结构体内的映射关系
结构体内的数据解析:
    hostnames:
    - 官方文档给出的解释是：允许用前缀或者后缀掩码指定域名作为源变量值。这个参数必须写在值映射列表的最前面。
    读都能读的懂，字也都认识，但是怎么感觉好像还是不太懂呢，又没有同感？于是我测试了一下，其实就是你想用下面那种泛域名来匹配host的话就加一下这个参数， 否则是达不到预期效果的。
    default 0; :匹配不到符合条件的数据时 则$name 这个变量就取默认值 0

知道了这之后我能用它来做什么呢？看实际应用的例子

map指令的实践使用

1. 基于cookie做多环境分流

一般中大型公司都会有多套测试环境，对于多环境的访问可能最容易想到的就是对应多个域名，这方法当然可以，但是不优雅，维护多个域名太累。为了偷懒，我们用了一个域名，使用不同的cookie来转发相应的流量到相应的环境。

如何实现？

map $cookie_cl_env_num $cl_backend_map {
        default   1.1.1.1:80;
        dev-01    upstream_dev-01;
        dev-02    upstream_dev-02;
        dev-03    upstream_dev-03;
        test-01   upstream_test-01;
        test-02   upstream_test-02;
        test-03   upstream_test-03;
        test-04   upstream_test-04;
        test-05   upstream_test-05;
        test-06   upstream_test-06;
        test-07   upstream_test-07;
        test-08   upstream_test-08;
        test-09   upstream_test-09;
        test-10   upstream_test-10;
        test-11   upstream_test-11;
        test-12   upstream_test-12;
        test-13   upstream_test-13;
        test-14   upstream_test-14;
        test-15   upstream_test-15;
    }
    # 随便写一个
    upstream upstream_test-14 {
        server 2.2.2.2:80;
    }
    # 局部实现写一下
    location / {
        pass_pass http://$cl_backend_map;
    }
    # 请求
    curl --cookie "cl_env_num=test-15" a.test.com/api/v1/hahaha

这不就实现了嘛，很方便哈。仅提供思路！当然也可以使用其他变量来分流 UA|args ...

2. 做安全的多域名跨域访问

跨域访问一般情况下我们都会直接设置 * 允许所有跨域访问。但是难免会有一些对安全性要求较高的业务不允许这样，那么对于域名比较多的安全跨域配置，也可以使用map来实现。

map $http_origin $allow_origin {
    ~http://www.baidu.com http://www.baidu.com;
    ~http://m.baidu.com   http://m.baidu.com;
    ~http://a.baidu.com   http://a.baidu.com;
    default               deny;
}
server {
    listen 80;
    server_name www.baidu.com;
    location / {
        ...
        add_header Access-Control-Allow-Origin $allow_origin;
        ...
    }
}

仅提供思路哈，具体情况可以再优化

总结

当然还有很多场景都可以用到， 无法一一列举， 自己能够根据需求和场景灵活运用是最好的。