Mercurial > hg > nginx-site
view xml/ru/docs/http/ngx_http_ssi_module.xml @ 452:e9a2a856d76b
Documented the $connection_requests variable.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Tue, 20 Mar 2012 07:48:06 +0000 |
parents | 8548b80a4552 |
children | 694db9597ee0 |
line wrap: on
line source
<?xml version="1.0"?> <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> <module name="Модуль ngx_http_ssi_module" link="/ru/docs/http/ngx_http_ssi_module.html" lang="ru"> <section id="summary"> <para> Модуль <literal>ngx_http_ssi_module</literal> — это фильтр, обрабатывающий команды SSI (Server Side Includes) в проходящих через него ответах. На данный момент список поддерживаемых команд SSI неполон. </para> </section> <section id="example" name="Пример конфигурации"> <para> <example> location / { ssi on; ... } </example> </para> </section> <section id="directives" name="Директивы"> <directive name="ssi"> <syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> <context>location</context> <context>if в location</context> <para> Разрешает или запрещает обработку команд SSI в ответах. </para> </directive> <directive name="ssi_silent_errors"> <syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> <context>location</context> <para> Разрешает не выводить строку “<literal>[an error occurred while processing the directive]</literal>”, если во время обработки SSI произошла ошибка. </para> </directive> <directive name="ssi_types"> <syntax><value>mime-тип</value> ...</syntax> <default>text/html</default> <context>http</context> <context>server</context> <context>location</context> <para> Разрешает обработку команд SSI в ответах с указанными MIME-типами в дополнение к “<literal>text/html</literal>”. </para> </directive> </section> <section id="commands" name="Команды SSI"> <para> Общий формат команд SSI такой: <example> <!--# команда параметр1=значение1 параметр2=значение2 ... --> </example> </para> <para> Поддерживаются следующие команды: <list type="tag"> <tag-name><literal>block</literal></tag-name> <tag-desc> Описывает блок, который можно использовать как заглушку в команде <literal>include</literal>. Внутри блока могут быть другие команды SSI. Параметр команды: <list type="tag"> <tag-name><literal>name</literal></tag-name> <tag-desc> имя блока. </tag-desc> </list> Пример: <example> <!--# block name="one" --> заглушка <!--# endblock --> </example> </tag-desc> <tag-name><literal>config</literal></tag-name> <tag-desc> Задаёт некоторые параметры, используемые при обработке SSI, а именно: <list type="tag"> <tag-name><literal>errmsg</literal></tag-name> <tag-desc> строка, выводящаяся при ошибке во время обработки SSI. По умолчанию выводится такая строка: <example> [an error occurred while processing the directive] </example> </tag-desc> <tag-name><literal>timefmt</literal></tag-name> <tag-desc> строка формата, передаваемая функции <c-func>strftime</c-func> для вывода даты и времени. По умолчанию используется такой формат: <example> "%A, %d-%b-%Y %H:%M:%S %Z" </example> Для вывода времени в секундах подходит формат “<literal>%s</literal>”. </tag-desc> </list> </tag-desc> <tag-name><literal>echo</literal></tag-name> <tag-desc> Выводит значение переменной. Параметры команды: <list type="tag"> <tag-name><literal>var</literal></tag-name> <tag-desc> имя переменной. </tag-desc> <tag-name><literal>encoding</literal></tag-name> <tag-desc> способ кодирования. Возможны три значения — <literal>none</literal>, <literal>url</literal> и <literal>entity</literal>. По умолчанию используется <literal>entity</literal>. </tag-desc> <tag-name><literal>default</literal></tag-name> <tag-desc> нестандартный параметр, задающий строку, которая выводится, если переменная не определена. По умолчанию выводится строка “<literal>none</literal>”. Команда <example> <!--# echo var="name" default="<emphasis>нет</emphasis>" --> </example> заменяет такую последовательность команд: <example> <!--# if expr="$name" --><!--# echo var="name" --><!--# else --><emphasis>нет</emphasis><!--# endif --> </example> </tag-desc> </list> </tag-desc> <tag-name><literal>if</literal></tag-name> <tag-desc> Выполняет условное включение. Поддерживаются следующие команды: <example> <!--# if expr="..." --> ... <!--# elif expr="..." --> ... <!--# else --> ... <!--# endif --> </example> На данный момент поддерживается только один уровень вложенности. Параметр команды: <list type="tag"> <tag-name><literal>expr</literal></tag-name> <tag-desc> выражение. В выражении может быть: <list type="bullet"> <listitem> проверка существования переменной: <example> <!--# if expr="$name" --> </example> </listitem> <listitem> сравнение переменной с текстом: <example> <!--# if expr="$name = <value>text</value>" --> <!--# if expr="$name != <value>text</value>" --> </example> </listitem> <listitem> сравнение переменной с регулярным выражением: <example> <!--# if expr="$name = /<value>text</value>/" --> <!--# if expr="$name != /<value>text</value>/" --> </example> </listitem> </list> Если в <value>text</value> встречаются переменные, то производится подстановка их значений. В регулярном выражении можно задать позиционные и именованные выделения, а затем использовать их через переменные, например: <example> <!--# if expr="$name = /(.+)@(?P<domain>.+)/" --> <!--# echo var="1" --> <!--# echo var="domain" --> <!--# endif --> </example> </tag-desc> </list> </tag-desc> <tag-name><literal>include</literal></tag-name> <tag-desc> Включает в ответ результат другого запроса. Параметры команды: <list type="tag"> <tag-name><literal>file</literal></tag-name> <tag-desc> задаёт включаемый файл, например: <example> <!--# include file="footer.html" --> </example> </tag-desc> <tag-name><literal>virtual</literal></tag-name> <tag-desc> задаёт включаемый запрос, например: <example> <!--# include virtual="/remote/body.php?argument=value" --> </example> Несколько запросов, указанных на одной странице и обрабатываемых проксируемыми или FastCGI-серверами, работают параллельно. Если нужна последовательная обработка, следует воспользоваться параметром <literal>wait</literal>. </tag-desc> <tag-name><literal>stub</literal></tag-name> <tag-desc> нестандартный параметр, задающий имя блока, содержимое которого будет выведено, если тело ответа на включаемый запрос пустое или если при исполнении запроса произошла ошибка, например: <example> <!--# block name="one" -->&nbsp;<!--# endblock --> <!--# include virtual="/remote/body.php?argument=value" stub="one" --> </example> Содержимое замещающего блока обрабатывается в контексте включаемого запроса. </tag-desc> <tag-name><literal>wait</literal></tag-name> <tag-desc> нестандартный параметр, указывающий, нужно ли ждать полного исполнения данного запроса, прежде чем продолжать выполнение SSI, например: <example> <!--# include virtual="/remote/body.php?argument=value" wait="yes" --> </example> </tag-desc> <tag-name><literal>set</literal></tag-name> <tag-desc> нестандартный параметр, указывающий, что удачный результат выполнения запроса нужно записать в заданную переменную, например: <example> <!--# include virtual="/remote/body.php?argument=value" set="one" --> </example> Необходимо учитывать, что в переменные можно записать только результаты ответов, полученные через модули <link doc="ngx_http_proxy_module.xml">ngx_http_proxy_module</link> и <link doc="ngx_http_memcached_module.xml">ngx_http_memcached_module</link>. </tag-desc> </list> </tag-desc> <tag-name><literal>set</literal></tag-name> <tag-desc> Присваивает значение переменной. Параметры команды: <list type="tag"> <tag-name><literal>var</literal></tag-name> <tag-desc> имя переменной. </tag-desc> <tag-name><literal>value</literal></tag-name> <tag-desc> значение переменной. Если в присваиваемом значении есть переменные, то производится подстановка их значений. </tag-desc> </list> </tag-desc> </list> </para> </section> <section id="variables" name="Встроенные переменные"> <para> Модуль <literal>ngx_http_ssi_module</literal> поддерживает две встроенные переменные: <list type="tag"> <tag-name><var>$date_local</var></tag-name> <tag-desc> текущее время в локальной временной зоне. Формат задаётся командой <literal>config</literal> с параметром <literal>timefmt</literal>. </tag-desc> <tag-name><var>$date_gmt</var></tag-name> <tag-desc> текущее время в GMT. Формат задаётся командой <literal>config</literal> с параметром <literal>timefmt</literal>. </tag-desc> </list> </para> </section> </module>