Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_dav_module.xml @ 370:66414a4eb347

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Revision.
author Ruslan Ermilov <ru@nginx.com>
date Mon, 30 Jan 2012 07:31:58 +0000
parents 2305be197a84
children be54c443235a
comparison
equal deleted inserted replaced
369:68d9e5f2ea81 370:66414a4eb347
1 <?xml version="1.0"?> 1 <?xml version="1.0"?>
2 2
3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4 4
5 <module name="Директивы модуля ngx_http_dav_module" 5 <module name="Модуль ngx_http_dav_module"
6 link="/ru/docs/http/ngx_http_dav_module.html" 6 link="/ru/docs/http/ngx_http_dav_module.html"
7 lang="ru"> 7 lang="ru">
8 8
9 <section id="summary"> 9 <section id="summary">
10 10
11 <para> 11 <para>
12 Модуль ngx_http_dav_module обрабатывает HTTP- и WebDAV-методы 12 Модуль <literal>ngx_http_dav_module</literal> обрабатывает HTTP- и WebDAV-методы
13 PUT, DELETE, MKCOL, COPY и MOVE. 13 PUT, DELETE, MKCOL, COPY и MOVE.
14 По умолчанию модуль не собирается, нужно разрешить его сборку 14 </para>
15 при конфигурировании параметром <literal>--with-http_dav_module</literal>. 15
16 <para>
17 По умолчанию этот модуль не собирается, его сборку необходимо
18 разрешить с помощью конфигурационного параметра
19 <literal>--with-http_dav_module</literal>.
16 </para> 20 </para>
17 21
18 </section> 22 </section>
19 23
20 24
21 <section name="Пример конфигурации" id="example"> 25 <section id="example" name="Пример конфигурации">
22 26
23 <para> 27 <para>
24 <example> 28 <example>
25 location / { 29 location / {
26 root /data/www; 30 root /data/www;
27 31
28 client_body_temp_path /data/client_temp; 32 client_body_temp_path /data/client_temp;
29 33
30 dav_methods PUT DELETE MKCOL COPY MOVE; 34 dav_methods PUT DELETE MKCOL COPY MOVE;
31 35
32 create_full_put_path on; 36 create_full_put_path on;
33 dav_access group:rw all:r; 37 dav_access group:rw all:r;
34 38
35 limit_except GET { 39 limit_except GET {
36 allow 192.168.1.0/32; 40 allow 192.168.1.0/32;
37 deny all; 41 deny all;
38 }
39 } 42 }
43 }
40 </example> 44 </example>
41 </para> 45 </para>
42 46
43 </section> 47 </section>
44 48
45 49
46 <section name="Директивы" id="directives"> 50 <section id="directives" name="Директивы">
47 51
48 <directive name="dav_access"> 52 <directive name="dav_access">
49 <syntax><value>пользователи</value><literal>:</literal><value>права</value> ...</syntax> 53 <syntax><value>пользователи</value>:<value>права</value> ...</syntax>
50 <default>user:rw</default> 54 <default>user:rw</default>
51 <context>http, server, location</context> 55 <context>http</context>
56 <context>server</context>
57 <context>location</context>
52 58
53 <para> 59 <para>
54 Директива задаёт права доступа для создаваемых файлов и каталогов, 60 Задаёт права доступа для создаваемых файлов и каталогов,
55 например, 61 например,
56 <example> 62 <example>
57 dav_access user:rw group:rw all:r; 63 dav_access user:rw group:rw all:r;
58 </example> 64 </example>
59 Если заданы какие-либо права для groups или all, то права для user 65 </para>
66
67 <para>
68 Если заданы какие-либо права для <literal>group</literal> или
69 <literal>all</literal>, то права для <literal>user</literal>
60 указывать необязательно: 70 указывать необязательно:
61 <example> 71 <example>
62 dav_access group:rw all:r; 72 dav_access group:rw all:r;
63 </example> 73 </example>
64 </para> 74 </para>
65 75
66 </directive> 76 </directive>
67 77
68 78
69 <directive name="dav_methods"> 79 <directive name="dav_methods">
70 <syntax> 80 <syntax>
71 <literal>off</literal> | <literal>put</literal> | <literal>delete</literal> | 81 <literal>off</literal> | <literal>put</literal> |
72 <literal>mkcol</literal> | <literal>copy</literal> | <literal>move</literal> 82 <literal>delete</literal> | <literal>mkcol</literal> |
73 ...</syntax> 83 <literal>copy</literal> | <literal>move</literal>
84 ...</syntax>
74 <default>off</default> 85 <default>off</default>
75 <context>http, server, location</context> 86 <context>http</context>
87 <context>server</context>
88 <context>location</context>
76 89
77 <para> 90 <para>
78 Директива разрешает указанные HTTP- и WebDAV-методы. 91 Разрешает указанные HTTP- и WebDAV-методы.
79 Параметр off запрещает все методы, обрабатываемые данным модулем, 92 Параметр <literal>off</literal> запрещает все методы, обрабатываемые
80 игнорируя остальные параметры; 93 данным модулем, игнорируя остальные параметры;
81 </para> 94 </para>
82 95
83 <para> 96 <para>
84 Файл, загружаемый методом PUT, записывается во временный файл, 97 Файл, загружаемый методом PUT, записывается во временный файл,
85 а потом этот файл переименовывается. 98 а потом этот файл переименовывается.
93 для данного location. 106 для данного location.
94 </para> 107 </para>
95 108
96 <para> 109 <para>
97 При создании файла с помощью метода PUT можно задать дату модификации, 110 При создании файла с помощью метода PUT можно задать дату модификации,
98 передав её в строке заголовка "Date". 111 передав её в поле заголовка <header>Date</header>.
99 </para> 112 </para>
100 113
101 </directive> 114 </directive>
102 115
103 116
104 <directive name="create_full_put_path"> 117 <directive name="create_full_put_path">
105 <syntax><literal>on</literal> | <literal>off</literal></syntax> 118 <syntax><literal>on</literal> | <literal>off</literal></syntax>
106 <default>off</default> 119 <default>off</default>
107 <context>http, server, location</context> 120 <context>http</context>
121 <context>server</context>
122 <context>location</context>
108 123
109 <para> 124 <para>
110 По спецификации WebDAV метод PUT может создавать файл только в 125 По спецификации WebDAV метод PUT может создавать файл только в
111 уже существующем каталоге. Данная директива разрешает создавать 126 уже существующем каталоге.
112 все необходимые промежуточные каталоги. 127 Данная директива разрешает создавать все необходимые промежуточные каталоги.
113
114 </para> 128 </para>
115 129
116 </directive> 130 </directive>
117 131
118 132
119 <directive name="min_delete_depth"> 133 <directive name="min_delete_depth">
120 <syntax><value>число</value></syntax> 134 <syntax><value>число</value></syntax>
121 <default>0</default> 135 <default>0</default>
122 <context>http, server, location</context> 136 <context>http</context>
137 <context>server</context>
138 <context>location</context>
123 139
124 <para> 140 <para>
125 Данная директива разрешает методу DELETE удалять файлы 141 Разрешает методу DELETE удалять файлы
126 при условии, что число элементов в пути запроса не меньше заданного. 142 при условии, что число элементов в пути запроса не меньше заданного.
127 Например, директива 143 Например, директива
128 <example> 144 <example>
129 min_delete_depth 4; 145 min_delete_depth 4;
130 </example> 146 </example>
131 разрешает удалять файлы по запросам 147 разрешает удалять файлы по запросам
132 <example> 148 <example>
133 /users/00/00/name 149 /users/00/00/name
134 /users/00/00/name/pic.jpg 150 /users/00/00/name/pic.jpg