]> granicus.if.org Git - apache/blob - docs/manual/mod/mod_dav.xml.ko
Rebuild HTML from various changes yesterday.
[apache] / docs / manual / mod / mod_dav.xml.ko
1 <?xml version="1.0" encoding="EUC-KR" ?>
2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
4 <!-- English Revision: 151408:1673582 (outdated) -->
5
6 <!--
7  Licensed to the Apache Software Foundation (ASF) under one or more
8  contributor license agreements.  See the NOTICE file distributed with
9  this work for additional information regarding copyright ownership.
10  The ASF licenses this file to You under the Apache License, Version 2.0
11  (the "License"); you may not use this file except in compliance with
12  the License.  You may obtain a copy of the License at
13
14      http://www.apache.org/licenses/LICENSE-2.0
15
16  Unless required by applicable law or agreed to in writing, software
17  distributed under the License is distributed on an "AS IS" BASIS,
18  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
19  See the License for the specific language governing permissions and
20  limitations under the License.
21 -->
22
23 <modulesynopsis metafile="mod_dav.xml.meta">
24
25 <name>mod_dav</name> 
26 <description>Distributed Authoring and Versioning
27 (<a href="http://www.webdav.org/">WebDAV</a>) ±â´É</description>
28 <status>Extension</status>
29 <sourcefile>mod_dav.c</sourcefile>
30 <identifier>dav_module</identifier>
31
32 <summary>
33     <p>ÀÌ ¸ðµâÀº ¾ÆÆÄÄ¡¿¡ <a href="http://www.webdav.org">WebDAV</a>
34     ('Web-based Distributed Authoring and Versioning') class 1°ú
35     class 2 ±â´ÉÀ» Ãß°¡ÇÑ´Ù. WebDAV´Â ¿ø°Ý À¥¼­¹öÀÇ ÀÚ¿ø°ú
36     ÄÝ·º¼Ç(collection)À» <transnote>ÄÝ·º¼ÇÀº ÆÄÀϽýºÅÛÀÇ µð·ºÅ丮¿Í
37     °°Àº °³³äÀÌ´Ù</transnote> ¸¸µé°í, ¿Å±â°í, º¹»çÇÏ°í, Áö¿ï
38     ¼ö ÀÖµµ·Ï HTTP ÇÁ·ÎÅäÄÝÀ» È®ÀåÇÑ °ÍÀÌ´Ù.</p>
39 </summary>
40 <seealso><directive module="mod_dav_fs">DavLockDB</directive></seealso>
41 <seealso><directive module="core">LimitXMLRequestBody</directive></seealso>
42 <seealso><a href="http://www.webdav.org">WebDAV Á¤º¸</a></seealso>
43
44 <section id="example"><title>WebDAV »ç¿ëÇϱâ</title>
45     <p><module>mod_dav</module>¸¦ »ç¿ëÇÏ·Á¸é <code>httpd.conf</code>
46     ÆÄÀÏ¿¡ ¾Æ·¡°ú °°ÀÌ Ãß°¡ÇÑ´Ù:</p>
47
48     <example>Dav On</example>
49
50     <p>±×·¯¸é <module>mod_dav_fs</module> ¸ðµâÀÌ ±¸ÇöÇϴ DAV
51     ÆÄÀϽýºÅÛ Á¦°øÀÚ(provider)¸¦ »ç¿ëÇÑ´Ù. ±×·¯¹Ç·Î ÀÌ ¸ðµâµµ
52     ¼­¹ö¿¡ °°ÀÌ ÄÄÆÄÀϵÇÀְųª <directive
53     module="mod_so">LoadModule</directive> Áö½Ã¾î·Î ½ÇÇàÁß¿¡
54     Àоîµé¿©¾ß ÇÑ´Ù.</p>
55     
56     <p>¶Ç, DAV Àá±Ý(lock) µ¥ÀÌÅͺ£À̽ºÀÇ À§Ä¡¸¦ <code>httpd.conf</code>
57     ÆÄÀÏÀÇ Àü¿ª ºÎºÐ¿¡ <directive
58     module="mod_dav_fs">DavLockDB</directive> Áö½Ã¾î¸¦ »ç¿ëÇÏ¿©
59     ÁöÁ¤ÇؾߠÇÑ´Ù:</p>
60
61     <example>
62       DavLockDB /usr/local/apache2/var/DavLock
63     </example>
64
65     <p>¾ÆÆÄÄ¡¸¦ ½ÇÇàÇϴ <directive
66     module="mpm_common">User</directive>¿Í <directive
67     module="mpm_common" >Group</directive>Àº Àá±Ý µ¥ÀÌÅͺ£À̽º°¡
68     Àִ µð·ºÅ丮¿¡ ¾²±â ±ÇÇÑÀ» °¡Á®¾ß ÇÑ´Ù.</p>
69
70     <p>DAV¸¦ »ç¿ëÇϴ À§Ä¡¿¡ Á¢±ÙÀ» Á¦ÇÑÇϱâÀ§ÇØ <directive
71     module="core" type="section">Location</directive> Áö½Ã¾î
72     ¾È¿¡ <directive module="core" type="section">Limit</directive>
73     Áö½Ã¾î¸¦ »ç¿ëÇÒ ¼ö ÀÖ´Ù. DAV Å¬¶óÀ̾ðÆ®°¡ ÇѹøÀÇ ¿äû¿¡
74     º¸³¾ ¼ö Àִ ÃÖ´ë ¹ÙÀÌÆ®¼ö¸¦ Á¦ÇÑÇÏ·Á¸é <directive
75     module="core">LimitXMLRequestBody</directive> Áö½Ã¾î¸¦ »ç¿ëÇÑ´Ù.
76     "ÀϹÝÀûÀÎ" <directive module="core">LimitRequestBody</directive>
77     Áö½Ã¾î´Â DAV ¿äû°ú °ü°è¾ø´Ù.</p>
78
79     <example><title>Àüü ¿¹Á¦</title>
80       DavLockDB /usr/local/apache2/var/DavLock<br />
81       <br />
82        &lt;Location /foo&gt;<br />
83        <indent>
84          Dav On<br />
85          <br />
86          AuthType Basic<br />
87          AuthName DAV<br />
88          AuthUserFile user.passwd<br />
89          <br />
90          &lt;LimitExcept GET OPTIONS&gt;<br />
91          <indent>
92            require user admin<br />
93          </indent>
94          &lt;/LimitExcept&gt;<br />
95        </indent>
96        &lt;/Location&gt;<br />
97     </example>
98
99 </section>
100
101 <section id="security"><title>º¸¾È ¹®Á¦</title>
102
103     <p>DAV¸¦ »ç¿ëÇϸ頿ø°Ý Å¬¶óÀ̾ðÆ®°¡ ¼­¹öÀÇ ÆÄÀÏÀ» Á¶ÀÛÇÒ
104     ¼ö Àֱ⶧¹®¿¡, <module>mod_dav</module>¸¦ »ç¿ëÇϱâ Àü¿¡
105     ¼­¹ö°¡ ¾ÈÀüÇÑÁö Æ¯º°È÷ °ü½ÉÀ» °¡Á®¾ß ÇÑ´Ù.</p>
106
107     <p>¼­¹ö¿¡¼­ DAV°¡ °¡´ÉÇÑ À§Ä¡´Â ÀÎÁõÀ¸·Î º¸È£ÇؾߠÇÑ´Ù.
108     HTTP Basic Authentication´Â ÃßõÇÏÁö ¾Ê´Â´Ù. ÃÖ¼ÒÇÑ
109     <module>mod_auth_digest</module> ¸ðµâÀÌ Á¦°øÇϴ HTTP Digest
110     AuthenticationÀ» »ç¿ëÇؾߠÇÑ´Ù. °ÅÀÇ ¸ðµç WebDAV Å¬¶óÀ̾ðÆ®´Â
111     ÀÌ ÀÎÁõ ¹æ½ÄÀ» Áö¿øÇÑ´Ù. ¾Æ´Ï¸é <a href="../ssl/">SSL</a>
112     ¿¬°á¿¡¼­ Basic AuthenticationÀ» »ç¿ëÇÒ ¼öµµ ÀÖ´Ù.</p>
113
114     <p><module>mod_dav</module>°¡ ÆÄÀÏÀ» Á¶ÀÛÇÏ·Á¸é, ¾ÆÆÄÄ¡¸¦
115     ½ÇÇàÇϴ <directive module="mpm_common">User</directive>¿Í
116     <directive module="mpm_common">Group</directive>Àº ÇØ´ç
117     µð·ºÅ丮¿Í ÆÄÀÏ¿¡ ¾²±â ±ÇÇÑÀ» °¡Á®¾ß ÇÑ´Ù. ¶Ç, »õ·Î »ý¼ºÇÑ
118     ÆÄÀÏÀº <directive module="mpm_common">User</directive>¿Í
119     <directive module="mpm_common">Group</directive>ÀÌ ¼ÒÀ¯ÇÏ°Ô
120     µÈ´Ù. ±×·¡¼­ ¾Æ¹«³ª ÀÌ °èÁ¤¿¡ Á¢±ÙÇÒ ¼ö ¾øµµ·Ï Ç϶ó. DAV
121     ÀúÀå¼Ò´Â ¾ÆÆÄÄ¡¸¸ Á¢±ÙÇÒ ¼ö ÀÖ´Ù°í °¡Á¤ÇÑ´Ù. ¾ÆÆÄÄ¡¸¦ ÅëÇÏÁö¾Ê°í
122     (¿¹¸¦ µé¾î FTP³ª ÆÄÀϽýºÅÛ µµ±¸¸¦ »ç¿ëÇÏ¿©) ÆÄÀÏÀ» ¼öÁ¤ÇÔÀ»
123     Çã¿ëÇϸ頾ȵȴÙ.</p>
124
125     <p><module>mod_dav</module>´Â ¿©·¯ ¼­ºñ½º°ÅºÎ °ø°ÝÀÇ ´ë»óÀÌ
126     µÉ ¼ö ÀÖ´Ù. <directive
127     module="core">LimitXMLRequestBody</directive> Áö½Ã¾î¸¦
128     »ç¿ëÇÏ¿© Å« DAV ¿äûÀ» ÀÐÀ»¶§ ¸Þ¸ð¸®·®À» Á¦ÇÑÇÒ ¼ö ÀÖ´Ù.
129     <directive module="mod_dav">DavDepthInfinity</directive>
130     Áö½Ã¾î¸¦ »ç¿ëÇÏ¿© ¸¹Àº ¸Þ¸ð¸®¸¦ ¼Ò¸ðÇϱâÀ§ÇÑ ¸Å¿ì Å« ÀúÀå¼ÒÀÇ
131     <code>PROPFIND</code> ¿äûÀ» ¸·À» ¼ö ÀÖ´Ù. ´Ü¼øÈ÷ Å¬¶óÀ̾ðÆ®°¡
132     ¿©·¯ Å« ÆÄÀϵé·Î µð½ºÅ©°ø°£À» Ã¤¿ì´Â ¼­ºñ½º°ÅºÎ °ø°Ýµµ °¡´ÉÇÏ´Ù.
133     ¾ÆÆÄÄ¡¿¡¼­ À̸¦ ¸·À» Á÷Á¢ÀûÀΠ¹æ¹ýÀº ¾ø´Ù. ±×·¯¹Ç·Î ½Å·ÚÇÏÁö¾Ê´Â
134     »ç¿ëÀÚ¿¡°Ô DAV Á¢±ÙÀ» Çã¿ëÇÏÁö ¾Êµµ·ÏÇ϶ó.</p>
135 </section>
136
137 <section id="complex"><title>º¹ÀâÇÑ ¼³Á¤</title>
138
139     <p>ÀϹÝÀûÀΠÁú¹®Áß Çϳª´Â (PHP ½ºÅ©¸³Æ®, CGI ½ºÅ©¸³Æ® µî)
140     µ¿ÀûÆÄÀÏ ÀÛ¾÷À» À§ÇØ <module>mod_dav</module>¸¦ »ç¿ëÇÏ´Â
141     ¹æ¹ýÀÌ´Ù. À̴ <code>GET</code> ¿äûÀÌ ÆÄÀÏ ³»¿ëÀ» ´Ù¿î·ÎµåÇÏÁö
142     ¾Ê°í Ç׻󠽺ũ¸³Æ®¸¦ ½ÇÇàÇϹǷΠ¾î·Æ´Ù. ÇØ°á¹æ¹ýÁß Çϳª´Â
143     ³»¿ë¿¡ µÎ°³ÀÇ URLÀ» ´ëÀÀÇϴ °ÍÀÌ´Ù. ÇÑ URLÀº ½ºÅ©¸³Æ®¸¦
144     ½ÇÇàÇÏ°í, ´Ù¸¥ URL·Î´Â ÆÄÀÏÀ» ´Ù¿î·ÎµåÇÏ¿© DAV·Î ÀÛ¾÷ÇÒ
145     ¼ö ÀÖ´Ù.</p>
146
147 <example>
148 Alias /phparea /home/gstein/php_files<br />
149 Alias /php-source /home/gstein/php_files<br />
150 &lt;Location /php-source&gt;
151 <indent>
152     DAV On<br />
153     ForceType text/plain<br />
154 </indent>
155 &lt;/Location&gt;
156 </example>
157
158     <p>ÀÌ ¼³Á¤¿¡¼­ <code>http://example.com/phparea</code>´Â
159     PHP ½ºÅ©¸³Æ®ÀÇ °á°ú¸¦ º¸¿©ÁÖ°í,
160     <code>http://example.com/php-source</code>·Î´Â DAV Å¬¶óÀ̾ðÆ®¿¡¼­
161     ½ºÅ©¸³Æ®¸¦ ¼öÁ¤ÇÒ ¼ö ÀÖ´Ù.</p>
162 </section>
163
164 <directivesynopsis>
165 <name>Dav</name>
166 <description>WebDAV HTTP ¸Þ½áµå¸¦ ½ÃÀÛÇÑ´Ù</description>
167 <syntax>Dav On|Off|<var>provider-name</var></syntax>
168 <default>Dav Off</default>
169 <contextlist><context>directory</context></contextlist>
170
171 <usage>
172     <p>ÁöÁ¤ÇÑ À§Ä¡¿¡¼­ WebDAV HTTP ¸Þ½áµå¸¦ »ç¿ëÇÏ·Á¸é
173     <directive>Dav</directive> Áö½Ã¾î¸¦ »ç¿ëÇÑ´Ù:</p>
174
175     <example>
176       &lt;Location /foo&gt;<br />
177       <indent>
178         Dav On<br />
179       </indent>
180       &lt;/Location&gt;
181     </example>
182
183     <p><code>On</code> °ªÀº ½ÇÁ¦·Î <module>mod_dav_fs</module>
184     ¸ðµâÀÌ Á¦°øÇϴ ±âº» Á¦°øÀÚÀΠ<code>filesystem</code>ÀÇ
185     º°ÄªÀÌ´Ù. ¾î¶² À§Ä¡¿¡¼­ DAV¸¦ ½ÃÀÛÇϸé ÇÏÀ§°ø°£¿¡¼­ DAV¸¦
186     »ç¿ë¾ÈÇϵµ·Ï ¼³Á¤ÇÒ ¼ö <em>¾øÀ½À»</em> ÁÖÀÇÇ϶ó. ¿ÏÀüÇÑ
187     ¼³Á¤¿¹´Â <a href="#example">À§ÀÇ Àý</a>À» Âü°íÇ϶ó.</p>
188
189     <note type="warning">
190       ¼­¹ö¸¦ ¾ÈÀüÇÏ°Ô ±¸¼ºÇÒ¶§±îÁö WebDAVÀ» »ç¿ëÇÏÁö ¸¶¶ó. ±×·¸Áö
191       ¾ÊÀ¸¸é ´©±¸¶óµµ ¼­¹ö¸¦ ÅëÇØ ÆÄÀÏÀ» ºÐ¹èÇÒ ¼ö ÀÖ°Ô µÈ´Ù.
192     </note>
193 </usage>
194 </directivesynopsis>
195
196 <directivesynopsis>
197 <name>DavMinTimeout</name>
198 <description>¼­¹ö°¡ DAV ÀÚ¿ø¿¡ ´ëÇØ À¯ÁöÇÒ Àá±ÝÀÇ Ãּҽð£</description>
199 <syntax>DavMinTimeout <var>seconds</var></syntax>
200 <default>DavMinTimeout 0</default>
201 <contextlist><context>server config</context><context>virtual host</context>
202 <context>directory</context></contextlist>
203
204 <usage>
205     <p>Ŭ¶óÀ̾ðÆ®°¡ DAV ÀÚ¿ø¿¡ Àá±Ý(lock)À» ¿äûÇÒ¶§ ¼­¹ö°¡
206     ¾Ë¾Æ¼­ Àá±ÝÀ» Á¦°ÅÇÒ ¼ö Àִ ½Ã°£À» °°ÀÌ ¾Ë·ÁÁÙ ¼ö ÀÖ´Ù. ÀÌ °ªÀº
207     ´ÜÁö ¿äûÀÏ»ÓÀ̸ç, ¼­¹ö´Â Å¬¶óÀ̾ðÆ®°¡ ¿äûÇÑ °ªÀ» ¹«½ÃÇÏ°í
208     Å¬¶óÀ̾ðÆ®¿¡°Ô ÀÓÀÇÀÇ ½Ã°£À» ¾Ë·ÁÁÙ ¼ö ÀÖ´Ù.</p>
209
210     <p><directive>DavMinTimeout</directive> Áö½Ã¾î´Â Å¬¶óÀ̾ðÆ®¿¡°Ô
211     º¸³¾ ÃÖ¼Ò Àá±Ý ½Ã°£À» (ÃÊ´ÜÀ§) ÁöÁ¤ÇÑ´Ù. Microsoft Web Folders´Â
212     ±âº»°ªÀ¸·Î 120 Ãʸ¦ »ç¿ëÇÑ´Ù. <directive>DavMinTimeout</directive>¿¡
213     (600 ÃÊ¿Í °°ÀÌ) ´õ ³ôÀº °ªÀ» »ç¿ëÇϸé Å¬¶óÀ̾ðÆ®°¡ ³×Æ®¿÷
214     Áö¿¬¶§¹®¿¡ Àá±ÝÀ» ÀҰԵǴ °æ¿ì¸¦ ÁÙÀÏ ¼ö ÀÖ´Ù.</p>
215
216     <example><title>¿¹Á¦</title>
217       &lt;Location /MSWord&gt;<br />
218       <indent>
219         DavMinTimeout 600<br />
220       </indent>
221       &lt;/Location&gt;
222     </example>
223 </usage>     
224 </directivesynopsis>
225
226 <directivesynopsis>
227 <name>DavDepthInfinity</name>
228 <description>PROPFINDÀÇ Depth: Infinity ¿äûÀ» Çã°¡ÇÑ´Ù</description>
229 <syntax>DavDepthInfinity on|off</syntax>
230 <default>DavDepthInfinity off</default>
231 <contextlist><context>server config</context><context>virtual host</context>
232 <context>directory</context></contextlist>
233
234 <usage>
235     <p><directive>DavDepthInfinity</directive> Áö½Ã¾î¸¦ »ç¿ëÇϸé
236     'Depth: Infinity' Çì´õ¸¦ °¡Áø <code>PROPFIND</code> ¿äûÀ»
237     Çã°¡ÇÑ´Ù. ÀÌ·± ¿äûÀ» »ç¿ëÇÏ¿© ¼­ºñ½º°ÅºÎ °ø°ÝÀÌ °¡´ÉÇϱâ
238     ¶§¹®¿¡ ±âº»ÀûÀ¸·Î Çã¿ëÇÏÁö ¾Ê´Â´Ù.</p>
239 </usage>
240 </directivesynopsis>
241
242 </modulesynopsis>
243
244