docs/manual/mod/mod_expires.xml.ko


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

<?xml version="1.0" encoding="EUC-KR" ?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
<!-- English Revision: 420990:1334016 (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.
-->

<modulesynopsis metafile="mod_expires.xml.meta">

<name>mod_expires</name>
<description>사용자가 지정한 기준에 따라 <code>Expires</code>와
<code>Cache-Control</code> HTTP 헤더를 생성한다</description>
<status>Extension</status>
<sourcefile>mod_expires.c</sourcefile>
<identifier>expires_module</identifier>

<summary>
    <p>이 모듈은 서버 응답의 <code>Expires</code> HTTP 헤더와
    <code>Cache-Control</code> HTTP 헤더의 <code>max-age</code>
    지시어 설정을 조절한다. 만기일을 파일이 마직막 수정된 시간
    혹은 클라이언트가 접속한 시간에 상대적으로 설정할 수 있다.</p>

    <p>이 HTTP 헤더들은 클라이언트에게 문서의
    유효성과 지속성을 알려준다. 이 시간이 아직 지나지않았다면,
    문서를 캐쉬에서 가져와도 된다. 만기일이 지났다면 캐쉬된
    것을 "만료되고" 유효하지 않다고 간주하여, 소스에서 문서를
    새로 얻어와야 한다.</p>

    <p><directive module="mod_headers">Header</directive> 지시어를
    사용하여 <code>max-age</code> 외의 다른
    <code>Cache-Control</code> 지시어(<a
    href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9">RFC
    2616, 14.9 절</a> 참고)를 수정할 수 있다.</p>

</summary>

<section id="AltSyn"><title>다른 내부 문법</title>
    <p><directive module="mod_expires">ExpiresDefault</directive>와
    <directive module="mod_expires">ExpiresByType</directive>
    지시어를 더 읽기 좋은 형식으로 기술할 수 있다:</p>

    <example>
      ExpiresDefault "&lt;base&gt; [plus] {&lt;num&gt;
      &lt;type&gt;}*"<br />
      ExpiresByType type/encoding "&lt;base&gt; [plus]
      {&lt;num&gt; &lt;type&gt;}*"
    </example>

    <p>&lt;base&gt;는 다음중 하나이다:</p>

    <ul>
      <li><code>access</code></li>

      <li><code>now</code> ('<code>access</code>'와 같음)</li>

      <li><code>modification</code></li>
    </ul>

    <p><code>plus</code> 키워드는 없어도 된다. &lt;num&gt;은
    [<code>atoi()</code>에 사용할 수 있는] 정수값이다.
    &lt;type&gt;은 다음중 하나이다:</p>

    <ul>
      <li><code>years</code></li>
      <li><code>months</code></li>
      <li><code>weeks</code></li>
      <li><code>days</code></li>
      <li><code>hours</code></li>
      <li><code>minutes</code></li>
      <li><code>seconds</code></li>
    </ul>

    <p>예를 들어, 다음 모두는 문서가 기본적으로 접속된지 1달후에
    만기된다고 설정한다:</p>

    <example>
      ExpiresDefault "access plus 1 month"<br />
      ExpiresDefault "access plus 4 weeks"<br />
      ExpiresDefault "access plus 30 days"
    </example>

    <p>'&lt;num&gt; &lt;type&gt;' 구문을 반복해서 사용하여
    만기시간을 자세히 설정할 수 있다:</p>

    <example>
      ExpiresByType text/html "access plus 1 month 15
      days 2 hours"<br />
      ExpiresByType image/gif "modification plus 5 hours 3
      minutes"
    </example>

    <p>만약 수정시간(modification)을 기준으로 만기시간을 설정하는
    경우 내용을 디스크에 있는 파일에서 가져오지 않는다면 Expires
    헤더를 붙이지 <strong>않는다</strong>. 이 경우 내용에 수정시간이
    없기 때문이다.</p>
</section>

<directivesynopsis>
<name>ExpiresActive</name>
<description><code>Expires</code> 헤더를 생성한다</description>
<syntax>ExpiresActive On|Off</syntax>
<contextlist><context>server config</context>
<context>virtual host</context><context>directory</context>
<context>.htaccess</context></contextlist>
<override>Indexes</override>

