1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
|
<?xml version="1.0" encoding="EUC-KR" ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
<!-- English Revision: 151408:420990 (outdated) -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<manualpage metafile="directive-dict.xml.meta">
<title>지시어를 설명하는데 사용한 용어들</title>
<summary>
<p>이 문서는 아파치 <a href="directives.html">설정
지시어</a>를 설명하는데 사용한 용어들을 설명한다.</p>
</summary>
<seealso><a href="../configuring.html">설정파일</a></seealso>
<section id="Description"><title>설명 (Description)</title>
<p>지시어의 목적에 대한 간단한 설명.</p>
</section>
<section id="Syntax"><title>문법 (Syntax)</title>
<p>설정파일에서 사용할 지시어의 형식을 알려준다. 이 문법은
지시어마다 매우 다르며, 지시어를 정의할 때마다 자세히 설명한다.
일반적으로 지시어 이름 뒤에 공백으로 구분한 아규먼트들이
나온다. 아규먼트가 공백을 포함한다면 아규먼트를 쌍따옴표로
묶어야 한다. 선택적인 아규먼트는 중괄호로 묶는다. 아규먼트가
여러 값중 하나일 경우 값들을 수직막대 "|"로 구분한다.
문자그대로 사용할 부분은 기본 문자체로 쓰고, 대체할 아규먼트는
<em>강조한다</em>. 아규먼트 개수가 정해지지않은 지시어는
마지막 아규먼트가 반복됨을 나타내는 "..."으로 끝난다.</p>
<p>지시어는 매우 다양한 종류의 아규먼트를 받는다. 이중 자주
사용하는 것은 아래와 같다.</p>
<dl>
<dt><em>URL</em></dt>
<dd><code>http://www.example.com/path/to/file.html</code>과
같이 스킴(scheme), 호스트명, 선택적인 경로명을 포함한
완전한 Uniform Resource Locator</dd>
<dt><em>URL-path</em></dt>
<dd><code>/path/to/file.html</code>과 같이 <em>url</em>에서
스킴과 호스트명 뒤에 나오는 부분. <em>url-path</em>는
파일시스템에서 본 시점이 아닌 웹에서 본 시점에서의 자료를
나타낸다.</dd>
<dt><em>file-path</em></dt>
<dd><code>/usr/local/apache/htdocs/path/to/file.html</code>과
같이 root 디렉토리로 시작하는 파일시스템상의 파일 경로. 따로
언급하지않으면, 슬래쉬로 시작하지않은 <em>file-path</em>는
<a href="core.html#serverroot">ServerRoot</a>에 상대경로로
취급한다.</dd>
<dt><em>directory-path</em></dt>
<dd><code>/usr/local/apache/htdocs/path/to/</code>와 같이
root 디렉토리로 시작하는 파일시스템상의 디렉토리 경로.</dd>
<dt><em>filename</em></dt>
<dd><code>file.html</code>과 같이 경로 정보가 없는 파일명.</dd>
<dt><em>regex</em></dt>
<dd>Perl 형식의 <a href="../glossary.html#regex">정규표현식(regular
expression)</a>. 지시어는 <em>regex</em>로 무엇인가를 검색한다.</dd>
<dt><em>extension</em></dt>
<dd>일반적으로 <em>filename</em>에서 마지막 마침표 뒤에
나오는 부분이다. 그러나 아파치는 여러 확장자를 인식할
수 있기때문에, <em>filename</em>에 마침표가 여러개 포함된
경우 마침표로 구분된 모든 부분을 <em>확장자(extension)</em>로
처리한다. 예를 들어, <em>파일명</em> <code>file.html.en</code>은
<code>.html</code>과 <code>.en</code>이라는 두가지 확장자를
가진다. 아파치 지시어에서 <em>extension</em>에 지정한
값 앞에 마침표가 있어도 되고 없어도 된다. 또,
<em>extension</em>은 대소문자를 가리지않는다.</dd>
<dt><em>MIME-type</em></dt>
<dd><code>text/html</code>과 같이 슬래쉬로 major format
type과 minor format type를 구분하여 파일의 형식을 설명하는
방식.</dd>
<dt><em>env-variable</em></dt>
<dd>아파치 설정에서 정의한 <a href="../env.html">환경변수</a>
이름. 운영체제의 환경변수와 다름을 주의하라. 자세한 내용은
<a href="../env.html">환경변수 문서</a>를 참고하라.</dd>
</dl>
</section>
<section id="Default"><title>기본값 (Default)</title>
<p>지시어에 기본값이 있다면 (<em>예를 들어</em>, 설정에서
지시어를 생략한 경우 아파치 웹서버는 이 값을 사용한다.)
이 항목에 나온다. 기본값이 없다면 이 항목은
"<em>None</em>"이어야 한다. 기본값이 서버에 포함된 기본
httpd.conf의 지시어 값과 다를 수 있음을 주의하라.</p>
</section>
<section id="Context"><title>사용장소 (Context)</title>
<p>서버의 설정파일중 어느곳에서 지시어를 사용할 수 있는지
알려준다. 다음 값들을 쉼표로 구분한 목록이다:</p>
<dl>
<dt>주서버설정 (server config)</dt>
<dd>지시어를 서버 설정파일에서 (<em>예를 들어</em>,
<code>httpd.conf</code>) 사용할 수 있으나, <directive
module="core" type="section">VirtualHost</directive>나
<directive module="core" type="section">Directory</directive>에서
사용할 수 <strong>없음을</strong> 뜻한다. 이 지시어는
<code>.htaccess</code> 파일에서도 사용할 수 없다.</dd>
<dt>가상호스트 (virtual host)</dt>
<dd>지시어를 서버 설정파일의 <directive module="core"
type="section">VirtualHost</directive> 안에서 사용할 수
있음을 뜻한다.</dd>
<dt>디렉토리 (directory)</dt>
<dd>지시어가 <a href="../sections.html">섹션 설정</a>에
설명한 제약을 따르며, 서버 설정파일의 <directive module="core"
type="section">Directory</directive>, <directive
type="section" module="core">Location</directive>, <directive
module="core" type="section">Files</directive>, <directive
module="mod_proxy" type="section">Proxy</directive>에서
사용할 수 있음을 뜻한다.</dd>
<dt>.htaccess</dt>
<dd>지시어를 디렉토리<em>별</em> <code>.htaccess</code>
파일에서 사용할 수 있음을 뜻한다. 이 지시어는 현재 사용하는
<a href="#Override">overrides</a> 값에 따라 무시될 수
있다.</dd>
</dl>
<p>지시어는 지정된 장소에서<em>만</em> 사용할 수 있다. 다른
곳에서 사용하면 설정오류가 발생하고 서버는 부분에 대한 요청을
올바로 처리하지 못하거나 작동이, <em>예를 들어</em> 시작조차도,
안될 수 있다.</p>
<p>지시어를 사용할 수 있는 장소는 열거한 장소를 모두
불린(boolean) OR한 결과이다. 즉,
"<code>server config, .htaccess</code>"에서 가능하다는
지시어는 <code>httpd.conf</code> 파일과 <code>.htaccess</code>
파일에서는 사용할 수 있지만, <directive module="core"
type="section">Directory</directive>나 <directive module="core"
type="section">VirtualHost</directive>에서는 사용할 수 없다.</p>
</section>
<section id="Override"><title>Override 옵션 (Override)</title>
<p>이 지시어를 <code>.htaccess</code> 파일에서 사용하려면
어떤 override 옵션을 사용해야 하는지를 나타낸다. 지시어의
<a href="#Context" >사용장소</a>가 지시어를 <code>.htaccess</code>
파일에서 사용할 수 없다고 한다면 어떤 사용장소도 나오지
않는다.</p>
<p>Overrides는 <directive
module="core">AllowOverride</directive> 지시어로 지시하고,
(디렉토리 등의) 특정 범위와 하위 범위에서 다른 <directive
module="core">AllowOverride</directive> 지시어로 다른 값을
설정하지않았다면 하위 범위에도 그대로 적용된다. 지시어 설명에
사용가능한 override 이름들이 나온다.</p>
</section>
<section id="Status"><title>상태 (Status)</title>
<p>지시어가 아파치 웹서버에 얼마나 긴밀히 묶여있는지를
나타낸다. 즉, 그 지시어나 기능을 사용하기위해 서버를
모듈과 같이 다시 컴파일할 필요가 있을 수도 있다.
가능한 값은 다음과 같다:</p>
<dl>
<dt>Core</dt>
<dd>지시어가 "Core" 상태를 가지면, 지시어가 아파치 웹서버
핵심부분에 속하고 항상 사용가능함을 뜻한다.</dd>
<dt>MPM</dt>
<dd>"MPM" 상태인 지시어는 <a href="../mpm.html">다중처리
모듈</a>을 제공한다. 이런 지시어는 지시어 설명에서 <a
href="#Module">모듈</a>에 열거된 MPM중 하나를 사용할때만
가능하다.</dd>
<dt>Base</dt>
<dd>기본적으로 서버와 같이 컴파일되므로 직접 구성에서
모듈을 제거하지 않았다면 일반적으로 사용가능한 표준 아파치
모듈이 제공하는 지시어는 "Base" 상태이다.</dd>
<dt>Extension</dt>
<dd>아파치 서버 배포본에는 포함되있지만 보통 서버와 같이
컴파일되지않는 모듈이 제공하는 지시어는 "Extension" 상태이다.
이런 지시어를 사용하려면 서버 컴파일 구성파일을 수정하고
아파치를 다시 컴파일해야 한다.</dd>
<dt>Experimental</dt>
<dd>"Experimental"은 지시어가 아파치 배포본에 포함되있지만,
사용은 자신의 책임임을 나타낸다. 지시어는 문서화되있지만,
실제와 다를 수 있다. 지시어를 제공하는 모듈은 기본적으로
아파치와 같이 컴파일될 수도 안될 수도 있다. 지시어와 모듈을
설명하는 문서 앞에서 사용할 수 있는지 살펴봐라.</dd>
</dl>
</section>
<section id="Module"><title>모듈 (Module)</title>
<p>단순히 지시어를 정의한 소스 모듈명을 열거한다.</p>
</section>
<section id="Compatibility"><title>지원 (Compatibility)</title>
<p>지시어가 원래 아파치 버전 2 배포본의 일부가 아니였다면,
지시어를 추가하기 시작한 버전이 여기 나온다. 또, 어떤
플래폼에서만 사용가능한 지시어도 여기 나온다.</p>
</section>
</manualpage>
|
