mod_cache.xml.ko revision d378be2a904a6e56925589d8278bf6136032e0a4
2035N/A<?xml version="1.0" encoding="EUC-KR" ?>
2035N/A<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
2035N/A<?xml-stylesheet type="text/xsl" href="/style/manual.ko.xsl"?>
2035N/A<!-- English Revision: 105569 (outdated: 105758) -->
2035N/A
2035N/A<!--
2035N/A Copyright 2003-2004 The Apache Software Foundation
2035N/A
2035N/A Licensed under the Apache License, Version 2.0 (the "License");
2035N/A you may not use this file except in compliance with the License.
2035N/A You may obtain a copy of the License at
2035N/A
2035N/A http://www.apache.org/licenses/LICENSE-2.0
2035N/A
2035N/A Unless required by applicable law or agreed to in writing, software
2035N/A distributed under the License is distributed on an "AS IS" BASIS,
2035N/A WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
2035N/A See the License for the specific language governing permissions and
2035N/A limitations under the License.
2035N/A-->
5680N/A
5680N/A<modulesynopsis metafile="mod_cache.xml.meta">
6191N/A
2035N/A<name>mod_cache</name>
2035N/A<description>URI�� Ű�� ����Ͽ� ������ ij���Ѵ�.</description>
2035N/A<status>Experimental</status>
2035N/A<sourcefile>mod_cache.c</sourcefile>
6191N/A<identifier>cache_module</identifier>
2035N/A
2035N/A<summary>
2035N/A <note type="warning">
6191N/A �� ����� �������� �����̴�. ������ ���� �۾����̴�...
2035N/A </note>
2035N/A
2035N/A <p><module>mod_cache</module>�� ���� ��ǻ�Ϳ� �ִ� �����̳�
2035N/A ���Ͻõ� ������ ij���� �� �ִ� <a
6191N/A href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a>
2899N/A ȣȯ HTTP ����ij���� �����Ѵ�. <module>mod_cache</module>��
3817N/A ����Ϸ��� �������(storage management module)�� �ʿ��ϴ�.
3817N/A �⺻ ����ġ ���������� �ΰ��� ��������� �ִ�:</p>
3817N/A <dl>
2035N/A <dt><module>mod_disk_cache</module></dt>
2035N/A <dd>�� ��ũ��� ������ڸ� �����Ѵ�.</dd>
2035N/A
2035N/A <dt><module>mod_mem_cache</module></dt>
2035N/A <dd>�� �޸𸮱�� ������ڸ� �����Ѵ�.
2035N/A <module>mod_mem_cache</module>�� ���ϱ���ڸ� ij���ϰų�
2035N/A ��(heap) �� ��ü�� ij���ϴ� �ΰ��� ����� �Ѱ��� �������
2035N/A �����ϵ��� ������ �� �ִ�. <module>mod_mem_cache</module>��
2035N/A �ڽ��� ���� ������ ij���ϰų�, (<dfn>�����Ͻ�(reverse proxy)</dfn>��
2035N/A �˷���) <directive module="mod_proxy">ProxyPass</directive>��
2035N/A ����Ͽ� <module>mod_proxy</module>�� ���� �޴� ����������
2035N/A ij���� �� �ִ�.</dd>
2035N/A </dl>
4337N/A
<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>
<example><title>Sample httpd.conf</title>
#<br />
# ���� ij�� ����<br />
#<br />
LoadModule cache_module modules/mod_cache.so<br />
<br />
&lt;IfModule mod_cache.c&gt;<br />
<indent>
#LoadModule disk_cache_module modules/mod_disk_cache.so<br />
&lt;IfModule mod_disk_cache.c&gt;<br />
<indent>
CacheRoot c:/cacheroot<br />
CacheSize 256<br />
CacheEnable disk /<br />
CacheDirLevels 5<br />
CacheDirLength 3<br />
</indent>
&lt;/IfModule&gt; <br />
<br />
LoadModule mem_cache_module modules/mod_mem_cache.so<br />
&lt;IfModule mod_mem_cache.c&gt;<br />
<indent>
CacheEnable mem /<br />
MCacheSize 4096<br />
MCacheMaxObjectCount 100<br />
MCacheMinObjectSize 1<br />
MCacheMaxObjectSize 2048<br />
</indent>
&lt;/IfModule&gt;<br />
</indent>
&lt;/IfModule&gt;
</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>CacheForceCompletion</name>
<description>��û�� ��ҵǴ��� ������ ������ ��� ij���ϱ�����
�ʿ��� ������ ���񽺷�.</description>
<syntax>CacheForceCompletion <var>Percentage</var></syntax>
<default>CacheForceCompletion 60</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p>���� ������ ij���ϰ� Ŭ���̾�Ʈ�� ������ ���߿� ��û��
��ҵǸ� ���� ó���� �ߴܵǰ� ij�� �׸��� �����.
<directive>CacheForceCompletion</directive> ���þ�� ��û��
��ҵǴ��� ������ ��� ij���� ������ �����Ѵ�.</p>
<p>������ ������� ��Ÿ���� <code>1</code>�� <code>100</code>
������ ���̴�. <code>0</code> ���� �����ϸ� �⺻���� ����Ѵ�.
<code>100</code>�� ������ ��� ������ �������� ij���Ѵ�.
60�� 90 ������ ���� ��õ�Ѵ�.</p>
<example>
CacheForceCompletion 80
</example>
<note type="warning"><title>����:</title>
�� ����� ���� �������� <em>�ʾҴ�</em>.
</note>
</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>