1 <?xml version="1.0" encoding="EUC-KR" ?>
2 <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
4 <!-- English Revision: 151408:420990 (outdated) -->
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
14 http://www.apache.org/licenses/LICENSE-2.0
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.
23 <manualpage metafile="directive-dict.xml.meta">
25 <title>Áö½Ã¾î¸¦ ¼³¸íÇϴµ¥ »ç¿ëÇÑ ¿ë¾îµé</title>
28 <p>ÀÌ ¹®¼´Â ¾ÆÆÄÄ¡ <a href="directives.html">¼³Á¤
29 Áö½Ã¾î</a>¸¦ ¼³¸íÇϴµ¥ »ç¿ëÇÑ ¿ë¾îµéÀ» ¼³¸íÇÑ´Ù.</p>
31 <seealso><a href="../configuring.html">¼³Á¤ÆÄÀÏ</a></seealso>
33 <section id="Description"><title>¼³¸í (Description)</title>
35 <p>Áö½Ã¾îÀÇ ¸ñÀû¿¡ ´ëÇÑ °£´ÜÇÑ ¼³¸í.</p>
38 <section id="Syntax"><title>¹®¹ý (Syntax)</title>
40 <p>¼³Á¤ÆÄÀÏ¿¡¼ »ç¿ëÇÒ Áö½Ã¾îÀÇ Çü½ÄÀ» ¾Ë·ÁÁØ´Ù. ÀÌ ¹®¹ýÀº
41 Áö½Ã¾î¸¶´Ù ¸Å¿ì ´Ù¸£¸ç, Áö½Ã¾î¸¦ Á¤ÀÇÇÒ ¶§¸¶´Ù ÀÚ¼¼È÷ ¼³¸íÇÑ´Ù.
42 ÀϹÝÀûÀ¸·Î Áö½Ã¾î À̸§ µÚ¿¡ °ø¹éÀ¸·Î ±¸ºÐÇÑ ¾Æ±Ô¸ÕÆ®µéÀÌ
43 ³ª¿Â´Ù. ¾Æ±Ô¸ÕÆ®°¡ °ø¹éÀ» Æ÷ÇÔÇÑ´Ù¸é ¾Æ±Ô¸ÕÆ®¸¦ ½Öµû¿ÈÇ¥·Î
44 ¹¾î¾ß ÇÑ´Ù. ¼±ÅÃÀûÀÎ ¾Æ±Ô¸ÕÆ®´Â Áß°ýÈ£·Î ¹´Â´Ù. ¾Æ±Ô¸ÕÆ®°¡
45 ¿©·¯ °ªÁß ÇϳªÀÏ °æ¿ì °ªµéÀ» ¼öÁ÷¸·´ë "|"·Î ±¸ºÐÇÑ´Ù.
46 ¹®ÀÚ±×´ë·Î »ç¿ëÇÒ ºÎºÐÀº ±âº» ¹®ÀÚü·Î ¾²°í, ´ëüÇÒ ¾Æ±Ô¸ÕÆ®´Â
47 <em>°Á¶ÇÑ´Ù</em>. ¾Æ±Ô¸ÕÆ® °³¼ö°¡ Á¤ÇØÁöÁö¾ÊÀº Áö½Ã¾î´Â
48 ¸¶Áö¸· ¾Æ±Ô¸ÕÆ®°¡ ¹Ýº¹µÊÀ» ³ªÅ¸³»´Â "..."À¸·Î ³¡³´Ù.</p>
50 <p>Áö½Ã¾î´Â ¸Å¿ì ´Ù¾çÇÑ Á¾·ùÀÇ ¾Æ±Ô¸ÕÆ®¸¦ ¹Þ´Â´Ù. ÀÌÁß ÀÚÁÖ
51 »ç¿ëÇÏ´Â °ÍÀº ¾Æ·¡¿Í °°´Ù.</p>
56 <dd><code>http://www.example.com/path/to/file.html</code>°ú
57 °°ÀÌ ½ºÅ´(scheme), È£½ºÆ®¸í, ¼±ÅÃÀûÀÎ °æ·Î¸íÀ» Æ÷ÇÔÇÑ
58 ¿ÏÀüÇÑ Uniform Resource Locator</dd>
60 <dt><em>URL-path</em></dt>
62 <dd><code>/path/to/file.html</code>°ú °°ÀÌ <em>url</em>¿¡¼
63 ½ºÅ´°ú È£½ºÆ®¸í µÚ¿¡ ³ª¿À´Â ºÎºÐ. <em>url-path</em>´Â
64 ÆÄÀϽýºÅÛ¿¡¼ º» ½ÃÁ¡ÀÌ ¾Æ´Ñ À¥¿¡¼ º» ½ÃÁ¡¿¡¼ÀÇ ÀڷḦ
67 <dt><em>file-path</em></dt>
69 <dd><code>/usr/local/apache/htdocs/path/to/file.html</code>°ú
70 °°ÀÌ root µð·ºÅ丮·Î ½ÃÀÛÇÏ´Â ÆÄÀϽýºÅÛ»óÀÇ ÆÄÀÏ °æ·Î. µû·Î
71 ¾ð±ÞÇÏÁö¾ÊÀ¸¸é, ½½·¡½¬·Î ½ÃÀÛÇÏÁö¾ÊÀº <em>file-path</em>´Â
72 <a href="core.html#serverroot">ServerRoot</a>¿¡ »ó´ë°æ·Î·Î
75 <dt><em>directory-path</em></dt>
77 <dd><code>/usr/local/apache/htdocs/path/to/</code>¿Í °°ÀÌ
78 root µð·ºÅ丮·Î ½ÃÀÛÇÏ´Â ÆÄÀϽýºÅÛ»óÀÇ µð·ºÅ丮 °æ·Î.</dd>
80 <dt><em>filename</em></dt>
82 <dd><code>file.html</code>°ú °°ÀÌ °æ·Î Á¤º¸°¡ ¾ø´Â ÆÄÀϸí.</dd>
84 <dt><em>regex</em></dt>
86 <dd>Perl Çü½ÄÀÇ <a href="../glossary.html#regex">Á¤±ÔÇ¥Çö½Ä(regular
87 expression)</a>. Áö½Ã¾î´Â <em>regex</em>·Î ¹«¾ùÀΰ¡¸¦ °Ë»öÇÑ´Ù.</dd>
89 <dt><em>extension</em></dt>
91 <dd>ÀϹÝÀûÀ¸·Î <em>filename</em>¿¡¼ ¸¶Áö¸· ¸¶Ä§Ç¥ µÚ¿¡
92 ³ª¿À´Â ºÎºÐÀÌ´Ù. ±×·¯³ª ¾ÆÆÄÄ¡´Â ¿©·¯ È®ÀåÀÚ¸¦ ÀνÄÇÒ
93 ¼ö Àֱ⶧¹®¿¡, <em>filename</em>¿¡ ¸¶Ä§Ç¥°¡ ¿©·¯°³ Æ÷ÇÔµÈ
94 °æ¿ì ¸¶Ä§Ç¥·Î ±¸ºÐµÈ ¸ðµç ºÎºÐÀ» <em>È®ÀåÀÚ(extension)</em>·Î
95 ó¸®ÇÑ´Ù. ¿¹¸¦ µé¾î, <em>ÆÄÀϸí</em> <code>file.html.en</code>Àº
96 <code>.html</code>°ú <code>.en</code>À̶ó´Â µÎ°¡Áö È®ÀåÀÚ¸¦
97 °¡Áø´Ù. ¾ÆÆÄÄ¡ Áö½Ã¾î¿¡¼ <em>extension</em>¿¡ ÁöÁ¤ÇÑ
98 °ª ¾Õ¿¡ ¸¶Ä§Ç¥°¡ À־ µÇ°í ¾ø¾îµµ µÈ´Ù. ¶Ç,
99 <em>extension</em>Àº ´ë¼Ò¹®ÀÚ¸¦ °¡¸®Áö¾Ê´Â´Ù.</dd>
101 <dt><em>MIME-type</em></dt>
103 <dd><code>text/html</code>°ú °°ÀÌ ½½·¡½¬·Î major format
104 type°ú minor format type¸¦ ±¸ºÐÇÏ¿© ÆÄÀÏÀÇ Çü½ÄÀ» ¼³¸íÇÏ´Â
107 <dt><em>env-variable</em></dt>
109 <dd>¾ÆÆÄÄ¡ ¼³Á¤¿¡¼ Á¤ÀÇÇÑ <a href="../env.html">ȯ°æº¯¼ö</a>
110 À̸§. ¿î¿µÃ¼Á¦ÀÇ È¯°æº¯¼ö¿Í ´Ù¸§À» ÁÖÀÇÇ϶ó. ÀÚ¼¼ÇÑ ³»¿ëÀº
111 <a href="../env.html">ȯ°æº¯¼ö ¹®¼</a>¸¦ Âü°íÇ϶ó.</dd>
115 <section id="Default"><title>±âº»°ª (Default)</title>
117 <p>Áö½Ã¾î¿¡ ±âº»°ªÀÌ ÀÖ´Ù¸é (<em>¿¹¸¦ µé¾î</em>, ¼³Á¤¿¡¼
118 Áö½Ã¾î¸¦ »ý·«ÇÑ °æ¿ì ¾ÆÆÄÄ¡ À¥¼¹ö´Â ÀÌ °ªÀ» »ç¿ëÇÑ´Ù.)
119 ÀÌ Ç׸ñ¿¡ ³ª¿Â´Ù. ±âº»°ªÀÌ ¾ø´Ù¸é ÀÌ Ç׸ñÀº
120 "<em>None</em>"À̾î¾ß ÇÑ´Ù. ±âº»°ªÀÌ ¼¹ö¿¡ Æ÷ÇÔµÈ ±âº»
121 httpd.confÀÇ Áö½Ã¾î °ª°ú ´Ù¸¦ ¼ö ÀÖÀ½À» ÁÖÀÇÇ϶ó.</p>
124 <section id="Context"><title>»ç¿ëÀå¼Ò (Context)</title>
126 <p>¼¹öÀÇ ¼³Á¤ÆÄÀÏÁß ¾î´À°÷¿¡¼ Áö½Ã¾î¸¦ »ç¿ëÇÒ ¼ö ÀÖ´ÂÁö
127 ¾Ë·ÁÁØ´Ù. ´ÙÀ½ °ªµéÀ» ½°Ç¥·Î ±¸ºÐÇÑ ¸ñ·ÏÀÌ´Ù:</p>
130 <dt>ÁÖ¼¹ö¼³Á¤ (server config)</dt>
132 <dd>Áö½Ã¾î¸¦ ¼¹ö ¼³Á¤ÆÄÀÏ¿¡¼ (<em>¿¹¸¦ µé¾î</em>,
133 <code>httpd.conf</code>) »ç¿ëÇÒ ¼ö ÀÖÀ¸³ª, <directive
134 module="core" type="section">VirtualHost</directive>³ª
135 <directive module="core" type="section">Directory</directive>¿¡¼
136 »ç¿ëÇÒ ¼ö <strong>¾øÀ½À»</strong> ¶æÇÑ´Ù. ÀÌ Áö½Ã¾î´Â
137 <code>.htaccess</code> ÆÄÀÏ¿¡¼µµ »ç¿ëÇÒ ¼ö ¾ø´Ù.</dd>
139 <dt>°¡»óÈ£½ºÆ® (virtual host)</dt>
141 <dd>Áö½Ã¾î¸¦ ¼¹ö ¼³Á¤ÆÄÀÏÀÇ <directive module="core"
142 type="section">VirtualHost</directive> ¾È¿¡¼ »ç¿ëÇÒ ¼ö
145 <dt>µð·ºÅ丮 (directory)</dt>
147 <dd>Áö½Ã¾î°¡ <a href="../sections.html">¼½¼Ç ¼³Á¤</a>¿¡
148 ¼³¸íÇÑ Á¦¾àÀ» µû¸£¸ç, ¼¹ö ¼³Á¤ÆÄÀÏÀÇ <directive module="core"
149 type="section">Directory</directive>, <directive
150 type="section" module="core">Location</directive>, <directive
151 module="core" type="section">Files</directive>, <directive
152 module="mod_proxy" type="section">Proxy</directive>¿¡¼
153 »ç¿ëÇÒ ¼ö ÀÖÀ½À» ¶æÇÑ´Ù.</dd>
157 <dd>Áö½Ã¾î¸¦ µð·ºÅ丮<em>º°</em> <code>.htaccess</code>
158 ÆÄÀÏ¿¡¼ »ç¿ëÇÒ ¼ö ÀÖÀ½À» ¶æÇÑ´Ù. ÀÌ Áö½Ã¾î´Â ÇöÀç »ç¿ëÇÏ´Â
159 <a href="#Override">overrides</a> °ª¿¡ µû¶ó ¹«½ÃµÉ ¼ö
163 <p>Áö½Ã¾î´Â ÁöÁ¤µÈ Àå¼Ò¿¡¼<em>¸¸</em> »ç¿ëÇÒ ¼ö ÀÖ´Ù. ´Ù¸¥
164 °÷¿¡¼ »ç¿ëÇÏ¸é ¼³Á¤¿À·ù°¡ ¹ß»ýÇÏ°í ¼¹ö´Â ºÎºÐ¿¡ ´ëÇÑ ¿äûÀ»
165 ¿Ã¹Ù·Î ó¸®ÇÏÁö ¸øÇϰųª ÀÛµ¿ÀÌ, <em>¿¹¸¦ µé¾î</em> ½ÃÀÛÁ¶Â÷µµ,
168 <p>Áö½Ã¾î¸¦ »ç¿ëÇÒ ¼ö ÀÖ´Â Àå¼Ò´Â ¿°ÅÇÑ Àå¼Ò¸¦ ¸ðµÎ
169 ºÒ¸°(boolean) ORÇÑ °á°úÀÌ´Ù. Áï,
170 "<code>server config, .htaccess</code>"¿¡¼ °¡´ÉÇÏ´Ù´Â
171 Áö½Ã¾î´Â <code>httpd.conf</code> ÆÄÀÏ°ú <code>.htaccess</code>
172 ÆÄÀÏ¿¡¼´Â »ç¿ëÇÒ ¼ö ÀÖÁö¸¸, <directive module="core"
173 type="section">Directory</directive>³ª <directive module="core"
174 type="section">VirtualHost</directive>¿¡¼´Â »ç¿ëÇÒ ¼ö ¾ø´Ù.</p>
177 <section id="Override"><title>Override ¿É¼Ç (Override)</title>
179 <p>ÀÌ Áö½Ã¾î¸¦ <code>.htaccess</code> ÆÄÀÏ¿¡¼ »ç¿ëÇÏ·Á¸é
180 ¾î¶² override ¿É¼ÇÀ» »ç¿ëÇØ¾ß ÇÏ´ÂÁö¸¦ ³ªÅ¸³½´Ù. Áö½Ã¾îÀÇ
181 <a href="#Context" >»ç¿ëÀå¼Ò</a>°¡ Áö½Ã¾î¸¦ <code>.htaccess</code>
182 ÆÄÀÏ¿¡¼ »ç¿ëÇÒ ¼ö ¾ø´Ù°í ÇÑ´Ù¸é ¾î¶² »ç¿ëÀå¼Òµµ ³ª¿ÀÁö
185 <p>Overrides´Â <directive
186 module="core">AllowOverride</directive> Áö½Ã¾î·Î Áö½ÃÇÏ°í,
187 (µð·ºÅ丮 µîÀÇ) ƯÁ¤ ¹üÀ§¿Í ÇÏÀ§ ¹üÀ§¿¡¼ ´Ù¸¥ <directive
188 module="core">AllowOverride</directive> Áö½Ã¾î·Î ´Ù¸¥ °ªÀ»
189 ¼³Á¤ÇÏÁö¾Ê¾Ò´Ù¸é ÇÏÀ§ ¹üÀ§¿¡µµ ±×´ë·Î Àû¿ëµÈ´Ù. Áö½Ã¾î ¼³¸í¿¡
190 »ç¿ë°¡´ÉÇÑ override À̸§µéÀÌ ³ª¿Â´Ù.</p>
193 <section id="Status"><title>»óÅÂ (Status)</title>
195 <p>Áö½Ã¾î°¡ ¾ÆÆÄÄ¡ À¥¼¹ö¿¡ ¾ó¸¶³ª ±ä¹ÐÈ÷ ¹¿©ÀÖ´ÂÁö¸¦
196 ³ªÅ¸³½´Ù. Áï, ±× Áö½Ã¾î³ª ±â´ÉÀ» »ç¿ëÇϱâÀ§ÇØ ¼¹ö¸¦
197 ¸ðµâ°ú °°ÀÌ ´Ù½Ã ÄÄÆÄÀÏÇÒ ÇÊ¿ä°¡ ÀÖÀ» ¼öµµ ÀÖ´Ù.
198 °¡´ÉÇÑ °ªÀº ´ÙÀ½°ú °°´Ù:</p>
203 <dd>Áö½Ã¾î°¡ "Core" »óŸ¦ °¡Áö¸é, Áö½Ã¾î°¡ ¾ÆÆÄÄ¡ À¥¼¹ö
204 Çٽɺκп¡ ¼ÓÇÏ°í Ç×»ó »ç¿ë°¡´ÉÇÔÀ» ¶æÇÑ´Ù.</dd>
208 <dd>"MPM" »óÅÂÀÎ Áö½Ã¾î´Â <a href="../mpm.html">´ÙÁßó¸®
209 ¸ðµâ</a>À» Á¦°øÇÑ´Ù. ÀÌ·± Áö½Ã¾î´Â Áö½Ã¾î ¼³¸í¿¡¼ <a
210 href="#Module">¸ðµâ</a>¿¡ ¿°ÅµÈ MPMÁß Çϳª¸¦ »ç¿ëÇÒ¶§¸¸
215 <dd>±âº»ÀûÀ¸·Î ¼¹ö¿Í °°ÀÌ ÄÄÆÄÀϵǹǷΠÁ÷Á¢ ±¸¼º¿¡¼
216 ¸ðµâÀ» Á¦°ÅÇÏÁö ¾Ê¾Ò´Ù¸é ÀϹÝÀûÀ¸·Î »ç¿ë°¡´ÉÇÑ Ç¥ÁØ ¾ÆÆÄÄ¡
217 ¸ðµâÀÌ Á¦°øÇÏ´Â Áö½Ã¾î´Â "Base" »óÅÂÀÌ´Ù.</dd>
221 <dd>¾ÆÆÄÄ¡ ¼¹ö ¹èÆ÷º»¿¡´Â Æ÷ÇÔµÇÀÖÁö¸¸ º¸Åë ¼¹ö¿Í °°ÀÌ
222 ÄÄÆÄÀϵÇÁö¾Ê´Â ¸ðµâÀÌ Á¦°øÇÏ´Â Áö½Ã¾î´Â "Extension" »óÅÂÀÌ´Ù.
223 ÀÌ·± Áö½Ã¾î¸¦ »ç¿ëÇÏ·Á¸é ¼¹ö ÄÄÆÄÀÏ ±¸¼ºÆÄÀÏÀ» ¼öÁ¤ÇÏ°í
224 ¾ÆÆÄÄ¡¸¦ ´Ù½Ã ÄÄÆÄÀÏÇØ¾ß ÇÑ´Ù.</dd>
226 <dt>Experimental</dt>
228 <dd>"Experimental"Àº Áö½Ã¾î°¡ ¾ÆÆÄÄ¡ ¹èÆ÷º»¿¡ Æ÷ÇÔµÇÀÖÁö¸¸,
229 »ç¿ëÀº ÀÚ½ÅÀÇ Ã¥ÀÓÀÓÀ» ³ªÅ¸³½´Ù. Áö½Ã¾î´Â ¹®¼ÈµÇÀÖÁö¸¸,
230 ½ÇÁ¦¿Í ´Ù¸¦ ¼ö ÀÖ´Ù. Áö½Ã¾î¸¦ Á¦°øÇÏ´Â ¸ðµâÀº ±âº»ÀûÀ¸·Î
231 ¾ÆÆÄÄ¡¿Í °°ÀÌ ÄÄÆÄÀ쵃 ¼öµµ ¾ÈµÉ ¼öµµ ÀÖ´Ù. Áö½Ã¾î¿Í ¸ðµâÀ»
232 ¼³¸íÇÏ´Â ¹®¼ ¾Õ¿¡¼ »ç¿ëÇÒ ¼ö ÀÖ´ÂÁö »ìÆìºÁ¶ó.</dd>
236 <section id="Module"><title>¸ðµâ (Module)</title>
238 <p>´Ü¼øÈ÷ Áö½Ã¾î¸¦ Á¤ÀÇÇÑ ¼Ò½º ¸ðµâ¸íÀ» ¿°ÅÇÑ´Ù.</p>
241 <section id="Compatibility"><title>Áö¿ø (Compatibility)</title>
243 <p>Áö½Ã¾î°¡ ¿ø·¡ ¾ÆÆÄÄ¡ ¹öÀü 2 ¹èÆ÷º»ÀÇ ÀϺΰ¡ ¾Æ´Ï¿´´Ù¸é,
244 Áö½Ã¾î¸¦ Ãß°¡Çϱ⠽ÃÀÛÇÑ ¹öÀüÀÌ ¿©±â ³ª¿Â´Ù. ¶Ç, ¾î¶²
245 Ç÷¡Æû¿¡¼¸¸ »ç¿ë°¡´ÉÇÑ Áö½Ã¾îµµ ¿©±â ³ª¿Â´Ù.</p>