mod_headers.xml.ko revision b41a0dbe6310c576e96b7ea6910051fd84fb06f5
44N/A<?xml version="1.0" encoding="EUC-KR" ?>
44N/A<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
44N/A<?xml-stylesheet type="text/xsl" href="/style/manual.ko.xsl"?>
44N/A<!-- English Revision: 151408:946617 (outdated) -->
44N/A
44N/A<!--
44N/A Licensed to the Apache Software Foundation (ASF) under one or more
44N/A contributor license agreements. See the NOTICE file distributed with
44N/A this work for additional information regarding copyright ownership.
44N/A The ASF licenses this file to You under the Apache License, Version 2.0
44N/A (the "License"); you may not use this file except in compliance with
44N/A the License. You may obtain a copy of the License at
44N/A
44N/A http://www.apache.org/licenses/LICENSE-2.0
44N/A
44N/A Unless required by applicable law or agreed to in writing, software
44N/A distributed under the License is distributed on an "AS IS" BASIS,
44N/A WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
44N/A See the License for the specific language governing permissions and
44N/A limitations under the License.
75N/A-->
75N/A
59N/A<modulesynopsis metafile="mod_headers.xml.meta">
44N/A
75N/A<name>mod_headers</name>
44N/A<description>HTTP ��û ����� ���� ��� ����</description>
44N/A<status>Extension</status>
44N/A<sourcefile>mod_headers.c</sourcefile>
491N/A<identifier>headers_module</identifier>
44N/A<compatibility><directive
491N/Amodule="mod_headers">RequestHeader</directive>�� ����ġ 2.0����
491N/A�ִ�</compatibility>
44N/A
44N/A<summary>
44N/A <p>�� ����� HTTP ��û ����� ���� ����� �����ϰ� �����ϴ�
44N/A ���þ���� �����Ѵ�. ����� ��ġ�ų� ��ü, ������ �� �ִ�.</p>
44N/A</summary>
44N/A
44N/A<section id="order"><title>ó�� ��</title>
44N/A
44N/A <p><module>mod_headers</module>�� �����ϴ� ���þ�� ����������
58N/A ���� ��� ��ҿ��� ����� �� ������, <a
44N/A href="/sections.html">���� ����</a>���� ���μ� ���þ���
61N/A ������ ������ ���� �ִ�.</p>
44N/A
44N/A <p>ó����� �߿��ϸ�, �������Ͽ� ���� ��� <a
44N/A href="/sections.html#mergin">���� ����</a>�� ������ �޴´�.
59N/A ���� �� ���þ �ݴ�� ������ ȿ�� �޶����.</p>
44N/A
44N/A <example>
59N/A RequestHeader append MirrorID "mirror 12"<br />
59N/A RequestHeader unset MirrorID
59N/A </example>
177N/A
59N/A <p>���� ���� ������ <code>MirrorID</code> ����� ������
59N/A �ʴ´�. �ݴ�� ������ MirrorID ����� "mirror 12"�� �����Ѵ�.</p>
44N/A</section>
44N/A
44N/A<section id="early"><title>�̸�(early) ó���� ����(late) ó��</title>
44N/A <p><module>mod_headers</module>�� ��û �ʱ⳪ ���߿� �����
181N/A �� �ִ�. ������ ������ڸ� �����ϱ� ���� ��û �����
44N/A �����ϰ� ������ ��Ʈ���� ���� ���� ����� �����ϴ� ����(late)
181N/A ����� ����Ѵ�. ���� �����ϴ� ���������� �׻� ���� �����
83N/A ����϶�.</p>
44N/A
44N/A <p>�̸�(early) ����� �����ڸ� ���� �˻�/���������� ������.
44N/A <code>early</code> Ű���带 ����Ͽ� ������ ���þ�� ��û��
ó���ϱ� �����Ҷ� �����Ѵ�. ��, �ٸ� ��û�� ���ǽ����ϰų�
�˻縦 �ϱ����� ����� �� ������, ������ ���ϱ� �� �ٸ�
����� �ҽÿ� ����� ������ �� �ִ�.</p>
<p>��û��ο� ���� ������ ���캸�� �� �̸� ���þ
ó���ϱ⶧���� �̸� ��� ���þ�� �ּ����̳� ����ȣ��Ʈ
�����ҿ����� ����� �� �ִ�. �̸� ���þ�� ��û��ο�
������ �� ��⶧���� <code>&lt;Directory&gt;</code>��
<code>&lt;Location&gt;</code>���� �����ҿ��� ����� ��
���.</p>
</section>
<section id="examples"><title>����</title>
<ol>
<li>
"TS"�� �����ϴ� ��� ��û ����� ���� ����� �����Ѵ�.
<example>
Header echo ^TS
</example>
</li>
<li>
���信 ��û�� ���� �ð��� ��û�� �����ϴµ� �ɸ� �ð���
�˷��ִ� <code>MyHeader</code> ����� �߰��Ѵ�. Ŭ���̾�Ʈ��
�� ����� ���� ������ ���ϸ� �����ϰų� Ŭ���̾�Ʈ��
�������� �������� ã�� �� �ִ�.
<example>
Header add MyHeader "%D %t"
</example>
<p>���信 ������ ���� ����� ����.</p>
<example>
MyHeader: D=3775428 t=991424704447256
</example>
</li>
<li>
Joe���� �ȳ�
<example>
Header add MyHeader "Hello Joe. It took %D microseconds \<br />
for Apache to serve this request."
</example>
<p>���信 ������ ���� ����� ����.</p>
<example>
MyHeader: Hello Joe. It took D=3775428 microseconds for Apache
to serve this request.
</example>
</li>
<li>
��û�� "MyRequestHeader" ����� �ִ� ��쿡�� ����������
���信 <code>MyHeader</code>�� ������. Ư�� Ŭ���̾�Ʈ���Ը�
���信 ����� �߰��Ҷ� �����ϴ�. �� ������ �����Ϸ���
<module>mod_setenvif</module> ����� �ʿ��ϴ�.
<example>
SetEnvIf MyRequestHeader value HAVE_MyRequestHeader<br />
Header add MyHeader "%D %t mytext" env=HAVE_MyRequestHeader<br />
</example>
<p>HTTP ��û�� <code>MyRequestHeader: value</code> �����
�ִٸ�, ���信 ������ ���� ����� ����.</p>
<example>
MyHeader: D=3775428 t=991424704447256 mytext
</example>
</li>
</ol>
</section>
<directivesynopsis>
<name>RequestHeader</name>
<description>HTTP ��û ����� �����Ѵ�</description>
<syntax>RequestHeader set|append|add|unset <var>header</var>
[<var>value</var>] [early|env=[!]<var>variable</var>]</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>FileInfo</override>
<usage>
<p>�� ���þ�� HTTP ��û ����� ��ġ�ų� ��ü, �����Ѵ�.
���� �ڵ鷯�� �����ϱ� ���� ����� �����ϱ⶧���� ����
����� ������ �� �ִ�. ù��° �ƱԸ�Ʈ�� ��� ����� �ٸ���.
ù��° �ƱԸ�Ʈ�� �Ʒ� ���� �ϳ��� ����� �� �ִ�.</p>
<dl>
<dt><code>set</code></dt>
<dd>��û ����� �����Ѵ�. ���� �̸����� �̹� ����� �ִٸ�
��ü�Ѵ�</dd>
<dt><code>append</code></dt>
<dd>�̹� �����ϴ� ���� �̸��� ��û ����� �߰��Ѵ�. ����
����� ���ο� ���� ��ġ��, ���� ����� ���ο� �� ���̿�
��ǥ�� ���δ�. �̴� ���� ������� �����ϴ� HTTP ǥ�� ����̴�.</dd>
<dt><code>add</code></dt>
<dd>����� �̹� �ִ��� ��û ����� �߰��Ѵ�. �׷��� ����
�̸��� ����� �ΰ� (Ȥ�� ����) ��� �� �ִ�. �� ��� �ǿ���
��� �߻��� �� �ֱ⶧���� ���� ��� <code>append</code>��
����ؾ� �Ѵ�.</dd>
<dt><code>unset</code></dt>
<dd>�̷� �̸��� ��û ����� �ִٸ� �����Ѵ�. ���� �̸���
���� ����� ������ �ִٸ� ��� �����Ѵ�. <var>value</var>��
���� �ʴ´�.</dd>
</dl>
<p>�ƱԸ�Ʈ �ڿ� ������� ���´�. ����� �ڿ� �ݷ��� ����
�� ������, �� �ȴ�. ��ҹ��ڴ� �����Ѵ�. <code>add</code>,
<code>append</code>, <code>set</code>�� ����Ҷ��� ����°
�ƱԸ�Ʈ <var>value</var>�� �ʿ��ϴ�. <var>value</var> �ȿ�
����� �ִٸ� �ֵ��ǥ�� ����� �Ѵ�. unset�� ����Ҷ���
<var>value</var>�� ������ �ȵȴ�. <var>value</var>�� �Ϲ�
���ڿ��̳� ����� ����ϴ� ���ڿ��̸�, �ΰ����� ���� �����
���� �ִ�. �����ϴ� ��ı���ڴ� <directive
module="mod_headers">Header</directive>�� �����Ƿ� �ڼ���
������ �װ��� ����϶�.</p>
<p><directive>RequestHeader</directive> ���þ� �ڿ� �ൿ��
�Ͼ ������ �����ϴ� �߰� �ƱԸ�Ʈ�� <a
href="#early">�̸� ó��</a>�� ���ϴ� Ű����
<code>early</code>�� ���� �� �ִ�. <code>env=<var>...</var></code>
�ƱԸ�Ʈ�� ����� ��� �ش� <a href="/env.html">ȯ�溯��</a>��
�����Ѵٸ� (Ȥ�� <code>env=!<var>...</var></code>�� ����
ȯ�溯���� �������� �ʴٸ�) <directive>RequestHeader</directive>
���þ �����Ѵ�. �׷��� ������ ���þ�� ��û�� �ƹ� ������
��ġ�� �ʴ´�.</p>
<p><a href="#early">�̸�</a> ����� �ƴ϶�� fixup �ܰ迡��
��û�� �ش��ϴ� �ڵ鷯�� �����ϱ� ����
<directive>RequestHeader</directive> ���þ ó���Ѵ�.
�׷��� ������ ��� Ȥ�� ����ġ �Է����Ͱ� ����� ����ų�
������ �� �ִ�.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>Header</name>
<description>HTTP ���� ����� �����Ѵ�</description>
<syntax>Header [<var>condition</var>] set|append|add|unset|echo
<var>header</var> [<var>value</var>] [early|env=[!]<var>variable</var>]</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>FileInfo</override>
<usage>
<p>�� ���þ�� HTTP ���� ����� ��ġ�ų� ��ü, �����Ѵ�.
���� �ڵ鷯�� ��� ���Ͱ� ������ ���Ŀ� ����� �����ϱ⶧����
���� ����� ������ �� �ִ�.</p>
<p><var>condition</var>�� ���������� ����ϸ�, ������
<code>onsuccess</code> Ȥ�� <code>always</code>�� ����Ѵ�.
�̴� � ���� ���ǥ�� ���������� �����Ѵ�.
<code>onsuccess</code>�� <code>2<var>xx</var></code> �����ڵ带
���ϰ�, <code>always</code>�� (<code>2<var>xx</var></code>��
������) ��� �����ڵ带 ���Ѵ�. Ư�� � ����� ������
����� �����ϰ� �ʹٸ�, ���� � ���� ������� �� �������
�Ѵ�.</p>
<p>�ι�° �ƱԸ�Ʈ�� ��� ����� �ٸ���. �ι�° �ƱԸ�Ʈ��
�Ʒ� ���� �ϳ��� ����� �� �ִ�.</p>
<dl>
<dt><code>set</code></dt>
<dd>���� ����� �����Ѵ�. ���� �̸����� �̹� ����� �ִٸ�
��ü�Ѵ�. <var>value</var>�� ��Ĺ��ڿ��� ����� �� �ִ�.</dd>
<dt><code>append</code></dt>
<dd>�̹� �����ϴ� ���� �̸��� ���� ����� �߰��Ѵ�. ����
����� ���ο� ���� ��ġ��, ���� ����� ���ο� �� ���̿�
��ǥ�� ���δ�. �̴� ���� ������� �����ϴ� HTTP ǥ�� ����̴�.</dd>
<dt><code>add</code></dt>
<dd>����� �̹� �ִ��� ���� ����� �߰��Ѵ�. �׷��� ����
�̸��� ����� �ΰ� (Ȥ�� ����) ��� �� �ִ�. �� ��� �ǿ���
��� �߻��� �� �ֱ⶧���� ���� ��� <code>append</code>��
����ؾ� �Ѵ�.</dd>
<dt><code>unset</code></dt>
<dd>�̷� �̸��� ���� ����� �ִٸ� �����Ѵ�. ���� �̸���
���� ����� ������ �ִٸ� ��� �����Ѵ�. <var>value</var>��
���� �ʴ´�.</dd>
<dt><code>echo</code></dt>
<dd>�̷� �̸��� ��û ����� �״�� ���� ����� ������.
<var>header</var>�� ����ǥ������ ����� �� �ִ�.
<var>value</var>�� ���� �ʴ´�.</dd>
</dl>
<p>�ƱԸ�Ʈ �ڿ� <var>header</var> �̸��� ���´�. �����
�ڿ� �ݷ��� ���� �� ������, �� �ȴ�. <code>set</code>,
<code>append</code>, <code>add</code>, <code>unset</code>����
��ҹ��ڴ� �����Ѵ�. <code>echo</code>�� <var>header</var>
�̸��� ������ڸ� �����ϰ� ����ǥ������ ����� �� �ִ�.</p>
<p><code>add</code>, <code>append</code>, <code>set</code>��
����Ҷ��� ����° �ƱԸ�Ʈ <var>value</var>�� �ʿ��ϴ�.
<var>value</var> �ȿ� ����� �ִٸ� �ֵ��ǥ�� ����� �Ѵ�.
<var>value</var>�� �Ϲ� ���ڿ��̳� ����� ����ϴ� ���ڿ��̸�,
�ΰ����� ���� ����� ���� �ִ�. <var>value</var>���� �����ϴ�
��ı���ڴ� ������ ����.</p>
<table border="1" style="zebra">
<columnspec><column width=".25"/><column width=".75"/></columnspec>
<tr><th>���</th><th>����</th></tr>
<tr><td><code>%%</code></td>
<td>�ۼ�Ʈ ��ȣ</td></tr>
<tr><td><code>%t</code></td>
<td>��û�� ���� �ð��� ����ǥ�ؽ÷� epoch (1970�� 1��
1��) ���� ���� ����ũ���� ������. �� �տ� <code>t=</code>��
�ٴ´�.</td></tr>
<tr><td><code>%D</code></td>
<td>��û�� ���� �ð����� ����� ��Ʈ���� �������� �ɸ�
�ð�. ��û�� �Ⱓ�� ���. �� �տ� <code>D=</code>��
�ٴ´�.</td></tr>
<tr><td><code>%{FOOBAR}e</code></td>
<td><a href="/env.html">ȯ�溯��</a> <code>FOOBAR</code>��
����.</td></tr>
<tr><td><code>%{FOOBAR}s</code></td>
<td><module>mod_ssl</module>�� �����Ѵٸ�, <a
href="mod_ssl.html#envvars">SSL ȯ�溯��</a>
<code>FOOBAR</code>�� ����.</td></tr>
</table>
<note><title>����</title>
<p><code>%s</code> ��� �����ڴ� ����ġ 2.1 ���Ŀ��� �ִ�.
�� �����ڴ� <code>SSLOptions +StdEnvVars</code>�� ����ϴ�
�δ��� ������� <code>%e</code> ��� ����� �� �ִ�. �
���������� <code>SSLOptions +StdEnvVars</code>�� ����ؾ�
�Ѵٸ�, <code>%e</code>�� <code>%s</code> ���� �ξ� ��
ȿ�����̴�.</p>
</note>
<p><directive>Header</directive> ���þ� �ڿ� �ൿ�� �Ͼ
������ �����ϴ� �߰� �ƱԸ�Ʈ�� <a href="#early">�̸� ó��</a>��
���ϴ� Ű���� <code>early</code>�� ���� �� �ִ�.
<code>env=<var>...</var></code> �ƱԸ�Ʈ�� ����� ��� �ش�
<a href="/env.html">ȯ�溯��</a>�� �����Ѵٸ� (Ȥ��
<code>env=!<var>...</var></code>�� ���� ȯ�溯���� ��������
�ʴٸ�) <directive>Header</directive> ���þ �����Ѵ�.
�׷��� ������ ���þ�� ��û�� �ƹ� ������ ��ġ�� �ʴ´�.</p>
<p><a href="#early">�̸�</a> ����� �ƴ϶�� ������ ��Ʈ������
������ ���� <directive>Header</directive> ���þ ó���Ѵ�.
�׷��� ��� ���Ͱ� �߰��ϴ� ����� ������ ��κ��� �����
�����ϰų� ��� �� �ִ�.</p>
</usage>
</directivesynopsis>
</modulesynopsis>