Mercurial > hg > nginx-site
view xml/ru/docs/http/ngx_http_dav_module.xml @ 645:bb450e295ca2
Translated "Server names" into Russian and slightly changed original layout.
author | Vladimir Homutov <vl@nginx.com> |
---|---|
date | Fri, 17 Aug 2012 07:15:00 +0000 |
parents | 764fbac1b8b4 |
children | 8ff309263cb9 |
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="Модуль ngx_http_dav_module" link="/ru/docs/http/ngx_http_dav_module.html" lang="ru" rev="1"> <section id="summary"> <para> Модуль <literal>ngx_http_dav_module</literal> обрабатывает HTTP- и WebDAV-методы PUT, DELETE, MKCOL, COPY и MOVE. </para> <para> По умолчанию этот модуль не собирается, его сборку необходимо разрешить с помощью конфигурационного параметра <literal>--with-http_dav_module</literal>. </para> </section> <section id="example" name="Пример конфигурации"> <para> <example> location / { root /data/www; client_body_temp_path /data/client_temp; dav_methods PUT DELETE MKCOL COPY MOVE; create_full_put_path on; dav_access group:rw all:r; limit_except GET { allow 192.168.1.0/32; deny all; } } </example> </para> </section> <section id="directives" name="Директивы"> <directive name="dav_access"> <syntax><value>пользователи</value>:<value>права</value> ...</syntax> <default>user:rw</default> <context>http</context> <context>server</context> <context>location</context> <para> Задаёт права доступа для создаваемых файлов и каталогов, например, <example> dav_access user:rw group:rw all:r; </example> </para> <para> Если заданы какие-либо права для <literal>group</literal> или <literal>all</literal>, то права для <literal>user</literal> указывать необязательно: <example> dav_access group:rw all:r; </example> </para> </directive> <directive name="dav_methods"> <syntax> <literal>off</literal> | <literal>put</literal> | <literal>delete</literal> | <literal>mkcol</literal> | <literal>copy</literal> | <literal>move</literal> ...</syntax> <default>off</default> <context>http</context> <context>server</context> <context>location</context> <para> Разрешает указанные HTTP- и WebDAV-методы. Параметр <literal>off</literal> запрещает все методы, обрабатываемые данным модулем, игнорируя остальные параметры; </para> <para> Файл, загружаемый методом PUT, записывается во временный файл, а потом этот файл переименовывается. Начиная с версии 0.8.9, временный файл и его постоянное место хранения могут располагаться на разных файловых системах, но нужно учитывать, что в этом случае вместо дешёвой операции переименовывания в пределах одной файловой системы файл копируется с одной файловой системы на другую. Поэтому лучше, если сохраняемые файлы будут находиться на той же файловой системе, что и каталог с временными файлами, задаваемый директивой <link doc="ngx_http_core_module.xml" id="client_body_temp_path"/> для данного location. </para> <para> При создании файла с помощью метода PUT можно задать дату модификации, передав её в поле заголовка <header>Date</header>. </para> </directive> <directive name="create_full_put_path"> <syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> <context>location</context> <para> По спецификации WebDAV метод PUT может создавать файл только в уже существующем каталоге. Данная директива разрешает создавать все необходимые промежуточные каталоги. </para> </directive> <directive name="min_delete_depth"> <syntax><value>число</value></syntax> <default>0</default> <context>http</context> <context>server</context> <context>location</context> <para> Разрешает методу DELETE удалять файлы при условии, что число элементов в пути запроса не меньше заданного. Например, директива <example> min_delete_depth 4; </example> разрешает удалять файлы по запросам <example> /users/00/00/name /users/00/00/name/pic.jpg /users/00/00/page.html </example> и запрещает удаление <example> /users/00/00 </example> </para> </directive> </section> </module>