d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder<?xml version="1.0" encoding="EUC-KR" ?>

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder<?xml-stylesheet type="text/xsl" href="/style/manual.ko.xsl"?>

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder<modulesynopsis metafile="mod_cache.xml.meta">

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder<name>mod_cache</name>

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder<description>URI�� Ű�� ����Ͽ� ������ ij���Ѵ�.</description>

b2a02ef0183a671777294e069307bba893ca3ebeChristian Maeder<status>Experimental</status>

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder<sourcefile>mod_cache.c</sourcefile>

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder<identifier>cache_module</identifier>

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder<summary>

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder <note type="warning">

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder �� ����� �������� �����̴�. ������ ���� �۾����̴�...

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder </note>

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder <p><module>mod_cache</module>�� ���� ��ǻ�Ϳ� �ִ� �����̳�

b2a02ef0183a671777294e069307bba893ca3ebeChristian Maeder ���Ͻõ� ������ ij���� �� �ִ� <a

b2a02ef0183a671777294e069307bba893ca3ebeChristian Maeder href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a>

b2a02ef0183a671777294e069307bba893ca3ebeChristian Maeder ȣȯ HTTP ����ij���� �����Ѵ�. <module>mod_cache</module>��

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder ����Ϸ��� �������(storage management module)�� �ʿ��ϴ�.

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder �⺻ ����ġ ���������� �ΰ��� ��������� �ִ�:</p>

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder <dl>

b2a02ef0183a671777294e069307bba893ca3ebeChristian Maeder <dt><module>mod_cache_disk</module></dt>

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder <dd>�� ��ũ��� ������ڸ� �����Ѵ�.</dd>

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder <dt><module>mod_mem_cache</module></dt>

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder <dd>�� �޸𸮱�� ������ڸ� �����Ѵ�.

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder <module>mod_mem_cache</module>�� ���ϱ���ڸ� ij���ϰų�

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder ��(heap) �� ��ü�� ij���ϴ� �ΰ��� ����� �Ѱ��� �������

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder �����ϵ��� ������ �� �ִ�. <module>mod_mem_cache</module>��

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder �ڽ��� ���� ������ ij���ϰų�, (<dfn>�����Ͻ�(reverse proxy)</dfn>��

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder �˷���) <directive module="mod_proxy">ProxyPass</directive>��

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder ����Ͽ� <module>mod_proxy</module>�� ���� �޴� ����������

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder ij���� �� �ִ�.</dd>

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder </dl>

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder

b2a02ef0183a671777294e069307bba893ca3ebeChristian Maeder <p>������ URI�� ���� ���� Ű�� ij���� �����ϰ� �����´�.

b2a02ef0183a671777294e069307bba893ca3ebeChristian Maeder ���ٺ�ȣ�� �� ������ ij�������ʴ´�.</p>

b2a02ef0183a671777294e069307bba893ca3ebeChristian Maeder</summary>

b2a02ef0183a671777294e069307bba893ca3ebeChristian Maeder

b2a02ef0183a671777294e069307bba893ca3ebeChristian Maeder<section id="related"><title>��õ� ���� ���þ�</title>

b2a02ef0183a671777294e069307bba893ca3ebeChristian Maeder <related>

d5a8d891500a642ce629854857fc00b7c21aec47Christian Maeder <modulelist>

<module>mod_cache_disk</module>

<module>mod_mem_cache</module>

</modulelist>

<directivelist>

<directive module="mod_cache_disk">CacheRoot</directive>

<directive module="mod_cache_disk">CacheSize</directive>

<directive module="mod_cache_disk">CacheGcInterval</directive>

<directive module="mod_cache_disk">CacheDirLevels</directive>

<directive module="mod_cache_disk">CacheDirLength</directive>

<directive module="mod_cache_disk">CacheExpiryCheck</directive>

<directive module="mod_cache_disk">CacheMinFileSize</directive>

<directive module="mod_cache_disk">CacheMaxFileSize</directive>

<directive module="mod_cache_disk">CacheTimeMargin</directive>

<directive module="mod_cache_disk">CacheGcDaily</directive>

<directive module="mod_cache_disk">CacheGcUnused</directive>

<directive module="mod_cache_disk">CacheGcClean</directive>

