annotate xml/en/docs/http/ngx_http_dav_module.xml @ 2632:52500ccb82c1

Updated docs for the upcoming NGINX Plus release.
author Yaroslav Zhuravlev <yar@nginx.com>
date Fri, 04 Dec 2020 13:34:05 +0000
parents ca7568f67dee
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1 <?xml version="1.0"?>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
2
580
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 371
diff changeset
3 <!--
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 371
diff changeset
4 Copyright (C) Igor Sysoev
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 371
diff changeset
5 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 371
diff changeset
6 -->
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 371
diff changeset
7
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
9
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
10 <module name="Module ngx_http_dav_module"
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
11 link="/en/docs/http/ngx_http_dav_module.html"
589
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
12 lang="en"
774
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
13 rev="2">
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
14
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
15 <section id="summary">
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
16
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
17 <para>
774
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
18 The <literal>ngx_http_dav_module</literal> module is intended for file
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
19 management automation via the WebDAV protocol.
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
20 The module processes HTTP and WebDAV
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
21 methods PUT, DELETE, MKCOL, COPY, and MOVE.
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
22 </para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
23
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
24 <para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
25 This module is not built by default, it should be enabled with the
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
26 <literal>--with-http_dav_module</literal>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
27 configuration parameter.
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
28 </para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
29
774
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
30 <para>
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
31 <note>
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
32 WebDAV clients that require additional WebDAV methods to operate
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
33 will not work with this module.
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
34 </note>
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
35 </para>
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
36
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
37 </section>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
38
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
39
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
40 <section id="example" name="Example Configuration">
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
41
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
42 <para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
43 <example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
44 location / {
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
45 root /data/www;
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
46
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
47 client_body_temp_path /data/client_temp;
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
48
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
49 dav_methods PUT DELETE MKCOL COPY MOVE;
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
50
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
51 create_full_put_path on;
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
52 dav_access group:rw all:r;
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
53
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
54 limit_except GET {
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
55 allow 192.168.1.0/32;
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
56 deny all;
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
57 }
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
58 }
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
59 </example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
60 </para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
61
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
62 </section>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
63
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
64
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
65 <section id="directives" name="Directives">
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
66
2142
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
67 <directive name="create_full_put_path">
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
68 <syntax><literal>on</literal> | <literal>off</literal></syntax>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
69 <default>off</default>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
70 <context>http</context>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
71 <context>server</context>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
72 <context>location</context>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
73
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
74 <para>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
75 The WebDAV specification only allows creating files in already
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
76 existing directories.
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
77 This directive allows creating all needed intermediate directories.
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
78 </para>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
79
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
80 </directive>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
81
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
82
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
83 <directive name="dav_access">
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
84 <syntax><value>users</value>:<value>permissions</value> ...</syntax>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
85 <default>user:rw</default>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
86 <context>http</context>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
87 <context>server</context>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
88 <context>location</context>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
89
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
90 <para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
91 Sets access permissions for newly created files and directories, e.g.:
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
92 <example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
93 dav_access user:rw group:rw all:r;
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
94 </example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
95 </para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
96
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
97 <para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
98 If any <literal>group</literal> or <literal>all</literal> access permissions
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
99 are specified then <literal>user</literal> permissions may be omitted:
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
100 <example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
101 dav_access group:rw all:r;
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
102 </example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
103 </para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
104
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
105 </directive>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
106
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
107
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
108 <directive name="dav_methods">
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
109 <syntax>
774
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
110 <literal>off</literal> | <value>method</value> ...</syntax>
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
111 <default>off</default>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
112 <context>http</context>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
113 <context>server</context>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
114 <context>location</context>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
115
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
116 <para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
117 Allows the specified HTTP and WebDAV methods.
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
118 The parameter <literal>off</literal> denies all methods processed
774
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
119 by this module.
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
120 The following methods are supported:
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
121 <literal>PUT</literal>, <literal>DELETE</literal>, <literal>MKCOL</literal>,
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
122 <literal>COPY</literal>, and <literal>MOVE</literal>.
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
123 </para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
124
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
125 <para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
126 A file uploaded with the PUT method is first written to a temporary file,
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 774
diff changeset
127 and then the file is renamed.
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 774
diff changeset
128 Starting from version 0.8.9, temporary files and the persistent store
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 774
diff changeset
129 can be put on different file systems.
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 774
diff changeset
130 However, be aware that in this case a file is copied
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 774
diff changeset
131 across two file systems instead of the cheap renaming operation.
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
132 It is thus recommended that for any given location both saved files and a
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 774
diff changeset
133 directory holding temporary files, set by the
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
134 <link doc="ngx_http_core_module.xml" id="client_body_temp_path"/>
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 774
diff changeset
135 directive, are put on the same file system.
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
136 </para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
137
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
138 <para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
139 When creating a file with the PUT method, it is possible to specify
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
140 the modification date by passing it in the <header>Date</header>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
141 header field.
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
142 </para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
143
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
144 </directive>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
145
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
146
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
147 <directive name="min_delete_depth">
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
148 <syntax><value>number</value></syntax>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
149 <default>0</default>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
150 <context>http</context>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
151 <context>server</context>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
152 <context>location</context>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
153
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
154 <para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
155 Allows the DELETE method to remove files provided that
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 774
diff changeset
156 the number of elements in a request path is not less than the specified
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 774
diff changeset
157 number.
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
158 For example, the directive
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
159 <example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
160 min_delete_depth 4;
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
161 </example>
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 774
diff changeset
162 allows removing files on requests
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
163 <example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
164 /users/00/00/name
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
165 /users/00/00/name/pic.jpg
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
166 /users/00/00/page.html
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
167 </example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
168 and denies the removal of
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
169 <example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
170 /users/00/00
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
171 </example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
172 </para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
173
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
174 </directive>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
175
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
176 </section>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
177
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
178 </module>