map

This module allows you to classify, or map a set of values into a different set of values and store the result in a variable.

Example:

map  $http_host  $name  {
  hostnames;


  default          0;

  example.com      1;
  *.example.com    1;
  test.com         2;
  *.test.com       2;
  .site.com        3;

}

One use for this would be to use a mapping in place of writing lots of server/location directives or redirects:

map $uri $new {
  default        http://www.domain.com/home/;

  /aa            http://aa.domain.com/;
  /bb            http://bb.domain.com/;
  /john          http://my.domain.com/users/john/;

}

server {
  server_name   www.domain.com;
  rewrite  ^    $new   redirect;
}

指令

map

syntax:*map $var1 $var2 { ... }*

default:*none*

context:*http*

map defines the mapping table which will be used to set a variable. There are three special parameters:

  • default — defines the value to be used where no match is found.
  • hostnames — it allows for an easier matching of values like host names, names with a starting dot may match exact host names and host names ending with the value, for example:
*.example.com  1;

Instead of two entries

example.com    1;
*.example.com  1;

we can use only one


.example.com   1;
  • include — include values from a file. Multiple includes may be used.

map_hash_max_size

syntax:*map_hash_max_size number*

default:*map_hash_max_size 2048*

context:*http*

The directive sets the maximum size of a hash table to hold the variable map. For more details see the descriptions of hash settings Optimization section .

map_hash_bucket_size

syntax:*map_hash_bucket_size n*

default:*map_hash_bucket_size 32/64/128*

context:*http*

The directive sets the maximum size in a hash table to map variables. The default value depends on the size of the cache line processor. More see in the descriptions of hash settings in the Optimization section .

References

Original Documentation