urlmapping.xml.ko revision ded301aa92e14cce77d47a9c4e77fd0b2f909a56
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer<?xml version="1.0" encoding="EUC-KR" ?>
d3498432822fb487e58f8f72bb5f880dd8307d7dMichael Sawyer<!DOCTYPE manualpage SYSTEM "/style/manualpage.dtd">
d3498432822fb487e58f8f72bb5f880dd8307d7dMichael Sawyer<?xml-stylesheet type="text/xsl" href="/style/manual.ko.xsl"?>
d3498432822fb487e58f8f72bb5f880dd8307d7dMichael Sawyer<!-- English Revision: 151408:1481360 (outdated) -->
d3498432822fb487e58f8f72bb5f880dd8307d7dMichael Sawyer
d3498432822fb487e58f8f72bb5f880dd8307d7dMichael Sawyer<!--
d3498432822fb487e58f8f72bb5f880dd8307d7dMichael Sawyer Licensed to the Apache Software Foundation (ASF) under one or more
d3498432822fb487e58f8f72bb5f880dd8307d7dMichael Sawyer contributor license agreements. See the NOTICE file distributed with
d3498432822fb487e58f8f72bb5f880dd8307d7dMichael Sawyer this work for additional information regarding copyright ownership.
d3498432822fb487e58f8f72bb5f880dd8307d7dMichael Sawyer The ASF licenses this file to You under the Apache License, Version 2.0
d3498432822fb487e58f8f72bb5f880dd8307d7dMichael Sawyer (the "License"); you may not use this file except in compliance with
d3498432822fb487e58f8f72bb5f880dd8307d7dMichael Sawyer the License. You may obtain a copy of the License at
d3498432822fb487e58f8f72bb5f880dd8307d7dMichael Sawyer
d3498432822fb487e58f8f72bb5f880dd8307d7dMichael Sawyer http://www.apache.org/licenses/LICENSE-2.0
d3498432822fb487e58f8f72bb5f880dd8307d7dMichael Sawyer
d3498432822fb487e58f8f72bb5f880dd8307d7dMichael Sawyer Unless required by applicable law or agreed to in writing, software
d3498432822fb487e58f8f72bb5f880dd8307d7dMichael Sawyer distributed under the License is distributed on an "AS IS" BASIS,
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer See the License for the specific language governing permissions and
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer limitations under the License.
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer-->
813d6c9781d1fb48bb5c1d6d3415e65f7be5eeb0Andreas Gustafsson
813d6c9781d1fb48bb5c1d6d3415e65f7be5eeb0Andreas Gustafsson<manualpage metafile="urlmapping.xml.meta">
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer
5b83a155564dc85c607046fba5e8a61f454cce05Andreas Gustafsson <title>URL�� ���Ͻý��� ��ġ�� �����ϱ�</title>
813d6c9781d1fb48bb5c1d6d3415e65f7be5eeb0Andreas Gustafsson
10bc8ffed60f064a2950527a82d7fdffe91b6206Michael Sawyer <summary>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer <p>�� ������ ��û�� URL�� ������ ����ġ�� ��� ������
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer ������ ���Ͻý��ۻ� ��ġ�� ã���� �����Ѵ�.</p>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer </summary>
813d6c9781d1fb48bb5c1d6d3415e65f7be5eeb0Andreas Gustafsson
10bc8ffed60f064a2950527a82d7fdffe91b6206Michael Sawyer<section id="related"><title>��õ� ���� ���þ��</title>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer<related>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer<modulelist>
5cca51c7c1fc07d0c0a76c7d26af5344d537a24bMichael Sawyer<module>mod_alias</module>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer<module>mod_proxy</module>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer<module>mod_rewrite</module>
5b83a155564dc85c607046fba5e8a61f454cce05Andreas Gustafsson<module>mod_userdir</module>
5b83a155564dc85c607046fba5e8a61f454cce05Andreas Gustafsson<module>mod_speling</module>
d81a745bbbe31cb421702c4b9e9585d2ba858205Michael Sawyer<module>mod_vhost_alias</module>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer</modulelist>
ac4f76549c1394bfdc63007d39f448d4a1cdbeceMichael Sawyer<directivelist>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer<directive module="mod_alias">Alias</directive>
813d6c9781d1fb48bb5c1d6d3415e65f7be5eeb0Andreas Gustafsson<directive module="mod_alias">AliasMatch</directive>
10bc8ffed60f064a2950527a82d7fdffe91b6206Michael Sawyer<directive module="mod_speling">CheckSpelling</directive>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer<directive module="core">DocumentRoot</directive>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer<directive module="core">ErrorDocument</directive>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer<directive module="core">Options</directive>
813d6c9781d1fb48bb5c1d6d3415e65f7be5eeb0Andreas Gustafsson<directive module="mod_proxy">ProxyPass</directive>
10bc8ffed60f064a2950527a82d7fdffe91b6206Michael Sawyer<directive module="mod_proxy">ProxyPassReverse</directive>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer<directive module="mod_proxy">ProxyPassReverseCookieDomain</directive>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer<directive module="mod_proxy">ProxyPassReverseCookiePath</directive>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer<directive module="mod_alias">Redirect</directive>
5cca51c7c1fc07d0c0a76c7d26af5344d537a24bMichael Sawyer<directive module="mod_alias">RedirectMatch</directive>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer<directive module="mod_rewrite">RewriteCond</directive>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer<directive module="mod_rewrite">RewriteMatch</directive>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer<directive module="mod_alias">ScriptAlias</directive>
5b83a155564dc85c607046fba5e8a61f454cce05Andreas Gustafsson<directive module="mod_alias">ScriptAliasMatch</directive>
5b83a155564dc85c607046fba5e8a61f454cce05Andreas Gustafsson<directive module="mod_userdir">UserDir</directive>
d81a745bbbe31cb421702c4b9e9585d2ba858205Michael Sawyer</directivelist>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer</related>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer</section>
ac4f76549c1394bfdc63007d39f448d4a1cdbeceMichael Sawyer
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer<section id="documentroot"><title>DocumentRoot</title>
813d6c9781d1fb48bb5c1d6d3415e65f7be5eeb0Andreas Gustafsson
10bc8ffed60f064a2950527a82d7fdffe91b6206Michael Sawyer <p>��û�� ���� ����ġ�� � ������ �������� �����ϱ�����
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer �⺻������ ��û�� URL-���(URL���� ȣ��Ʈ��� ��Ʈ �ڿ�
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer ������ �κ�)�� �������Ͽ��� ������ <directive
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer module="core">DocumentRoot</directive> �ڿ� ���δ�. �׷���
813d6c9781d1fb48bb5c1d6d3415e65f7be5eeb0Andreas Gustafsson <directive module="core">DocumentRoot</directive> �Ʒ��ִ�
10bc8ffed60f064a2950527a82d7fdffe91b6206Michael Sawyer ���ϰ� ���丮���� ������ ���Ե� �⺻���� �����̴�.</p>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer</section>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer<section id="outside"><title>DocumentRoot �ۿ� �ִ� ���ϵ�</title>
5cca51c7c1fc07d0c0a76c7d26af5344d537a24bMichael Sawyer
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer <p>���� ���Ͻý��ۿ��� <directive
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer module="core">DocumentRoot</directive> �Ʒ� �������� �κ���
5b83a155564dc85c607046fba5e8a61f454cce05Andreas Gustafsson ������ ������ �ʿ䰡 �ִ�. ����ġ�� �� ��� �������� �����
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer ����� �� �ִ�. ���н� �ý��ۿ��� �ɺ���ũ�� ����Ͽ�
5b83a155564dc85c607046fba5e8a61f454cce05Andreas Gustafsson ���Ͻý����� �ٸ� �κ��� <directive
d81a745bbbe31cb421702c4b9e9585d2ba858205Michael Sawyer module="core">DocumentRoot</directive> �Ʒ��� �� �� �ִ�.
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer ������ ���� ����ġ�� �ش� ���丮�� <directive
ac4f76549c1394bfdc63007d39f448d4a1cdbeceMichael Sawyer module="core">Options</directive> ������
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer <code>FollowSymLinks</code>��
813d6c9781d1fb48bb5c1d6d3415e65f7be5eeb0Andreas Gustafsson <code>SymLinksIfOwnerMatch</code>�� �ִ� ��쿡�� �ɺ���ũ��
10bc8ffed60f064a2950527a82d7fdffe91b6206Michael Sawyer ��󰣴�.</p>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer <p>��, <directive module="mod_alias">Alias</directive>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer ���þ�� ���Ͻý����� Ư�� �κ��� ���� �����Ѵ�. ����
813d6c9781d1fb48bb5c1d6d3415e65f7be5eeb0Andreas Gustafsson ��� ������ ���ٸ�</p>
10bc8ffed60f064a2950527a82d7fdffe91b6206Michael Sawyer
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer<example>Alias /docs /var/web</example>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer <p>URL <code>http://www.example.com/docs/dir/file.html</code>��
5cca51c7c1fc07d0c0a76c7d26af5344d537a24bMichael Sawyer <code>/var/web/dir/file.html</code>�� ������ �����Ѵ�.
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer ������ ��ο� �ִ� ��� ������ CGI ��ũ��Ʈ�� ����ϴ� ����
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer �����ϰ�� <directive module="mod_alias">ScriptAlias</directive>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer ���þ ���� ���� �Ѵ�.</p>
208c4f45c8c9b533330b5380e34338c8eabcd024Michael Sawyer
208c4f45c8c9b533330b5380e34338c8eabcd024Michael Sawyer <p><directive module="mod_alias">AliasMatch</directive>��
208c4f45c8c9b533330b5380e34338c8eabcd024Michael Sawyer <directive module="mod_alias">ScriptAliasMatch</directive>
bd334e0366c0f21bf15de9282b02f1bed4ccde14Michael Sawyer ���þ��� ������ ����ǥ���ı�� ������ ��ġ�� ����Ͽ� ��
������ ������ �����ϴ�. ���� ���,</p>
<example>ScriptAliasMatch ^/~([a-zA-Z0-9]+)/cgi-bin/(.+)
/home/$1/cgi-bin/$2</example>
<p>�� <code>http://example.com/~user/cgi-bin/script.cgi</code>����
��û�� ��� <code>/home/user/cgi-bin/script.cgi</code>��
�����ϰ�, �ش� ������ CGI ��ũ��Ʈ�� ����Ѵ�.</p>
</section>
<section id="user"><title>����� ���丮</title>
<p>���н� �ý����� ���������� Ư�� ����� <em>user</em>��
Ȩ���丮�� <code>~user/</code>�� ��Ī�Ѵ�.
<module>mod_userdir</module> ����� �� ������ ��������
Ȯ���Ͽ�, ������ ���� URL�� ������ �� ����� Ȩ���丮
�ȿ� �ִ� ������ �����Ѵ�.</p>
<example>http://www.example.com/~user/file.html</example>
<p>���Ȼ� ������ ����� Ȩ���丮�� ���� ������ �� ������
�ȵȴ�. �׷��� <directive module="mod_userdir">UserDir</directive>
���þ�� ����� Ȩ���丮���� ���� ���ϵ��� ���� ���丮��
�����Ѵ�. �⺻ ���� <code>Userdir public_html</code>�� ����ϰ�
<code>/home/user/</code>�� <code>/etc/passwd</code>�� ������
����� Ȩ���丮���, ���� URL�� ����
<code>/home/user/public_html/file.html</code>�� �����Ѵ�.</p>
<p>��, <code>Userdir</code> ���þ�� <code>/etc/passwd</code>��
Ȩ���丮�� ��ġ�� ��������ʴ� �ý����� ���� ���� �ٸ�
���¸� ����� �� �ִ�.</p>
<p>� ����� (���� ������ <code>%7e</code>�� ���ڵ�Ǵ�)
"~" ��ȣ�� �̻��Ͽ� �ٸ� ������� ����� ���丮�� ��Ÿ����
�;��Ѵ�. �� ����� mod_userdir�� ���������ʴ´�. �׷���
����� Ȩ���丮�� ��Ģ���� ������� �������ִٸ�, <directive
module="mod_alias">AliasMatch</directive> ���þ ����Ͽ�
���ϴ� ȿ�� ���� �� �ִ�. ���� ���, ������
<code>AliasMatch</code> ���þ ����ϸ�
<code>http://www.example.com/upages/user/file.html</code>��
<code>/home/user/public_html/file.html</code>�� �����Ѵ�:</p>
<example>AliasMatch ^/upages/([a-zA-Z0-9]+)/?(.*)
/home/$1/public_html/$2</example>
</section>
<section id="redirect"><title>URL �����̷���(Redirection)</title>
<p>�տ��� ������ ���� ���þ���� ����ġ�� ���Ͻý����� Ư��
��ҿ� �ִ� ������ Ŭ���̾�Ʈ���� ������ �����. �׷���
������ ��û�� ������ �ٸ� URL�� �ִٰ� Ŭ���̾�Ʈ���� �˷��־�,
Ŭ���̾�Ʈ�� ���� �� URL�� ��û�ϵ��� ����� ���� ���� ����
�ִ�. �̸� <em>�����̷���(redirection)</em>�̶�� �ϸ�,
<directive module="mod_alias">Redirect</directive> ���þ
����Ѵ�. ���� ���, <directive
module="core">DocumentRoot</directive> �Ʒ� <code>/foo/</code>
���丮�� ������ ���� <code>/bar/</code> ���丮�� �Ű�ٸ�
������ ���� Ŭ���̾�Ʈ�� ���ο� ��ġ�� ��û�ϵ��� �Ѵ�:</p>
<example>Redirect permanent /foo/
http://www.example.com/bar/</example>
<p>�׷��� <code>www.example.com</code> ������ <code>/foo/</code>��
�����ϴ� URL-��δ� <code>/foo/</code>�� <code>/bar/</code>��
�ٲ� URL�� �����̷��ǵȴ�. Ŭ���̾�Ʈ�� �� �����ܿ� �
�ٸ� �����ε� �����̷����� �� �ִ�.</p>
<p>��, ����ġ�� �� ������ ���ۼ� ������ ����
<directive module="mod_alias">RedirectMatch</directive>
���þ �����Ѵ�. ���� ���, �ٸ� ��û�� �״�� �ΰ� ����Ʈ
Ȩ�������� ���� ��û���� �ٸ� ����Ʈ�� �����̷����Ϸ���:</p>
<example>RedirectMatch permanent ^/$
http://www.example.com/startpage.html</example>
<p>�ӽ÷� ����Ʈ�� ��� �������� �ٸ� ����Ʈ�� Ư�� ��������
�����̷����Ϸ���:</p>
<example>RedirectMatch temp .*
http://othersite.example.com/startpage.html</example>
</section>
<section id="proxy"><title>�����Ͻ�(Reverse Proxy)</title>
<p>����ġ�� �ٸ� ������ �ִ� ������ ������ URL ������ ������
�� �ִ�. �� ��� �������� ��� �������� ������ �����ͼ�
Ŭ���̾�Ʈ���� ����ϴ� ���Ͻ� ������ ���� �����ϱ⶧���� �̷�
����� <em>�����Ͻ�(reverse proxying)</em>��� �Ѵ�. Ŭ���̾�Ʈ��
���忡�� �����Ͻ� ������ ������ �����ִ� ��ó�� ���̹Ƿ� �Ϲ�
���Ͻÿʹ� �ٸ���.</p>
<p>�Ʒ� �������� Ŭ���̾�Ʈ�� <code>/foo/</code>�� �ִ� ������
��û�ϸ�, ������ <code>internal.example.com</code>��
<code>/bar/</code> ���丮���� ������ �����ͼ� ������ ��ġ
������ �־�� ��ó�� Ŭ���̾�Ʈ���� ������.</p>
<example>
ProxyPass /foo/ http://internal.example.com/bar/<br />
ProxyPassReverse /foo/ http://internal.example.com/bar/
</example>
<p><directive module="mod_proxy">ProxyPass</directive>�� ������
������ ������ ���������� �����ϸ�, <directive
module="mod_proxy">ProxyPassReverse</directive> ���þ��
<code>internal.example.com</code>�� ������ �����̷����� ���ۼ��Ͽ�
�����̷����� ���� ������ ������ ���丮�� ����Ű���� �Ѵ�.
��, <directive
module="mod_proxy">ProxyPassReverseCookieDomain</directive>��
<directive module="mod_proxy">ProxyPassReverseCookieDomain</directive>��
���� ������� �� ������ ���� ��Ű�� ���ۼ��Ѵ�.</p>
<p>�׷��� ���� �ȿ� �ִ� ��ũ�� ���ۼ����� ������ �����϶�.
<code>internal.example.com</code>�� ���� ��븵ũ�� Ŭ���̾�Ʈ��
���Ͻü����� �ƴ϶� <code>internal.example.com</code>���� ����
��û�ϰ� �Ѵ�. �����ڰ� ���� <a
href="http://apache.webthing.com/mod_proxy_html/">mod_proxy_html</a>
����� ����Ͽ� HTML�� XHTML�� �ִ� ��ũ�� ���ۼ��� �� �ִ�.</p>
</section>
<section id="rewrite"><title>���ۼ� ���� (Rewriting Engine)</title>
<p>�� ������ ġȯ�� �ʿ��Ҷ� <module>mod_rewrite</module>��
���ۼ� ������ ������ �ȴ�. �� ����� ���þ�� ������ ����
Ŭ���̾�Ʈ�� IP �ּ� �� ��û�� Ư¡�� ������ ��� �ִ�
������ �������� ������ �� �ִ�. ��, mod_rewrite�� ��û��
��� ó������ �����ϱ����� �ܺ� �����ͺ��̽� �����̳�
���α׷��� ����� �� �ִ�. ���ۼ� ������ ������ �ٷ� ��
���� ����, ��, ���� �����̷��� (alias), �ܺ� �����̷���,
���Ͻ�, ��θ� �����Ѵ�. mod_rewrite�� ����ϴ� ���� ����
<a href="misc/rewriteguide.html">URL ���ۼ� ��ħ��</a>����
�����Ѵ�.</p>
</section>
<section id="notfound"><title>File Not Found</title>
<p>�ᱹ ��û�� URL�� �����ϴ� ������ ���Ͻý��ۿ��� ã��
���� ����̴�. ���� ���� ������ �ִ�. � ��� ������
�ٸ� ������ �Ű�� ������ �� �ִ�. �� ��� Ŭ���̾�Ʈ����
<a href="#redirect">URL �����̷���</a>���� �ڿ��� ���ο�
��ġ�� �˷��ִ� ����� ���� ����. �׷��� �ڿ��� �Űܵ�
������ �ϸ�ũ�� ��ũ�� ��� ��ȿ�ϴ�.</p>
<p>"File Not Found" ������ �ٸ� �Ϲ����� ������ ������
���� Ȥ�� HTML ��ũ�� URL�� �߸� �Էµ� ����̴�. ����ġ��
<module>mod_speling</module> (������� Ʋ���� �ʾ���) ����
�̿� ���� ������ ���´�. �� ����� ����ϸ� "File Not Found"
���� �߻��ϴ� ��� ����� ���ϸ��� ���� �ڿ��� ã�´�.
���� �߰��ϸ� mod_speling�� Ŭ���̾�Ʈ�� �ùٸ� ��ġ��
HTTP �����̷����Ѵ�. "�����" ������ ������ �ִٸ�
Ŭ���̾�Ʈ���� ����� ������.</p>
<p>mod_speling�� Ư�� ������ ������ ��ҹ��ڸ� ���������ʰ�
���ϸ��� ���ϴ� ����̴�. �׷��� ���н� ���Ͻý��۰� URL��
��ҹ��� ������ �������ϴ� ����ڰ� �ִ� �ý��ۿ� ������
�ȴ�. �׷��� mod_speling�� ���� URL�� ���ľ��Ѵٸ�, "�߸��"
��û������ URL �����̷��ǰ� Ŭ���̾�Ʈ�� ���ο� ��û��
�Ͼ�Ƿ� ������ �δ��� �ȴ�.</p>
<p>ã�� �õ��� ��� �����ϸ� ����ġ�� HTTP status code 404
(file not found) ������������ ������. �� �������� ������
<directive module="core">ErrorDocument</directive> ���þ��
�����ϸ�, <a href="custom-error.html">��������� ���� ����</a>
������ ����Ͽ� ����������� �� �ִ�.</p>
</section>
</manualpage>