Revision as of 17:45, 30 April 2012

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

ERROR in secure-include.php: could not read the given src URL http://wiki.nginx.org/nginx.org/ngx_http_split_clients_module/split_clients.txt

References

• Original Documentation
• Naming convention discussion