mod_cache.xml.ko revision b244bbf442a0aea3dc397b4d0d751f4716c5891d
<?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: 105569:1561569 (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_cache.xml.meta">
<name>mod_cache</name>
<description>URI�� Ű�� ����Ͽ� ������ ij���Ѵ�.</description>
<status>Experimental</status>
<sourcefile>mod_cache.c</sourcefile>
<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_cache_disk</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_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>