view xml/ru/docs/http/ngx_http_index_module.xml @ 271:4c6d2c614d2c

Cleaned up XML tag mess: - all of <parameter> and <code>, and some of <dirname>, <value>, and <command> were replaced by <literal>; - the rest of <dirname> were replaced by links; - <argument> were replaced by <value>; - <value> is now rendered in HTML in italic; - <literal> and <path> can now contain <value>. Cleaned up terminology mess: - directives take "parameters".
author Ruslan Ermilov <ru@nginx.com>
date Fri, 23 Dec 2011 17:29:59 +0000
parents c78b2d6fe261
children cbb789d3ce5e
line wrap: on
line source

<?xml version="1.0"?>

<!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">

<module name="Директивы модуля ngx_http_index_module"
        link="/ru/docs/http/ngx_http_index_module.html"
        lang="ru">

<section id="summary">

<para>
Модуль ngx_http_index_module обслуживает запросы, оканчивающиеся слэшом.
</para>

</section>


<section name="Пример конфигурации" id="example">

<para>
<example>
    location  /  {
        index  index.$geo.html  index.html;
    }
</example>
</para>

</section>


<section name="Директивы" id="directives">

<directive name="index">
<syntax><value>файл</value> ...</syntax>
<default>index.html</default>
<context>http, server, location</context>

<para>
Директива определяет файлы, которые будут использоваться в качестве индекса.
В имени файла можно использовать переменные.
Наличие файлов проверяется в порядке их перечисления.
В конце списка может стоять файл с абсолютным путём.
Пример использования:
<example>
    index  index.$geo.html  index.0.html  /index.html;
</example>
</para>

<para>
Необходимо иметь ввиду, что при использовании индексного файла делается
внутреннее перенаправление и запрос может быть обработан уже в другом
location'е.
Например, запрос "/" будет фактически обработан во втором location'е
как "/index.html" в такой конфигурации:
<example>
    location  = /  {
        index  index.html;
    }

    location  /  {
        ...
    }
</example>
</para>

</directive>

</section>

</module>