<usage>
    <p>이 지시어는 해당 영역에 대해 (즉, <code>.htaccess</code>
    파일에서 사용한다면 그 디렉토리 아래에 있는 문서들만 해당된다.)
    <code>Expires</code>와 <code>Cache-Control</code> 헤더를
    생성할지 유무를 결정한다. (<code>.htaccess</code> 파일 등으로
    더 하위 단계에서 서버설정을 변경하지않는 한)
    <code>Off</code>이면 해당 영역에 있는 문서에 이들 헤더를
    생성하지 않는다. <code>On</code>이면 <directive
    module="mod_expires">ExpiresByType</directive>과 <directive
    module="mod_expires">ExpiresDefault</directive> 지시어로
    (<em>해당 항목을 참고하라</em>) 지정한 규칙에 따라 서비스하려는
    문서에 이 헤더들을 생성한다.</p>

    <p>이 지시어가 <code>Expires</code>나 <code>Cache-Control</code>
    헤더를 보장하지는 않는다. 규칙에 해당하지 않다면 마치 이
    지시어가 없는 것처럼 헤더를 만들지 않는다.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>ExpiresByType</name>
<description>MIME type으로 <code>Expires</code> 헤더값을 설정한다</description>
<syntax>ExpiresByType <var>MIME-type</var>
<var>&lt;code&gt;seconds</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>Indexes</override>

<usage>
    <p>이 지시어는 특정 종류의 (<em>에를 들어</em>,
    <code>text/html</code>) 문서에 대한 <code>Expires</code>
    헤더값과 <code>Cache-Control</code> 헤더의 <code>max-age</code>
    지시어값을 정의한다. 두번째 아규먼트는 만기시간을 결정할때
    기준 시간에 더할 초단위 값을 지정한다. <code>Cache-Control:
    max-age</code>는 만기시간에서 요청한 시간을 빼서 계산하고,
    결과는 초단위로 표시한다.</p>

    <p>기준 시간은 파일의 최근 수정시간 혹은 클라이언트가 문서에
    접근한 시간이다. 이떤 것을 사용할지는
    <code><var>&lt;code&gt;</var></code> 필드로 결정해야 한다.
    <code>M</code>은 기준 시간으로 파일의 최근 수정시간을
    사용하고, <code>A</code>는 클라이언트의 접근 시간을 사용한다.</p>

    <p>차이는 미묘하다. <code>M</code>을 사용하면 캐쉬에 있는
    모든 복사본이 같은 시간에 만료된다. 그래서 항상 같은 URL로
    찾아볼 수 있는 주간일정 같은 용도에 좋다. <code>A</code>를
    사용하면 복사본의 만기시간이 각각 다르다. 이는 자주 수정되지않는
    그림파일에, 특히 여러 문서에서 같은 그림을 참조할때 (<em>예를
    들어</em>, 이미지는 상대적으로 짧은 기간동안 반복해서 접근된다),
    유용하다.</p>

    <example><title>예제:</title>
      # 만기헤더를 사용한다<br />
      ExpiresActive On<br />
      # 클라이언트 캐쉬의 GIF 그림은 한 달후에 만기한다<br />
      ExpiresByType image/gif A2592000<br />
      # HTML 문서는 변경후 일주일간 유효하다
      ExpiresByType text/html M604800
    </example>

    <p>이 지시어는 <code>ExpiresActive On</code>을 사용할때만
    유효함을 주의하라. <directive
    module="mod_expires">ExpiresDefault</directive> 지시어를
    사용하여 특정 MIME type에 대해서<em>만</em> 만기시간을
    설정할 수 있다.</p>

    <p>앞에서 설명한 <a href="#AltSyn">다른 문법</a>을 사용하여
    만기시간을 계산할 수도 있다.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>ExpiresDefault</name>
<description>만기시간을 계산하는 기본 알고리즘</description>
<syntax>ExpiresDefault <var>&lt;code&gt;seconds</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>Indexes</override>

<usage>
    <p>이 지시어는 해당 영역에 있는 모든 문서의 만기시간을
    계산하는 기본 알고리즘을 지정한다. <directive
    module="mod_expires">ExpiresByType</directive> 지시어를
    사용하여 종류별로 설정할 수 있다. 아규먼트 문법에 대한
    자세한 설명은 그 지시어와 <a href="#AltSyn">다른 문법</a>을
    참고하라.</p>
</usage>
</directivesynopsis>
</modulesynopsis>