env.xml.ko revision ee16733a8c54b01001dc28fa0f2b3749f640bc68
<?xml version="1.0" encoding="EUC-KR" ?>
<!DOCTYPE manualpage SYSTEM "/style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="/style/manual.ko.xsl"?>
<!-- English revision: 1.13 -->
<manualpage metafile="env.xml.meta">
<title>����ġ�� ȯ�溯��</title>
<summary>
<p>����ġ �������� <em>ȯ�溯��(environment variable)</em>���
������ ������ ������ �� �ִ�. �� ������ ����Ͽ� �α׳�
�������� �� ���� �۾��� �����Ѵ�. ��, ȯ�溯���� CGI ��ũ��Ʈ��
���� �ܺ� ���α׷��� ����ϴ� ������ �ȴ�. �� ������ ȯ�溯����
�ٷ�� ����ϴ� �پ��� ������ �����Ѵ�.</p>
<p>�� �������� <em>ȯ�溯��</em>��� �θ�����, �ü������
���ϴ� ȯ�溯���� �ٸ���. �� ������ ����ġ ���ο� ����ǰ�
���ȴ�. ȯ�溯���� CGI ��ũ��Ʈ�� Server Side Include
��ũ��Ʈ�� �Ѱ��� ���� �ü�� ȯ�溯���� �ȴ�. ������
�����ϴ� �ü�� ȯ���� �����ϰ� �ʹٸ� �ü�� ������
ȯ���� �����ؾ� �Ѵ�.</p>
</summary>
<section id="setting">
<title>ȯ�溯�� �����ϱ�</title>
<related>
<modulelist>
<module>mod_env</module>
<module>mod_rewrite</module>
<module>mod_setenvif</module>
<module>mod_unique_id</module>
</modulelist>
<directivelist>
<directive module="mod_setenvif">BrowserMatch</directive>
<directive module="mod_setenvif">BrowserMatchNoCase</directive>
<directive module="mod_env">PassEnv</directive>
<directive module="mod_rewrite">RewriteRule</directive>
<directive module="mod_env">SetEnv</directive>
<directive module="mod_setenvif">SetEnvIf</directive>
<directive module="mod_setenvif">SetEnvIfNoCase</directive>
<directive module="mod_env">UnsetEnv</directive>
</directivelist>
</related>
<section id="basic-manipulation">
<title>�⺻���� ȯ�漳��</title>
<p>����ġ���� ȯ�溯���� �����ϴ� ���� �⺻���� �����
���������� <directive module="mod_env"
>SetEnv</directive> ���þ ����ϴ� ���̴�. <directive
module="mod_env">PassEnv</directive> ���þ ����Ͽ�
������ ������ ������ ȯ�溯���� ������ ���� �ִ�.</p>
</section>
<section id="conditional">
<title>��û�� �� ���Ǻ� ����</title>
<p>�� �����ϰ�, mod_setenvif�� �����ϴ� ���þ�� ��û����
��û�� Ư¡�� ��� ȯ�溯���� �����Ѵ�. ���� ���, Ư��
������� (User-Agent) ��û�ϰų� Ư�� Referer (�������
Ʋ���� �ʾҴ�) ����� �ִ� ��쿡�� ������ ������ ��
�ִ�. ������ mod_rewrite�� �ִ� <directive
module="mod_rewrite">RewriteRule</directive>��
<code>[E=...]</code> �ɼ��� ����Ͽ� �� �����ϰ� ȯ�溯����
������ ���� �ִ�.</p>
</section>
<section id="unique-identifiers">
<title>������ ���</title>
<p>���������� mod_unique_id�� �� ��û�� ���� � ��쿡��
"���" ��û�߿� Ȯ���� ������(��ġ������) ������
<code>UNIQUE_ID</code> ȯ�溯���� �����Ѵ�.</p>
</section>
<section id="standard-cgi">
<title>ǥ�� CGI ����</title>
<p>CGI ��ũ��Ʈ�� SSI ������ ����ġ �������� �����Ͽ��ų�
������ ������ ȯ�溯�� �ܿ� �߰��� <a
href="http://cgi-spec.golux.com/">CGI �Ծ�</a>�� ������
��û�� ���� ������ �˷��ִ� ȯ�溯������ �޴´�.</p>
</section>
<section id="caveats">
<title>������ ��</title>
<ul>
<li>ȯ�漳�� ���þ ����Ͽ� ǥ�� CGI ������ �����ϰų�
������ �� ���.</li>
<li><a href="suexec.html">suexec</a>�� CGI ��ũ��Ʈ��
�����ϴ� ���, �����ϱ��� CGI ��ũ��Ʈ�� ȯ����
<em>������</em> �����鸸 �������� û�ҵȴ�.
<em>������</em> ���� ����� �����Ͻ�
<code>suexec.c</code>�� ���ǵȴ�.</li>
<li>������ ���� ȯ�溯�� �̸����� ���� ����, ����,
���ٹ��ڸ� ����ϴ� ���� ����. ��, ù��° ���ڷ�
���ڸ� ��������ʴ� ���� ����. CGI ��ũ��Ʈ�� SSI
�������� �Ѿ�� �̿��� ���ڴ� ���ٷ� ��ü�ȴ�.</li>
</ul>
</section>
</section>
<section id="using">
<title>ȯ�溯�� ����ϱ�</title>
<related>
<modulelist>
<module>mod_authz_host</module>
<module>mod_cgi</module>
<module>mod_ext_filter</module>
<module>mod_headers</module>
<module>mod_include</module>
<module>mod_log_config</module>
<module>mod_rewrite</module>
</modulelist>
<directivelist>
<directive module="mod_authz_host">Allow</directive>
<directive module="mod_log_config">CustomLog</directive>
<directive module="mod_authz_host">Deny</directive>
<directive module="mod_ext_filter">ExtFilterDefine</directive>
<directive module="mod_headers">Header</directive>
<directive module="mod_log_config">LogFormat</directive>
<directive module="mod_rewrite">RewriteCond</directive>
<directive module="mod_rewrite">RewriteRule</directive>
</directivelist>
</related>
<section id="cgi-scripts">
<title>CGI ��ũ��Ʈ</title>
<p>ȯ�溯���� �ֵ� �뵵�� �ϳ��� CGI ��ũ��Ʈ�� ������
��ȯ�ϴ� ���̴�. �տ��� �����ߵ��� ����ġ �������� ������
�����ܿ� ��û�� ���� ǥ�� ������ ���� ������ CGI ��ũ��Ʈ��
�Ѿ��. �� �ڼ��� ������ <a href="howto/cgi.html">CGI
���丮��</a>�� ����϶�.</p>
</section>
<section id="ssi-pages">
<title>SSI ������</title>
<p>mod_include�� <code>INCLUDES</code> ���Ͱ� ó���ϴ�
�����Ľ� (SSI) ������ <code>echo</code> ��Ҹ� ����Ͽ�
ȯ�溯���� ����� �� �ְ�, ȯ�溯���� ����Ͽ� ��û��
Ư¡�� ��� �帧���� ��ҷ� �������� �Ϻθ� ������ ��
�ִ�. ����ġ�� �� SSI �������� ������ ������ ǥ�� CGI
ȯ�溯���� �����Ѵ�. �� �ڼ��� ������ <a
href="howto/ssi.html">SSI ���丮��</a>�� ����϶�.</p>
</section>
<section id="access-control">
<title>��������</title>
<p><code>allow from env=</code>�� <code>deny from env=</code>
���þ ����Ͽ� ȯ�溯�� ���� ��� �������� ������
������ �� �ִ�. <directive
module="mod_setenvif">SetEnvIf</directive>�� ���� ����ϸ�
Ŭ���̾�Ʈ�� Ư¡�� ��� �����Ӱ� �������� ������ ������
�� �ִ�. ���� ���, Ư�� �������� (User-Agent) ������
�ź��� �� �ִ�.</p>
</section>
<section id="logging">
<title>���Ǻ� �α�</title>
<p><directive module="mod_log_config">LogFormat</directive>��
<code>%e</code> �ɼ��� ����Ͽ� ȯ�溯���� ���� �α׿�
����� �� �ִ�. ��, <directive
module="mod_log_config">CustomLog</directive> ���þ���
���Ǻ� ����� ����ϸ� ȯ�溯���� ��Ȳ�� ��� ��û��
�α����� ���θ� ������ �� �ִ�. <directive
module="mod_setenvif">SetEnvIf</directive>�� ���� ����Ͽ�
� ��û�� �α����� �����Ӱ� ������ �� �ִ�. ���� ���,
���ϸ��� <code>gif</code>�� ������ ��û�� �α����� �ʰų�,
�ܺ� ��Ʈ���� �ִ� Ŭ���̾�Ʈ�� ��û���� �α��� �� �ִ�.</p>
</section>
<section id="response-headers">
<title>���Ǻ� ���� ���</title>
<p><directive module="mod_headers">Header</directive>
���þ�� Ŭ���̾�Ʈ���� ������ ������ ȯ�溯���� ������
��� � HTTP ����� �������� ������ �� �ִ�. ����
���, Ŭ���̾�Ʈ�� ��û�� Ư�� ����� �ִ� ��쿡��
� ���� ����� ���� �� �ִ�.</p>
</section>
<section id="external-filter">
<title>�ܺ� ���� �����ϱ�</title>
<p><module>mod_ext_filter</module>�� <directive
module="mod_ext_filter">ExtFilterDefine</directive>
���þ�� ������ �ܺ� ���͸� <code>disableenv=</code>��
<code>enableenv=</code> �ɼ��� ����Ͽ� ȯ�溯���� ���
���������� ������ �� �ִ�.</p>
</section>
<section id="url-rewriting">
<title>URL ���ۼ�(Rewriting)</title>
<p><directive module="mod_rewrite">RewriteCond</directive>��
<em>TestString</em>�� <code>%{ENV:...}</code> �����
����ϸ� mod_rewrite�� ���ۼ� ������ ȯ�溯���� ���
�ٸ��� �ൿ�Ѵ�. mod_rewrite���� �տ� <code>ENV:</code>��
�������ʰ� �����ϴ� ������ ���� ȯ�溯���� �ƴ��� �����϶�.
�׵��� �ٸ� ��⿡�� ���� �� ��� mod_rewrite�� ������
������.</p>
</section>
</section>
<section id="special">
<title>Ư���� ������ ȯ�溯��</title>
<p>Ŭ���̾�Ʈ�� ��Ȱ�� �����ϱ����� ����ġ�� Ư����
Ŭ���̾�Ʈ�� ���� �ڽ��� �ൿ�� �����Ѵ�. ���� <directive
module="mod_setenvif">BrowserMatch</directive>����
ȯ�溯���� �����Ͽ� �̷� ������ �ذ��Ѵ�. �׷��� <directive
module="mod_env">SetEnv</directive>�� <directive
module="mod_env">PassEnv</directive>�ε� �����ϴ�.</p>
<section id="downgrade">
<title>downgrade-1.0</title>
<p>��û�� ���� ������ ����ϴ��� HTTP/1.0 ��û����
ó���Ѵ�.</p>
</section>
<section id="force-no-vary">
<title>force-no-vary</title>
<p>������ Ŭ���̾�Ʈ���� ������ �� ���� �������
<code>Vary</code> �ʵ带 ����. � Ŭ���̾�Ʈ�� ��
�ʵ带 ����� �ؼ����� ���Ѵ�. �� ������ �̷� ������
�ذ��Ѵ�. ����, �� ������
<strong>force-response-1.0</strong>�� �����Ѵ�.</p>
</section>
<section id="force-response">
<title>force-response-1.0</title>
<p>HTTP/1.0 ��û�� �ϴ� Ŭ���̾�Ʈ���� HTTP/1.0 ������
�����Ѵ�. �� AOL ���Ͻÿ� ������ �־ ���������.
� HTTP/1.0 Ŭ���̾�Ʈ�� HTTP/1.1 ������ ������ �����
�������� �����Ƿ�, �� ������ �ذ��ϱ����� ����Ѵ�.</p>
</section>
<section id="gzip-only-text-html">
<title>gzip-only-text/html</title>
<p>���� "1"�̸� <code>text/html</code>�� �ƴ� content-type��
���� <module>mod_deflate</module>�� DEFLATE ������͸�
������� �ʴ´�. (gzip �Ӹ� �ƴ϶� "identity"�� �ƴ� ���
���ڵ���) �������� ������ ������ ��쿡��
<module>mod_negotiation</module>�� �� ������ ����Ѵ�.</p>
</section>
<section id="no-gzip"><title>no-gzip</title>
<p>�� �ɼ��� �����ϸ� <module>mod_deflate</module>��
<code>DEFLATE</code> ���͸� ������� �ʰ�,
<module>mod_negotiation</module>�� ���ڵ�� �ڿ���
������ �ʴ´�.</p>
</section>
<section id="nokeepalive">
<title>nokeepalive</title>
<p><directive module="core">KeepAlive</directive>��
�����Ѵ�.</p>
</section>
<section id="prefer-language"><title>prefer-language</title>
<p>�� ������ <module>mod_negotiation</module>�� �ൿ��
������ ��ģ��. ������ (<code>en</code>, <code>ja</code>,
<code>x-klingon</code> ��) ����±׸� ����ִٸ�,
<module>mod_negotiation</module>�� �� ���� �� ������
������ �õ��Ѵ�. �׷� ������ ��ٸ� �Ϲ����� <a
href="content-negotiation.html">���</a> ������ �����Ѵ�.</p>
</section>
<section id="redirect-carefully">
<title>redirect-carefully</title>
<p>������ �� ������ Ŭ���̾�Ʈ���� �����̷����� ������.
���� �����̷����� ó���ϴµ� ������ �ִ� Ŭ���̾�Ʈ��
���� ����Ѵ�. �� Microsoft�� WebFolders ����Ʈ���
DAV �޽�带 ���� ���丮 �ڿ��� �����̷����� ó���ϴµ�
������ �־ ���������.</p>
</section>
<section id="suppress-error-charset">
<title>suppress-error-charset</title>
<p><em>2.0.40 ���� ���� �ִ�</em></p>
<p>����ġ�� Ŭ���̾�Ʈ�� ��û�� ���� �������� �����̷�����
������ Ŭ���̾�Ʈ�� �ڵ����� �����̷����� ����� ���ϴ�(Ȥ��
�ʴ�) ��쿡 ����Ͽ� ���信 ����ڿ��� ������ ������ �����Ѵ�.
����ġ�� ���� �� ���� ����ġ�� ����ϴ� ���������� ISO-8859-1��
ǥ���Ѵ�.</p>
<p>�׷��� �����̷��ǵ� �������� �ٸ� ���������� ����� ���
� �̻��� ������ ������ ���� �������� �ƴ϶� �����̷���
�������� ���������� ����Ϸ��� �Ѵ�. ���� ���, �׸����
�̻��ϰ� ���� �� �ִ�.</p>
<p>�� ȯ�溯���� ����ġ�� �����̷��� �������� ����������
���������ʵ��� �Ͽ�, �̷� ������ ���� �������� ����������
�ùٷ� ����ϰ� �����.</p>
</section>
</section>
<section id="examples">
<title>����</title>
<section id="misbehaving">
<title>�߸� �����ϴ� Ŭ���̾�Ʈ���� ���� �������� �ൿ
�����ϱ�</title>
<p>Ŭ���̾�Ʈ���� �̹� �˷��� ������ �ذ��ϱ�����
httpd.conf�� ���� ������ �����ϱ� �ٶ���.</p>
<example><pre>
#
# ���� ���þ���� �Ϲ����� HTTP ������ �����Ѵ�.
# ù��° ���þ�� Netscape 2.x�� �̸� ������ �������
# keepalive�� ������� �ʴ´�. �̵� ������ ������ ������ �ִ�.
# �ι�° ���þ�� HTTP/1.1 ������ �߸�Ǿ�� 301�̳� 302
# (�����̷���) ���信 ����� keepalive�� ����� ��������
# ���ϴ� Microsoft Internet Explorer 4.0b2�� ���� ���̴�.
#
BrowserMatch "Mozilla/2" nokeepalive
BrowserMatch "MSIE 4\.0b2;" nokeepalive downgrade-1.0 force-response-1.0
#
# ���� ���þ�� �⺻���� HTTP/1.1 ������ �������� ���Ͽ�
# HTTP/1.0 �Ծ��� ���� ������� HTTP/1.1 ������ ������ �ʴ´�.
#
BrowserMatch "RealPlayer 4\.0" force-response-1.0
BrowserMatch "Java/1\.0" force-response-1.0
BrowserMatch "JDK/1\.0" force-response-1.0</pre></example>
</section>
<section id="no-img-log">
<title>���� �α׿� �̹����� ���� ��û�� �α����� �ʱ�</title>
<p>�� ������ �̹����� ���� ��û�� ���� �α׿� �������
�ʴ´�. Ư�� ���丮�� ���� Ȥ�� Ư�� ȣ��Ʈ���� ��
��û�� �α����� �ʵ��� ���� ������ �� �ִ�.</p>
<example><pre>
SetEnvIf Request_URI \.gif image-request
SetEnvIf Request_URI \.jpg image-request
SetEnvIf Request_URI \.png image-request
CustomLog logs/access_log common env=!image-request</pre></example>
</section>
<section id="image-theft">
<title>"�̹��� ����" ����</title>
<p>�� ���� ���� �������� ����ڰ� �������� ������ �ִ�
�̹����� �������� ���ϵ��� �ϴ� ����� �����Ѵ�. ��
������ ���������� ������, ���ѵ� ��쿡�� �����Ѵ�.
�츮�� ��� �̹����� /web/images ���丮 �ȿ� �ִٰ�
�����Ѵ�.</p>
<example><pre>
SetEnvIf Referer "^http://www.example.com/" local_referal
# Referer ������ ������ �ʴ� ������ ����Ѵ�
SetEnvIf Referer "^$" local_referal
&lt;Directory /web/images&gt;
Order Deny,Allow
Deny from all
Allow from env=local_referal
&lt;/Directory&gt;</pre></example>
<p>�� ��� ���� �ڼ��� ������ ApacheToday ���丮�� "<a
href="http://apachetoday.com/news_story.php3?ltsn=2000-06-14-002-01-PS">
Keeping Your Images from Adorning Other Sites</a>"�� ����϶�.</p>
</section>
</section>
</manualpage>