Mercurial > hg > nginx-site
view xml/en/docs/http/ngx_http_random_index_module.xml @ 2846:fdf1464e1977
Moved banner to the external file to make partial rollout possible.
An idea is to have several banners and show them with different probability
specified by split directive in the nginx.conf
author | Sergey Budnevitch <sb@waeme.net> |
---|---|
date | Tue, 10 May 2022 18:07:27 +0400 |
parents | 95c3c3bbf1ce |
children |
line wrap: on
line source
<?xml version="1.0"?> <!-- Copyright (C) Igor Sysoev Copyright (C) Nginx, Inc. --> <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> <module name="Module ngx_http_random_index_module" link="/en/docs/http/ngx_http_random_index_module.html" lang="en" rev="2"> <section id="summary"> <para> The <literal>ngx_http_random_index_module</literal> module processes requests ending with the slash character (‘<literal>/</literal>’) and picks a random file in a directory to serve as an index file. The module is processed before the <link doc="ngx_http_index_module.xml">ngx_http_index_module</link> module. </para> <para> This module is not built by default, it should be enabled with the <literal>--with-http_random_index_module</literal> configuration parameter. </para> </section> <section id="example" name="Example Configuration"> <para> <example> location / { random_index on; } </example> </para> </section> <section id="directives" name="Directives"> <directive name="random_index"> <syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>location</context> <para> Enables or disables module processing in a surrounding location. </para> </directive> </section> </module>