mod_cache.xml.ko revision 9a354e2f1bae7db60331801d79328f4565410e36
<?xml version="1.0" encoding="EUC-KR" ?>
<!-- English Revision: 105569:810187 (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
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_cache.xml.meta">
<name>mod_cache</name>
<description>URI�� Ű�� ����Ͽ� ������ ij���Ѵ�.</description>
<status>Experimental</status>
<identifier>cache_module</identifier>
<summary>
<note type="warning">
�� ����� �������� �����̴�. ������ ���� �۾����̴�...
</note>
<p><module>mod_cache</module>�� ���� ��ǻ�Ϳ� �ִ� �����̳�
���Ͻõ� ������ ij���� �� �ִ� <a
href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a>
ȣȯ HTTP ����ij���� �����Ѵ�. <module>mod_cache</module>��
����Ϸ��� �������(storage management module)�� �ʿ��ϴ�.
�⺻ ����ġ ���������� �ΰ��� ��������� �ִ�:</p>
<dl>
<dt><module>mod_disk_cache</module></dt>
<dd>�� ��ũ��� ������ڸ� �����Ѵ�.</dd>
<dt><module>mod_mem_cache</module></dt>
<dd>�� ��� ������ڸ� �����Ѵ�.
<module>mod_mem_cache</module>�� ���ϱ���ڸ� ij���ϰų�
��(heap) �� ��ü�� ij���ϴ� �ΰ��� ����� �Ѱ��� �������
�����ϵ��� ������ �� �ִ�. <module>mod_mem_cache</module>��
�ڽ��� ���� ������ ij���ϰų�, (<dfn>�����Ͻ�(reverse proxy)</dfn>��
�˷���) <directive module="mod_proxy">ProxyPass</directive>��
����Ͽ� <module>mod_proxy</module>�� ���� �� ����������
ij���� �� �ִ�.</dd>
</dl>
<p>������ URI�� ���� ���� Ű�� ij���� �����ϰ� �����´�.
���ٺ�ȣ�� �� ������ ij�������ʴ´�.</p>
</summary>
<section id="related"><title>��õ� ���� ���þ�</title>
<related>
<modulelist>
<module>mod_disk_cache</module>
<module>mod_mem_cache</module>
</modulelist>
<directivelist>
<directive module="mod_disk_cache">CacheRoot</directive>
<directive module="mod_disk_cache">CacheSize</directive>
<directive module="mod_disk_cache">CacheGcInterval</directive>
<directive module="mod_disk_cache">CacheDirLevels</directive>
<directive module="mod_disk_cache">CacheDirLength</directive>
<directive module="mod_disk_cache">CacheExpiryCheck</directive>
<directive module="mod_disk_cache">CacheMinFileSize</directive>
<directive module="mod_disk_cache">CacheMaxFileSize</directive>
<directive module="mod_disk_cache">CacheTimeMargin</directive>
<directive module="mod_disk_cache">CacheGcDaily</directive>
<directive module="mod_disk_cache">CacheGcUnused</directive>
<directive module="mod_disk_cache">CacheGcClean</directive>
<directive module="mod_disk_cache">CacheGcMemUsage</directive>
<directive module="mod_mem_cache">MCacheSize</directive>
<directive module="mod_mem_cache">MCacheMaxObjectCount</directive>
<directive module="mod_mem_cache">MCacheMinObjectSize</directive>
<directive module="mod_mem_cache">MCacheMaxObjectSize</directive>
<directive module="mod_mem_cache">MCacheRemovalAlgorithm</directive>
<directive module="mod_mem_cache">MCacheMaxStreamingBuffer</directive>
</directivelist>
</related>
</section>
<section id="sampleconf"><title>������</title>
#<br />
# ���� ij�� ����<br />
#<br />
<br />
<IfModule mod_cache.c><br />
<indent>
<IfModule mod_disk_cache.c><br />
<indent>
CacheRoot c:/cacheroot<br />
CacheSize 256<br />
CacheEnable disk /<br />
CacheDirLevels 5<br />
CacheDirLength 3<br />
</indent>
</IfModule> <br />
<br />
<IfModule mod_mem_cache.c><br />
<indent>
CacheEnable mem /<br />
MCacheSize 4096<br />
MCacheMaxObjectCount 100<br />
MCacheMinObjectSize 1<br />
MCacheMaxObjectSize 2048<br />
</indent>
</IfModule><br />
</indent>
</IfModule>
</example>
</section>
<directivesynopsis>
<name>CacheEnable</name>
<description>������ ������ڸ� ����Ͽ� ������ URL�� ij���Ѵ�</description>
<syntax>CacheEnable <var>cache_type</var> <var>url-string</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p><directive>CacheEnable</directive> ���þ ����ϸ�
<module>mod_cache</module>�� <var>url-string</var> ����
url���� ij���Ѵ�. ij�� ������ڴ� <var>cache_type</var>
�ƱԸ�Ʈ�� �����Ѵ�. <var>cache_type</var> <code>mem</code>��
<module>mod_mem_cache</module>�� �����ϴ� ���
������ڸ� ����Ѵ�. <var>cache_type</var> <code>disk</code>��
<module>mod_disk_cache</module>�� �����ϴ� ��ũ���
������ڸ� ����Ѵ�. <var>cache_type</var> <code>fd</code>��
<module>mod_mem_cache</module>�� �����ϴ� ���ϱ���� ij����
����Ѵ�.</p>
<p>(�Ʒ� ���� ����) URL ���� �ٸ�
<directive>CacheEnable</directive> ���þ�� ��ġ�� ������
�� ������ڰ� ��û�� ó���Ҷ����� �� ������ڸ� ���
�����Ѵ�. �������Ͽ��� <directive>CacheEnable</directive>
���þ��� ���� ������ڰ� ����ȴ�.</p>
<example>
CacheEnable mem /manual<br />
CacheEnable fd /images<br />
CacheEnable disk /<br />
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>CacheDisable</name>
<description>Ư�� URL�� ij������ �ʴ´�</description>
<syntax>CacheDisable <var> url-string</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p><directive>CacheDisable</directive> ���þ ����ϸ�
<module>mod_cache</module>�� <var>url-string</var> ������
url���� ij������ <em>�ʴ´�</em>.</p>
<example><title>����</title>
CacheDisable /local_files
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>CacheMaxExpire</name>
<description>������ ij���ϴ� �ʴ��� �ִ�ð�</description>
<syntax>CacheMaxExpire <var>seconds</var></syntax>
<default>CacheMaxExpire 86400 (�Ϸ�)</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p><directive>CacheMaxExpire</directive> ���þ�� ���� ������
�˻������ʰ� ij�������� HTTP ������ ������ �� �ִ� �ʴ���
�ִ�ð��� �����Ѵ�. ��, ������ �ִ��� �� ��������ŭ �����Ǿ��.
������ ����ð��� �����Ͽ��� �� �ִ밪�� ��Ų��.</p>
<example>
CacheMaxExpire 604800
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>CacheDefaultExpire</name>
<description>����ð��� ������������ ������ ij���� �⺻ �Ⱓ.</description>
<syntax>CacheDefaultExpire <var>seconds</var></syntax>
<default>CacheDefaultExpire 3600 (one hour)</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p><directive>CacheDefaultExpire</directive> ���þ�� ������
����ð��� �ֱټ����ð��� ��� ��� ������ ij���� �ʴ���
�⺻ �ð��� �����Ѵ�. <directive>CacheMaxExpire</directive>��
������ ���� �� ������ �������� <em>�ʴ´�</em>.</p>
<example>
CacheDefaultExpire 86400
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>CacheIgnoreNoLastMod</name>
<description>���信 Last Modified ����� ��ٴ� ����� �����Ѵ�.</description>
<syntax>CacheIgnoreNoLastMod On|Off</syntax>
<default>CacheIgnoreNoLastMod Off</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p>���� �ֱټ������� ��� ������ ij������ �ʴ´�. � ���
�ֱټ������� (���� ��� <module>mod_include</module> ó���߿�)
���ų� ó������ ����� ���� �ִ�.
<directive>CacheIgnoreNoLastMod</directive> ���þ�� �ֱټ�������
��� ������ �ݵ�� ij���ϵ��� �����. ������ �ֱټ����ϰ�
����� ��� ��� <directive>CacheDefaultExpire</directive>
���þ�� ������ ���� ����ð����� ����Ѵ�.</p>
<example>
CacheIgnoreNoLastMod On
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>CacheIgnoreCacheControl</name>
<description>Ŭ���̾�Ʈ�� ij�������ʴ� ������ ��û���� �����Ѵ�.</description>
<syntax>CacheIgnoreCacheControl On|Off</syntax>
<default>CacheIgnoreCacheControl Off</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p>���� no-cache�� no-store ������� ���� ������ ij����
���������ʴ´�. <directive>CacheIgnoreCacheControl</directive>
���þ�� �̷� �ൿ�� �����Ѵ�.
<directive>CacheIgnoreCacheControl</directive> On�� ����ϸ�
������ ������ no-cache�� no-store ������� �־ ������
ij���Ѵ�. ������ �ʿ��� ������ <em>����</em> ij������
�ʴ´�.</p>
<example>
CacheIgnoreCacheControl On
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>CacheLastModifiedFactor</name>
<description>LastModified �ð����� ����ð��� ����ϴµ� ����ϴ�
���.</description>
<syntax>CacheLastModifiedFactor <var>float</var></syntax>
<default>CacheLastModifiedFactor 0.1</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p>������ ����ð��� ������ �ֱټ������� �ִ� ��� �ֱټ�����
���� ���� �ð����� ����ð��� ����Ѵ�.
<directive>CacheLastModifiedFactor</directive> ���þ��
����ð��� ����ϴ� ���� ��Ŀ��� ����� <var>factor</var>��
�����Ѵ�:
<code>expiry-period = time-since-last-modified-date * <var>factor</var>
expiry-date = current-date + expiry-period</code>
���� ���, ������ 10 �ð� �� ���������� �����Ǿ�� <var>factor</var>��
0.1�̶�� ����Ⱓ�� 10*01 = 1 �ð��� �ȴ�. ���� �ð���
3:00pm�̶�� ����ð��� 3:00pm + 1�ð� = 4:00pm�̴�.
����Ⱓ�� <directive>CacheMaxExpire</directive> ���� ��ٸ�
<directive>CacheMaxExpire</directive>�� ����Ѵ�.</p>
<example>
CacheLastModifiedFactor 0.5
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>CacheIgnoreHeaders</name>
<description>ij���� ������ HTTP ���(��)�� �������� �ʴ´�
</description>
<syntax>CacheIgnoreHeaders <var>header-string</var> [<var>header-string</var>] ...</syntax>
<default>CacheIgnoreHeaders None</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p>RFC 2616�� ��� ȩ��(hop-by-hop) HTTP ����� ij����
�������� �ʴ´�. ȩ�� HTTP ������� ������ ���� ���� ������,
<directive>CacheIgnoreHeaders</directive> ������ ������
<em>�</em> ��쿡�� ij���� ������� �ʴ´�.</p>
<ul>
<li><code>Connection</code></li>
<li><code>Keep-Alive</code></li>
<li><code>Proxy-Authenticate</code></li>
<li><code>Proxy-Authorization</code></li>
<li><code>TE</code></li>
<li><code>Trailers</code></li>
<li><code>Transfer-Encoding</code></li>
<li><code>Upgrade</code></li>
</ul>
<p><directive>CacheIgnoreHeaders</directive>�� ij���� �����ϸ�
�ȵǴ� HTTP ����� �߰��� �����Ѵ�. ���� ���, ��Ű(cookie)��
ij���� �����ϸ� �ȵǴ� ��찡 �ִ�.</p>
<p><directive>CacheIgnoreHeaders</directive>�� ij���� ��������
���� HTTP ������� ������� ������ ����� �´�. (RFC 2616��
���) ij���� ȩ�� ����� �������� ��������,
<directive>CacheIgnoreHeaders</directive>��
<code>None</code>���� �����Ѵ�.</p>
<example><title>���� 1</title>
CacheIgnoreHeaders Set-Cookie
</example>
<example><title>���� 2</title>
CacheIgnoreHeaders None
</example>
<note type="warning"><title>���:</title>
<directive>CacheIgnoreHeaders</directive> ������ ����Ͽ�
<code>Expires</code> ���� ij�� �� �ʿ��� ����� ��������
������, mod_cache�� ������������ �����Ѵ�.
</note>
</usage>
</directivesynopsis>
</modulesynopsis>