FAQ

Page Discussion History

Difference between revisions of "HttpSplitClientsModule"

(Fixed underscore instead of dash in directive names.)
 
(References: Added link to the original documentation)
Line 30: Line 30:
 
= References =
 
= References =
  
 +
* [http://nginx.org/en/docs/http/ngx_http_split_clients_module.html Original Documentation]
 
* [http://www.ruby-forum.com/topic/209653 Naming convention discussion]
 
* [http://www.ruby-forum.com/topic/209653 Naming convention discussion]

Revision as of 15:39, 21 April 2012

Contents

Synopsis

ngx_http_split_clients_module is used to split clients based on some conditions(e.g ip addresses, headers, cookies, etc).

Example configuration:

http {
    split_clients "${remote_addr}AAA" $variant {
        0.5% .one;
        2.0% .two;
        - "";
    }
 
    server {
        location / {
             index index${variant}.html;

$cookie_..., etc, may be used as a source for splitting. The source string is hashed using MurmurHash2 (as of 1.0.1; previously CRC32) and the percent of the hash is used as source value.

Directives

split_clients

syntax: split_clients $variable { ... }

default: none

context: http

References