mod_cache.xml.ko revision 4ef32fc8ca017f80aa0d8ff267722a335c9d7784
<?xml version="1.0" encoding="EUC-KR" ?>
<!-- English revision: 1.14 -->
<modulesynopsis metafile="mod_cache.xml.meta">
<name>mod_cache</name>
<description>Content cache keyed to URIs.</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>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>
</modulesynopsis>