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: 1.8 -->
7 Copyright 2003-2004 The Apache Software Foundation
9 Licensed under the Apache License, Version 2.0 (the "License");
10 you may not use this file except in compliance with the License.
11 You may obtain a copy of the License at
13 http://www.apache.org/licenses/LICENSE-2.0
15 Unless required by applicable law or agreed to in writing, software
16 distributed under the License is distributed on an "AS IS" BASIS,
17 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
18 See the License for the specific language governing permissions and
19 limitations under the License.
22 <modulesynopsis metafile="mod_dav.xml.meta">
25 <description>Distributed Authoring and Versioning
26 (<a href="http://www.webdav.org/">WebDAV</a>) ±â´É</description>
27 <status>Extension</status>
28 <sourcefile>mod_dav.c</sourcefile>
29 <identifier>dav_module</identifier>
32 <p>ÀÌ ¸ðµâÀº ¾ÆÆÄÄ¡¿¡ <a href="http://www.webdav.org">WebDAV</a>
33 ('Web-based Distributed Authoring and Versioning') class 1°ú
34 class 2 ±â´ÉÀ» Ãß°¡ÇÑ´Ù. WebDAV´Â ¿ø°Ý À¥¼¹öÀÇ ÀÚ¿ø°ú
35 ÄÝ·º¼Ç(collection)À» <transnote>ÄÝ·º¼ÇÀº ÆÄÀϽýºÅÛÀÇ µð·ºÅ丮¿Í
36 °°Àº °³³äÀÌ´Ù</transnote> ¸¸µé°í, ¿Å±â°í, º¹»çÇÏ°í, Áö¿ï
37 ¼ö ÀÖµµ·Ï HTTP ÇÁ·ÎÅäÄÝÀ» È®ÀåÇÑ °ÍÀÌ´Ù.</p>
39 <seealso><directive module="mod_dav_fs">DavLockDB</directive></seealso>
40 <seealso><directive module="core">LimitXMLRequestBody</directive></seealso>
41 <seealso><a href="http://www.webdav.org">WebDAV Á¤º¸</a></seealso>
43 <section id="example"><title>WebDAV »ç¿ëÇϱâ</title>
44 <p><module>mod_dav</module>¸¦ »ç¿ëÇÏ·Á¸é <code>httpd.conf</code>
45 ÆÄÀÏ¿¡ ¾Æ·¡°ú °°ÀÌ Ãß°¡ÇÑ´Ù:</p>
47 <example>Dav On</example>
49 <p>±×·¯¸é <module>mod_dav_fs</module> ¸ðµâÀÌ ±¸ÇöÇÏ´Â DAV
50 ÆÄÀϽýºÅÛ Á¦°øÀÚ(provider)¸¦ »ç¿ëÇÑ´Ù. ±×·¯¹Ç·Î ÀÌ ¸ðµâµµ
51 ¼¹ö¿¡ °°ÀÌ ÄÄÆÄÀϵÇÀְųª <directive
52 module="mod_so">LoadModule</directive> Áö½Ã¾î·Î ½ÇÇàÁß¿¡
55 <p>¶Ç, DAV Àá±Ý(lock) µ¥ÀÌÅͺ£À̽ºÀÇ À§Ä¡¸¦ <code>httpd.conf</code>
56 ÆÄÀÏÀÇ Àü¿ª ºÎºÐ¿¡ <directive
57 module="mod_dav_fs">DavLockDB</directive> Áö½Ã¾î¸¦ »ç¿ëÇÏ¿©
61 DavLockDB /usr/local/apache2/var/DavLock
64 <p>¾ÆÆÄÄ¡¸¦ ½ÇÇàÇÏ´Â <directive
65 module="mpm_common">User</directive>¿Í <directive
66 module="mpm_common" >Group</directive>Àº Àá±Ý µ¥ÀÌÅͺ£À̽º°¡
67 ÀÖ´Â µð·ºÅ丮¿¡ ¾²±â ±ÇÇÑÀ» °¡Á®¾ß ÇÑ´Ù.</p>
69 <p>DAV¸¦ »ç¿ëÇÏ´Â À§Ä¡¿¡ Á¢±ÙÀ» Á¦ÇÑÇϱâÀ§ÇØ <directive
70 module="core" type="section">Location</directive> Áö½Ã¾î
71 ¾È¿¡ <directive module="core" type="section">Limit</directive>
72 Áö½Ã¾î¸¦ »ç¿ëÇÒ ¼ö ÀÖ´Ù. DAV Ŭ¶óÀ̾ðÆ®°¡ ÇѹøÀÇ ¿äû¿¡
73 º¸³¾ ¼ö ÀÖ´Â ÃÖ´ë ¹ÙÀÌÆ®¼ö¸¦ Á¦ÇÑÇÏ·Á¸é <directive
74 module="core">LimitXMLRequestBody</directive> Áö½Ã¾î¸¦ »ç¿ëÇÑ´Ù.
75 "ÀϹÝÀûÀÎ" <directive module="core">LimitRequestBody</directive>
76 Áö½Ã¾î´Â DAV ¿äû°ú °ü°è¾ø´Ù.</p>
78 <example><title>Àüü ¿¹Á¦</title>
79 DavLockDB /usr/local/apache2/var/DavLock<br />
81 <Location /foo><br />
87 AuthUserFile user.passwd<br />
89 <LimitExcept GET OPTIONS><br />
91 require user admin<br />
93 </LimitExcept><br />
95 </Location><br />
98 <p><module>mod_dav</module>´Â Greg SteinÀÌ ¸¸µç <a
99 href="http://www.webdav.org/mod_dav/">Apache 1.3¿ë mod_dav</a>¸¦
100 ±â¹ÝÀ¸·Î ¸¸µé¾ú´Ù. ¸ðµâ¿¡ ´ëÇÑ ´õ ÀÚ¼¼ÇÑ Á¤º¸´Â ±× »çÀÌÆ®¸¦
104 <section id="security"><title>º¸¾È ¹®Á¦</title>
106 <p>DAV¸¦ »ç¿ëÇÏ¸é ¿ø°Ý Ŭ¶óÀ̾ðÆ®°¡ ¼¹öÀÇ ÆÄÀÏÀ» Á¶ÀÛÇÒ
107 ¼ö Àֱ⶧¹®¿¡, <module>mod_dav</module>¸¦ »ç¿ëÇϱâ Àü¿¡
108 ¼¹ö°¡ ¾ÈÀüÇÑÁö Ưº°È÷ °ü½ÉÀ» °¡Á®¾ß ÇÑ´Ù.</p>
110 <p>¼¹ö¿¡¼ DAV°¡ °¡´ÉÇÑ À§Ä¡´Â ÀÎÁõÀ¸·Î º¸È£ÇØ¾ß ÇÑ´Ù.
111 HTTP Basic Authentication´Â ÃßõÇÏÁö ¾Ê´Â´Ù. ÃÖ¼ÒÇÑ
112 <module>mod_auth_digest</module> ¸ðµâÀÌ Á¦°øÇÏ´Â HTTP Digest
113 AuthenticationÀ» »ç¿ëÇØ¾ß ÇÑ´Ù. °ÅÀÇ ¸ðµç WebDAV Ŭ¶óÀ̾ðÆ®´Â
114 ÀÌ ÀÎÁõ ¹æ½ÄÀ» Áö¿øÇÑ´Ù. ¾Æ´Ï¸é <a href="../ssl/">SSL</a>
115 ¿¬°á¿¡¼ Basic AuthenticationÀ» »ç¿ëÇÒ ¼öµµ ÀÖ´Ù.</p>
117 <p><module>mod_dav</module>°¡ ÆÄÀÏÀ» Á¶ÀÛÇÏ·Á¸é, ¾ÆÆÄÄ¡¸¦
118 ½ÇÇàÇÏ´Â <directive module="mpm_common">User</directive>¿Í
119 <directive module="mpm_common">Group</directive>Àº ÇØ´ç
120 µð·ºÅ丮¿Í ÆÄÀÏ¿¡ ¾²±â ±ÇÇÑÀ» °¡Á®¾ß ÇÑ´Ù. ¶Ç, »õ·Î »ý¼ºÇÑ
121 ÆÄÀÏÀº <directive module="mpm_common">User</directive>¿Í
122 <directive module="mpm_common">Group</directive>ÀÌ ¼ÒÀ¯ÇÏ°Ô
123 µÈ´Ù. ±×·¡¼ ¾Æ¹«³ª ÀÌ °èÁ¤¿¡ Á¢±ÙÇÒ ¼ö ¾øµµ·Ï Ç϶ó. DAV
124 ÀúÀå¼Ò´Â ¾ÆÆÄÄ¡¸¸ Á¢±ÙÇÒ ¼ö ÀÖ´Ù°í °¡Á¤ÇÑ´Ù. ¾ÆÆÄÄ¡¸¦ ÅëÇÏÁö¾Ê°í
125 (¿¹¸¦ µé¾î FTP³ª ÆÄÀϽýºÅÛ µµ±¸¸¦ »ç¿ëÇÏ¿©) ÆÄÀÏÀ» ¼öÁ¤ÇÔÀ»
128 <p><module>mod_dav</module>´Â ¿©·¯ ¼ºñ½º°ÅºÎ °ø°ÝÀÇ ´ë»óÀÌ
129 µÉ ¼ö ÀÖ´Ù. <directive
130 module="core">LimitXMLRequestBody</directive> Áö½Ã¾î¸¦
131 »ç¿ëÇÏ¿© Å« DAV ¿äûÀ» ÀÐÀ»¶§ ¸Þ¸ð¸®·®À» Á¦ÇÑÇÒ ¼ö ÀÖ´Ù.
132 <directive module="mod_dav">DavDepthInfinity</directive>
133 Áö½Ã¾î¸¦ »ç¿ëÇÏ¿© ¸¹Àº ¸Þ¸ð¸®¸¦ ¼Ò¸ðÇϱâÀ§ÇÑ ¸Å¿ì Å« ÀúÀå¼ÒÀÇ
134 <code>PROPFIND</code> ¿äûÀ» ¸·À» ¼ö ÀÖ´Ù. ´Ü¼øÈ÷ Ŭ¶óÀ̾ðÆ®°¡
135 ¿©·¯ Å« ÆÄÀϵé·Î µð½ºÅ©°ø°£À» ä¿ì´Â ¼ºñ½º°ÅºÎ °ø°Ýµµ °¡´ÉÇÏ´Ù.
136 ¾ÆÆÄÄ¡¿¡¼ À̸¦ ¸·À» Á÷Á¢ÀûÀÎ ¹æ¹ýÀº ¾ø´Ù. ±×·¯¹Ç·Î ½Å·ÚÇÏÁö¾Ê´Â
137 »ç¿ëÀÚ¿¡°Ô DAV Á¢±ÙÀ» Çã¿ëÇÏÁö ¾Êµµ·ÏÇ϶ó.</p>
140 <section id="complex"><title>º¹ÀâÇÑ ¼³Á¤</title>
142 <p>ÀϹÝÀûÀÎ Áú¹®Áß Çϳª´Â (PHP ½ºÅ©¸³Æ®, CGI ½ºÅ©¸³Æ® µî)
143 µ¿ÀûÆÄÀÏ ÀÛ¾÷À» À§ÇØ <module>mod_dav</module>¸¦ »ç¿ëÇÏ´Â
144 ¹æ¹ýÀÌ´Ù. ÀÌ´Â <code>GET</code> ¿äûÀÌ ÆÄÀÏ ³»¿ëÀ» ´Ù¿î·ÎµåÇÏÁö
145 ¾Ê°í Ç×»ó ½ºÅ©¸³Æ®¸¦ ½ÇÇàÇϹǷΠ¾î·Æ´Ù. ÇØ°á¹æ¹ýÁß Çϳª´Â
146 ³»¿ë¿¡ µÎ°³ÀÇ URLÀ» ´ëÀÀÇÏ´Â °ÍÀÌ´Ù. ÇÑ URLÀº ½ºÅ©¸³Æ®¸¦
147 ½ÇÇàÇÏ°í, ´Ù¸¥ URL·Î´Â ÆÄÀÏÀ» ´Ù¿î·ÎµåÇÏ¿© DAV·Î ÀÛ¾÷ÇÒ
151 Alias /phparea /home/gstein/php_files<br />
152 Alias /php-source /home/gstein/php_files<br />
153 <Location /php-source>
156 ForceType text/plain<br />
161 <p>ÀÌ ¼³Á¤¿¡¼ <code>http://example.com/phparea</code>´Â
162 PHP ½ºÅ©¸³Æ®ÀÇ °á°ú¸¦ º¸¿©ÁÖ°í,
163 <code>http://example.com/php-source</code>·Î´Â DAV Ŭ¶óÀ̾ðÆ®¿¡¼
164 ½ºÅ©¸³Æ®¸¦ ¼öÁ¤ÇÒ ¼ö ÀÖ´Ù.</p>
169 <description>WebDAV HTTP ¸Þ½áµå¸¦ ½ÃÀÛÇÑ´Ù</description>
170 <syntax>Dav On|Off|<var>provider-name</var></syntax>
171 <default>Dav Off</default>
172 <contextlist><context>directory</context></contextlist>
175 <p>ÁöÁ¤ÇÑ À§Ä¡¿¡¼ WebDAV HTTP ¸Þ½áµå¸¦ »ç¿ëÇÏ·Á¸é
176 <directive>Dav</directive> Áö½Ã¾î¸¦ »ç¿ëÇÑ´Ù:</p>
179 <Location /foo><br />
186 <p><code>On</code> °ªÀº ½ÇÁ¦·Î <module>mod_dav_fs</module>
187 ¸ðµâÀÌ Á¦°øÇÏ´Â ±âº» Á¦°øÀÚÀÎ <code>filesystem</code>ÀÇ
188 º°ÄªÀÌ´Ù. ¾î¶² À§Ä¡¿¡¼ DAV¸¦ ½ÃÀÛÇϸé ÇÏÀ§°ø°£¿¡¼ DAV¸¦
189 »ç¿ë¾ÈÇϵµ·Ï ¼³Á¤ÇÒ ¼ö <em>¾øÀ½À»</em> ÁÖÀÇÇ϶ó. ¿ÏÀüÇÑ
190 ¼³Á¤¿¹´Â <a href="#example">À§ÀÇ Àý</a>À» Âü°íÇ϶ó.</p>
192 <note type="warning">
193 ¼¹ö¸¦ ¾ÈÀüÇÏ°Ô ±¸¼ºÇÒ¶§±îÁö WebDAVÀ» »ç¿ëÇÏÁö ¸¶¶ó. ±×·¸Áö
194 ¾ÊÀ¸¸é ´©±¸¶óµµ ¼¹ö¸¦ ÅëÇØ ÆÄÀÏÀ» ºÐ¹èÇÒ ¼ö ÀÖ°Ô µÈ´Ù.
200 <name>DavMinTimeout</name>
201 <description>¼¹ö°¡ DAV ÀÚ¿ø¿¡ ´ëÇØ À¯ÁöÇÒ Àá±ÝÀÇ Ãּҽð£</description>
202 <syntax>DavMinTimeout <var>seconds</var></syntax>
203 <default>DavMinTimeout 0</default>
204 <contextlist><context>server config</context><context>virtual host</context>
205 <context>directory</context></contextlist>
208 <p>Ŭ¶óÀ̾ðÆ®°¡ DAV ÀÚ¿ø¿¡ Àá±Ý(lock)À» ¿äûÇÒ¶§ ¼¹ö°¡
209 ¾Ë¾Æ¼ Àá±ÝÀ» Á¦°ÅÇÒ ¼ö ÀÖ´Â ½Ã°£À» °°ÀÌ ¾Ë·ÁÁÙ ¼ö ÀÖ´Ù. ÀÌ °ªÀº
210 ´ÜÁö ¿äûÀÏ»ÓÀ̸ç, ¼¹ö´Â Ŭ¶óÀ̾ðÆ®°¡ ¿äûÇÑ °ªÀ» ¹«½ÃÇÏ°í
211 Ŭ¶óÀ̾ðÆ®¿¡°Ô ÀÓÀÇÀÇ ½Ã°£À» ¾Ë·ÁÁÙ ¼ö ÀÖ´Ù.</p>
213 <p><directive>DavMinTimeout</directive> Áö½Ã¾î´Â Ŭ¶óÀ̾ðÆ®¿¡°Ô
214 º¸³¾ ÃÖ¼Ò Àá±Ý ½Ã°£À» (ÃÊ´ÜÀ§) ÁöÁ¤ÇÑ´Ù. Microsoft Web Folders´Â
215 ±âº»°ªÀ¸·Î 120 Ãʸ¦ »ç¿ëÇÑ´Ù. <directive>DavMinTimeout</directive>¿¡
216 (600 ÃÊ¿Í °°ÀÌ) ´õ ³ôÀº °ªÀ» »ç¿ëÇϸé Ŭ¶óÀ̾ðÆ®°¡ ³×Æ®¿÷
217 Áö¿¬¶§¹®¿¡ Àá±ÝÀ» ÀҰԵǴ °æ¿ì¸¦ ÁÙÀÏ ¼ö ÀÖ´Ù.</p>
219 <example><title>¿¹Á¦</title>
220 <Location /MSWord><br />
222 DavMinTimeout 600<br />
230 <name>DavDepthInfinity</name>
231 <description>PROPFINDÀÇ Depth: Infinity ¿äûÀ» Çã°¡ÇÑ´Ù</description>
232 <syntax>DavDepthInfinity on|off</syntax>
233 <default>DavDepthInfinity off</default>
234 <contextlist><context>server config</context><context>virtual host</context>
235 <context>directory</context></contextlist>
238 <p><directive>DavDepthInfinity</directive> Áö½Ã¾î¸¦ »ç¿ëÇϸé
239 'Depth: Infinity' Çì´õ¸¦ °¡Áø <code>PROPFIND</code> ¿äûÀ»
240 Çã°¡ÇÑ´Ù. ÀÌ·± ¿äûÀ» »ç¿ëÇÏ¿© ¼ºñ½º°ÅºÎ °ø°ÝÀÌ °¡´ÉÇϱâ
241 ¶§¹®¿¡ ±âº»ÀûÀ¸·Î Çã¿ëÇÏÁö ¾Ê´Â´Ù.</p>