<directive module="mod_cache_disk">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 cache_disk_module modules/mod_cache_disk.so<br />

&lt;IfModule mod_cache_disk.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_cache_disk</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>CacheHeader</name>

<description>Add an X-Cache header to the response.</description>

<contextlist><context>server config</context><context>virtual host</context><context>directory</context><context>.htaccess</context></contextlist>

<usage><p>Documentation not yet translated. Please see English version of document.</p></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>CacheMinExpire</name>

<description>The minimum time in seconds to cache a document</description>

<contextlist><context>server config</context><context>virtual host</context><context>directory</context><context>.htaccess</context></contextlist>

<usage><p>Documentation not yet translated. Please see English version of document.</p></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>CacheQuickHandler</name>

<description>Run the cache from the quick handler.</description>

<contextlist><context>server config</context><context>virtual host</context></contextlist>

<usage><p>Documentation not yet translated. Please see English version of document.</p></usage>

</directivesynopsis>

<directivesynopsis>

<name>CacheStaleOnError</name>

<description>Serve stale content in place of 5xx responses.</description>

<contextlist><context>server config</context><context>virtual host</context><context>directory</context><context>.htaccess</context></contextlist>

<usage><p>Documentation not yet translated. Please see English version of document.</p></usage>

</directivesynopsis>

<directivesynopsis>

<name>CacheStoreExpired</name>

<description>Attempt to cache responses that the server reports as expired</description>

<contextlist><context>server config</context><context>virtual host</context><context>directory</context><context>.htaccess</context></contextlist>

<usage><p>Documentation not yet translated. Please see English version of document.</p></usage>

</directivesynopsis>

<directivesynopsis>

<name>CacheStoreNoStore</name>

<description>Attempt to cache requests or responses that have been marked as no-store.</description>

<contextlist><context>server config</context><context>virtual host</context><context>directory</context><context>.htaccess</context></contextlist>

<usage><p>Documentation not yet translated. Please see English version of document.</p></usage>

</directivesynopsis>

<directivesynopsis>

<name>CacheStorePrivate</name>

<description>Attempt to cache responses that the server has marked as private</description>

<contextlist><context>server config</context><context>virtual host</context><context>directory</context><context>.htaccess</context></contextlist>

<usage><p>Documentation not yet translated. Please see English version of document.</p></usage>

</directivesynopsis>

<directivesynopsis>

<name>CacheDetailHeader</name>

<description>Add an X-Cache-Detail header to the response.</description>

<contextlist><context>server config</context><context>virtual host</context><context>directory</context><context>.htaccess</context></contextlist>

<usage><p>Documentation not yet translated. Please see English version of document.</p></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>CacheIgnoreQueryString</name>

<description>Ignore query string when caching</description>

<contextlist><context>server config</context><context>virtual host</context></contextlist>

<usage><p>Documentation not yet translated. Please see English version of document.</p></usage>

</directivesynopsis>

<directivesynopsis>

<name>CacheIgnoreURLSessionIdentifiers</name>

<description>Ignore defined session identifiers encoded in the URL when caching

</description>

<contextlist><context>server config</context><context>virtual host</context></contextlist>

<usage><p>Documentation not yet translated. Please see English version of document.</p></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>CacheKeyBaseURL</name>

<description>Override the base URL of reverse proxied cache keys.</description>

<contextlist><context>server config</context><context>virtual host</context></contextlist>

<usage><p>Documentation not yet translated. Please see English version of document.</p></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>CacheLock</name>

<description>Enable the thundering herd lock.</description>

<contextlist><context>server config</context><context>virtual host</context></contextlist>

<usage><p>Documentation not yet translated. Please see English version of document.</p></usage>

</directivesynopsis>

<directivesynopsis>

<name>CacheLockMaxAge</name>

<description>Set the maximum possible age of a cache lock.</description>

<contextlist><context>server config</context><context>virtual host</context></contextlist>

<usage><p>Documentation not yet translated. Please see English version of document.</p></usage>

</directivesynopsis>

<directivesynopsis>

<name>CacheLockPath</name>

<description>Set the lock path directory.</description>

<contextlist><context>server config</context><context>virtual host</context></contextlist>

<usage><p>Documentation not yet translated. Please see English version of document.</p></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>