diff options
| author | Jeon Jeongho <maczniak@apache.org> | 2004-07-09 13:20:16 +0000 |
|---|---|---|
| committer | Jeon Jeongho <maczniak@apache.org> | 2004-07-09 13:20:16 +0000 |
| commit | 0755c9714d32c38e5a10d800e304c0dffc1a920b (patch) | |
| tree | 99be7e9288e8eeb0ca4b1fbf763de45e0fc87416 | |
| parent | 959d2468442b7e1cae934fae78515c660dee6d7e (diff) | |
| download | httpd-0755c9714d32c38e5a10d800e304c0dffc1a920b.tar.gz | |
commit a few Korean files and up-to-date patches
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@104203 13f79535-47bb-0310-9956-ffa450edef68
103 files changed, 5042 insertions, 937 deletions
diff --git a/docs/manual/bind.html.ko.euc-kr b/docs/manual/bind.html.ko.euc-kr index 881871f2ba..00e9652612 100644 --- a/docs/manual/bind.html.ko.euc-kr +++ b/docs/manual/bind.html.ko.euc-kr @@ -24,8 +24,6 @@ <a href="./ja/bind.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="./ko/bind.html" title="Korean"> ko </a></p> </div> -<div class="outofdate">이 문서는 최신판 번역이 아닙니다. - 최근에 변경된 내용은 영어 문서를 참고하세요.</div> <p>아파치가 특정 주소와 포트에서 서비스하도록 설정하기.</p> </div> @@ -37,10 +35,10 @@ <div class="section"> <h2><a name="overview" id="overview">개요</a></h2> - + <table class="related"><tr><th>관련된 모듈</th><th>관련된 지시어</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li><li><code class="module"><a href="./mod/mpm_common.html">mpm_common</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code></li></ul></td></tr></table> - - + + <p>아파치를 시작하면 아파치는 컴퓨터의 어떤 포트와 주소에 연결하여, 들어오는 요청을 기다린다. 기본적으로 아파치는 컴퓨터의 모든 주소에서 기다린다. 그러나 아파치가 특정 포트나 @@ -52,7 +50,7 @@ 서버가 특정 포트나 주소와 포트 조합에서만 요청을 받게 한다. <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> 지시어에 포트 번호만 지정하면, 서버는 모든 인터페이스에서 - 지정한 포트를 기다린다. 여러 Listen 지시어로 기다릴 여러 + 지정한 포트를 기다린다. 여러 <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> 지시어로 기다릴 여러 주소와 포트를 지정할 수도 있다. 서버는 열거한 주소와 포트로 요청이 들어오면 응답한다.</p> @@ -98,18 +96,15 @@ 모두 처리하려면 대응 주소를 <strong>사용해야만</strong> 한다. 아파치가 최소한의 소켓을 사용하여 IPv4 연결과 IPv6 연결을 모두 받도록하려면, IPv4-대응 IPv6 주소를 사용하고 - 구성 옵션 <code>--enable-v4-mapped</code>를 지정한다.</p> - - <div class="example"><p><code> - Listen 80 - </code></p></div> + <a href="programs/configure.html">configure</a> 옵션 + <code>--enable-v4-mapped</code>를 지정한다.</p> <p><code>--enable-v4-mapped</code>는 FreeBSD, NetBSD, OpenBSD를 제외한 모든 플래폼에서 기본값이고, 아마도 당신의 아파치도 마찬가지일 것이다.</p> <p>플래폼과 APR의 지원여부와 관계없이 아파치가 IPv4 연결만을 - 받도록하려면, 다음 예제와 같이 모든 Listen 지시어에 IPv4 주소를 + 받도록하려면, 다음 예제와 같이 모든 <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> 지시어에 IPv4 주소를 사용한다:</p> <div class="example"><p><code> @@ -119,7 +114,8 @@ <p>플래폼에서 지원하며 아파치가 서로 다른 소켓으로 IPv4 연결과 IPv6 연결을 받도록하려면 (즉 IPv4-대응 주소를 사용하지 - 않으려면), 구성 옵션 <code>--disable-v4-mapped</code>를 + 않으려면), <a href="programs/configure.html">configure</a> + 옵션 <code>--disable-v4-mapped</code>를 지정한다. <code>--disable-v4-mapped</code>는 FreeBSD, NetBSD, OpenBSD에서 기본값이다.</p> @@ -128,7 +124,8 @@ <h2><a name="virtualhost" id="virtualhost">가상호스트와 어떻게 연관되나</a></h2> - <p>Listen은 가상호스트를 만들지 않는다. 이는 단지 주서버가 + <p><code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>은 + 가상호스트를 만들지 않는다. 이는 단지 주서버가 어떤 주소와 포트를 기다릴지만 알려준다. <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> 지시어를 사용하지 않으면, 서버는 받은 모든 요청을 똑같이 처리한다. 그러나 <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>로 여러 주소와 포트에 diff --git a/docs/manual/bind.xml.ko b/docs/manual/bind.xml.ko index 70d6d6e6d5..93f91f63e7 100644 --- a/docs/manual/bind.xml.ko +++ b/docs/manual/bind.xml.ko @@ -1,7 +1,7 @@ <?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.12 (outdated: 1.13) --> +<!-- English Revision: 1.13 --> <!-- Copyright 2003-2004 The Apache Software Foundation @@ -26,13 +26,13 @@ <summary> <p>아파치가 특정 주소와 포트에서 서비스하도록 설정하기.</p> </summary> - + <seealso><a href="vhosts/">가상호스트</a></seealso> <seealso><a href="dns-caveats.html">DNS 문제</a></seealso> <section id="overview"> <title>개요</title> - + <related> <modulelist> <module>core</module> @@ -43,8 +43,8 @@ <directive module="mpm_common">Listen</directive> </directivelist> </related> - - + + <p>아파치를 시작하면 아파치는 컴퓨터의 어떤 포트와 주소에 연결하여, 들어오는 요청을 기다린다. 기본적으로 아파치는 컴퓨터의 모든 주소에서 기다린다. 그러나 아파치가 특정 포트나 @@ -56,7 +56,8 @@ 서버가 특정 포트나 주소와 포트 조합에서만 요청을 받게 한다. <directive module="mpm_common">Listen</directive> 지시어에 포트 번호만 지정하면, 서버는 모든 인터페이스에서 - 지정한 포트를 기다린다. 여러 Listen 지시어로 기다릴 여러 + 지정한 포트를 기다린다. 여러 <directive + module="mpm_common">Listen</directive> 지시어로 기다릴 여러 주소와 포트를 지정할 수도 있다. 서버는 열거한 주소와 포트로 요청이 들어오면 응답한다.</p> @@ -102,18 +103,16 @@ 모두 처리하려면 대응 주소를 <strong>사용해야만</strong> 한다. 아파치가 최소한의 소켓을 사용하여 IPv4 연결과 IPv6 연결을 모두 받도록하려면, IPv4-대응 IPv6 주소를 사용하고 - 구성 옵션 <code>--enable-v4-mapped</code>를 지정한다.</p> - - <example> - Listen 80 - </example> + <a href="programs/configure.html">configure</a> 옵션 + <code>--enable-v4-mapped</code>를 지정한다.</p> <p><code>--enable-v4-mapped</code>는 FreeBSD, NetBSD, OpenBSD를 제외한 모든 플래폼에서 기본값이고, 아마도 당신의 아파치도 마찬가지일 것이다.</p> <p>플래폼과 APR의 지원여부와 관계없이 아파치가 IPv4 연결만을 - 받도록하려면, 다음 예제와 같이 모든 Listen 지시어에 IPv4 주소를 + 받도록하려면, 다음 예제와 같이 모든 <directive + module="mpm_common">Listen</directive> 지시어에 IPv4 주소를 사용한다:</p> <example> @@ -123,7 +122,8 @@ <p>플래폼에서 지원하며 아파치가 서로 다른 소켓으로 IPv4 연결과 IPv6 연결을 받도록하려면 (즉 IPv4-대응 주소를 사용하지 - 않으려면), 구성 옵션 <code>--disable-v4-mapped</code>를 + 않으려면), <a href="programs/configure.html">configure</a> + 옵션 <code>--disable-v4-mapped</code>를 지정한다. <code>--disable-v4-mapped</code>는 FreeBSD, NetBSD, OpenBSD에서 기본값이다.</p> @@ -132,7 +132,8 @@ <section id="virtualhost"> <title>가상호스트와 어떻게 연관되나</title> - <p>Listen은 가상호스트를 만들지 않는다. 이는 단지 주서버가 + <p><directive module="mpm_common">Listen</directive>은 + 가상호스트를 만들지 않는다. 이는 단지 주서버가 어떤 주소와 포트를 기다릴지만 알려준다. <directive module="core" type="section">VirtualHost</directive> 지시어를 사용하지 않으면, 서버는 받은 모든 요청을 똑같이 처리한다. diff --git a/docs/manual/bind.xml.meta b/docs/manual/bind.xml.meta index f08c64c7ba..deaef24040 100644 --- a/docs/manual/bind.xml.meta +++ b/docs/manual/bind.xml.meta @@ -10,6 +10,6 @@ <variant>en</variant> <variant outdated="yes">fr</variant> <variant>ja</variant> - <variant outdated="yes">ko</variant> + <variant>ko</variant> </variants> </metafile> diff --git a/docs/manual/cgi_path.html.ko.euc-kr b/docs/manual/cgi_path.html.ko.euc-kr index f658678505..145a60c56e 100644 --- a/docs/manual/cgi_path.html.ko.euc-kr +++ b/docs/manual/cgi_path.html.ko.euc-kr @@ -47,7 +47,7 @@ <div class="example"><p><code> Alias /cgi-ralph /usr/local/httpd/cgi-bin/user.cgi/ralph </code></p></div> - + <p>이 경우 <code>user.cgi</code>는 CGI 스크립트이고, "/ralph"는 CGI에 넘겨지는 정보다. 이 경우 "<code>/cgi-ralph/script/</code>"로 요청이 들어오면 PATH는 diff --git a/docs/manual/cgi_path.xml.ko b/docs/manual/cgi_path.xml.ko index 099ab4df9b..6b3d2e0871 100644 --- a/docs/manual/cgi_path.xml.ko +++ b/docs/manual/cgi_path.xml.ko @@ -43,7 +43,7 @@ <example> Alias /cgi-ralph /usr/local/httpd/cgi-bin/user.cgi/ralph </example> - + <p>이 경우 <code>user.cgi</code>는 CGI 스크립트이고, "/ralph"는 CGI에 넘겨지는 정보다. 이 경우 "<code>/cgi-ralph/script/</code>"로 요청이 들어오면 PATH는 diff --git a/docs/manual/content-negotiation.html.ko.euc-kr b/docs/manual/content-negotiation.html.ko.euc-kr index 8c9fdbdb8a..ba84f26faf 100644 --- a/docs/manual/content-negotiation.html.ko.euc-kr +++ b/docs/manual/content-negotiation.html.ko.euc-kr @@ -434,12 +434,12 @@ 동작하기위함이다.</p> <p>사용자가 선호하는 언어를 알아내기위한 (쿠키나 특별한 - URL-경로 같은) 고급 기법을 지원하기위해 아파치 2.0.47부터 - <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>은 <code>prefer-language</code>라는 - <a href="env.html">환경변수</a>를 인식한다. 이 환경변수가 - 존재하고 적절한 언어태그를 포함한다면, - <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>은 해당하는 변형을 선택하려고 - 시도한다. 그런 변형이 없다면 일반적인 협상과정을 시작한다.</p> + URL-경로 같은) 고급 기법을 지원하기위해 아파치 2.0.47부터 + <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>은 <code>prefer-language</code>라는 + <a href="env.html">환경변수</a>를 인식한다. 이 환경변수가 + 존재하고 적절한 언어태그를 포함한다면, + <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>은 해당하는 변형을 선택하려고 + 시도한다. 그런 변형이 없다면 일반적인 협상과정을 시작한다.</p> <div class="example"><h3>예제</h3><p><code> SetEnvIf Cookie "language=(.+)" prefer-language=$1 diff --git a/docs/manual/content-negotiation.xml.ko b/docs/manual/content-negotiation.xml.ko index ac4f25d745..f37f31f908 100644 --- a/docs/manual/content-negotiation.xml.ko +++ b/docs/manual/content-negotiation.xml.ko @@ -429,12 +429,12 @@ 동작하기위함이다.</p> <p>사용자가 선호하는 언어를 알아내기위한 (쿠키나 특별한 - URL-경로 같은) 고급 기법을 지원하기위해 아파치 2.0.47부터 - <module>mod_negotiation</module>은 <code>prefer-language</code>라는 - <a href="env.html">환경변수</a>를 인식한다. 이 환경변수가 - 존재하고 적절한 언어태그를 포함한다면, - <module>mod_negotiation</module>은 해당하는 변형을 선택하려고 - 시도한다. 그런 변형이 없다면 일반적인 협상과정을 시작한다.</p> + URL-경로 같은) 고급 기법을 지원하기위해 아파치 2.0.47부터 + <module>mod_negotiation</module>은 <code>prefer-language</code>라는 + <a href="env.html">환경변수</a>를 인식한다. 이 환경변수가 + 존재하고 적절한 언어태그를 포함한다면, + <module>mod_negotiation</module>은 해당하는 변형을 선택하려고 + 시도한다. 그런 변형이 없다면 일반적인 협상과정을 시작한다.</p> <example><title>예제</title> SetEnvIf Cookie "language=(.+)" prefer-language=$1 diff --git a/docs/manual/custom-error.html.ko.euc-kr b/docs/manual/custom-error.html.ko.euc-kr index 3d10a3d664..6254436939 100644 --- a/docs/manual/custom-error.html.ko.euc-kr +++ b/docs/manual/custom-error.html.ko.euc-kr @@ -25,10 +25,10 @@ <p>웹마스터는 오류나 문제가 발생했을때 아파치의 응답을 설정할 수 있다.</p> - + <p>서버가 오류나 문제를 발견했을때 보낼 사용자정의 응답을 정의할 수 있다.</p> - + <p>스크립트가 죽은 경우 "500 Server Error" 응답 대신 사용자에게 더 친근한 문구를 사용하거나 다른 (같은 사이트나 외부 사이트의) URL로 리다이렉션을 할 수 있다.</p> @@ -41,34 +41,34 @@ <div class="section"> <h2><a name="behavior" id="behavior">행동</a></h2> - + <h3>이전 행동</h3> - + <p>NCSA httpd 1.3은 사용자에게 무의미하고 지루한 오류문을 보냈다. 문제가 발생한 이유를 로그에 남길 수도 없었다.</p> - + <h3>새로운 행동</h3> - + <p>서버는 다음과 같은 일을 할 수 있다:</p> - + <ol> <li>NCSA의 고정된 문구 대신 다른 문구를 보여주거나</li> - + <li>같은 사이트의 URL로 리다이렉션하거나</li> - + <li>외부 사이트의 URL로 리다이렉션한다.</li> </ol> - + <p>다른 사이트의 URL로 리다이렉션하는 것이 유용할 수 있지만, 이 경우 문제를 설명하거나 로그하는데 필요한 정보중 일부만 전달된다.</p> - + <p>오류에 대한 정보를 전달하기위해 아파치는 CGI식의 새로운 환경변수를 정의한다:</p> - + <div class="example"><p><code> REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/x-xbitmap, image/jpeg<br /> @@ -83,9 +83,9 @@ REDIRECT_SERVER_SOFTWARE=Apache/0.8.15<br /> REDIRECT_URL=/cgi-bin/buggy.pl </code></p></div> - + <p><code>REDIRECT_</code> 접두사에 주목하라.</p> - + <p>최소한 <code>REDIRECT_URL</code>과 <code>REDIRECT_QUERY_STRING</code>은 (cgi-script나 cgi-include일) 새 URL로 넘겨진다. 다른 변수는 오류가 @@ -100,14 +100,14 @@ <div class="section"> <h2><a name="configuration" id="configuration">설정</a></h2> - + <p><code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code>가 적절히 설정되었다면 .htaccess 파일에서 <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>를 사용할 수 있다.</p> - + <p>다음은 예이다...</p> - + <div class="example"><p><code> ErrorDocument 500 /cgi-bin/crash-recover <br /> ErrorDocument 500 "Sorry, our script crashed. Oh dear" <br /> @@ -115,42 +115,42 @@ ErrorDocument 404 /Lame_excuses/not_found.html <br /> ErrorDocument 401 /Subscription/how_to_subscribe.html </code></p></div> - + <p>문법은,</p> - + <div class="example"><p><code> ErrorDocument <3-digit-code> <action> </code></p></div> - + <p>가능한 action은,</p> - + <ol> <li>출력할 문구. 따옴표 (")를 문구 앞에 붙인다. 뒤에 나오는 따옴표는 출력된다. <em>주의: 앞에 붙은 따옴표 (")는 출력되지 않는다.</em></li> - + <li>리다이렉션할 외부 URL.</li> - + <li>리다이렉션할 내부 URL.</li> </ol> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div> <div class="section"> <h2><a name="custom" id="custom">사용자정의 오류 응답과 리다이렉션</a></h2> - + <p>URL로 리다이렉션하는 아파치 행동은 스크립트/server-include에 환경변수를 더 넘겨주도록 변경되었다.</p> - + <h3>이전 행동</h3> - + <p>리다이렉션되는 스크립트에 표준 CGI 변수들이 넘어간다. 어디에서 리다이렉션이 일어났는지 알 수 없다.</p> - + <h3>새로운 행동</h3> - + <p>리다이렉션된 스크립트는 새로운 환경변수들을 사용할 수 있다. 모두 앞에 <code>REDIRECT_</code>가 붙어있다. <code>REDIRECT_</code> 환경변수는 원래 CGI 환경변수명 @@ -161,20 +161,20 @@ <code>REDIRECT_URL</code>과 <code>REDIRECT_STATUS</code>를 정의한다. 원래 URL과 리다이렉션된 URL 모두 접근 로그에 기록할 수 있다.</p> - + <p>ErrorDocument가 같은 서버에 있는 CGI 스크립트로 리다이렉션한다면, 스크립트는 클라이언트에게 오류 상황을 확실히 전달하기위해 출력에 "<code>Status:</code>" 헤더 필드를 포함해야 한다. 예를 들어, Perl로 작성한 ErrorDocument 스크립트는 다음과 같다:</p> - + <div class="example"><p><code> ... <br /> print "Content-type: text/html\n"; <br /> printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; <br /> ... </code></p></div> - + <p><code>404 Not Found</code>와 같은 특정 오류 상황에 대한 스크립트라면, 대신 <span class="transnote">(<em>역주;</em> 고정된)</span> 특정 상태코드와 오류문을 사용할 수 있다.</p> diff --git a/docs/manual/custom-error.xml.ko b/docs/manual/custom-error.xml.ko index 6223c72065..99aca542eb 100644 --- a/docs/manual/custom-error.xml.ko +++ b/docs/manual/custom-error.xml.ko @@ -20,51 +20,51 @@ --> <manualpage metafile="custom-error.xml.meta"> - + <title>사용자정의 오류 응답</title> - + <summary> <p>웹마스터는 오류나 문제가 발생했을때 아파치의 응답을 설정할 수 있다.</p> - + <p>서버가 오류나 문제를 발견했을때 보낼 사용자정의 응답을 정의할 수 있다.</p> - + <p>스크립트가 죽은 경우 "500 Server Error" 응답 대신 사용자에게 더 친근한 문구를 사용하거나 다른 (같은 사이트나 외부 사이트의) URL로 리다이렉션을 할 수 있다.</p> </summary> - + <section id="behavior"> <title>행동</title> - + <section> <title>이전 행동</title> - + <p>NCSA httpd 1.3은 사용자에게 무의미하고 지루한 오류문을 보냈다. 문제가 발생한 이유를 로그에 남길 수도 없었다.</p> </section> - + <section> <title>새로운 행동</title> - + <p>서버는 다음과 같은 일을 할 수 있다:</p> - + <ol> <li>NCSA의 고정된 문구 대신 다른 문구를 보여주거나</li> - + <li>같은 사이트의 URL로 리다이렉션하거나</li> - + <li>외부 사이트의 URL로 리다이렉션한다.</li> </ol> - + <p>다른 사이트의 URL로 리다이렉션하는 것이 유용할 수 있지만, 이 경우 문제를 설명하거나 로그하는데 필요한 정보중 일부만 전달된다.</p> - + <p>오류에 대한 정보를 전달하기위해 아파치는 CGI식의 새로운 환경변수를 정의한다:</p> - + <example> REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/x-xbitmap, image/jpeg<br /> @@ -79,9 +79,9 @@ REDIRECT_SERVER_SOFTWARE=Apache/0.8.15<br /> REDIRECT_URL=/cgi-bin/buggy.pl </example> - + <p><code>REDIRECT_</code> 접두사에 주목하라.</p> - + <p>최소한 <code>REDIRECT_URL</code>과 <code>REDIRECT_QUERY_STRING</code>은 (cgi-script나 cgi-include일) 새 URL로 넘겨진다. 다른 변수는 오류가 @@ -93,17 +93,17 @@ 이중 어떤 것도 설정되지 <strong>않는다</strong>.</p> </section> </section> - + <section id="configuration"> <title>설정</title> - + <p><directive module="core">AllowOverride</directive>가 적절히 설정되었다면 .htaccess 파일에서 <directive module="core">ErrorDocument</directive>를 사용할 수 있다.</p> - + <p>다음은 예이다...</p> - + <example> ErrorDocument 500 /cgi-bin/crash-recover <br /> ErrorDocument 500 "Sorry, our script crashed. Oh dear" <br /> @@ -111,42 +111,42 @@ ErrorDocument 404 /Lame_excuses/not_found.html <br /> ErrorDocument 401 /Subscription/how_to_subscribe.html </example> - + <p>문법은,</p> - + <example> ErrorDocument <3-digit-code> <action> </example> - + <p>가능한 action은,</p> - + <ol> <li>출력할 문구. 따옴표 (")를 문구 앞에 붙인다. 뒤에 나오는 따옴표는 출력된다. <em>주의: 앞에 붙은 따옴표 (")는 출력되지 않는다.</em></li> - + <li>리다이렉션할 외부 URL.</li> - + <li>리다이렉션할 내부 URL.</li> </ol> </section> - + <section id="custom"> <title>사용자정의 오류 응답과 리다이렉션</title> - + <p>URL로 리다이렉션하는 아파치 행동은 스크립트/server-include에 환경변수를 더 넘겨주도록 변경되었다.</p> - + <section> <title>이전 행동</title> - + <p>리다이렉션되는 스크립트에 표준 CGI 변수들이 넘어간다. 어디에서 리다이렉션이 일어났는지 알 수 없다.</p> </section> - + <section> <title>새로운 행동</title> - + <p>리다이렉션된 스크립트는 새로운 환경변수들을 사용할 수 있다. 모두 앞에 <code>REDIRECT_</code>가 붙어있다. <code>REDIRECT_</code> 환경변수는 원래 CGI 환경변수명 @@ -157,20 +157,20 @@ <code>REDIRECT_URL</code>과 <code>REDIRECT_STATUS</code>를 정의한다. 원래 URL과 리다이렉션된 URL 모두 접근 로그에 기록할 수 있다.</p> - + <p>ErrorDocument가 같은 서버에 있는 CGI 스크립트로 리다이렉션한다면, 스크립트는 클라이언트에게 오류 상황을 확실히 전달하기위해 출력에 "<code>Status:</code>" 헤더 필드를 포함해야 한다. 예를 들어, Perl로 작성한 ErrorDocument 스크립트는 다음과 같다:</p> - + <example> ... <br /> print "Content-type: text/html\n"; <br /> printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; <br /> ... </example> - + <p><code>404 Not Found</code>와 같은 특정 오류 상황에 대한 스크립트라면, 대신 <transnote>고정된</transnote> 특정 상태코드와 오류문을 사용할 수 있다.</p> diff --git a/docs/manual/dns-caveats.html.ko.euc-kr b/docs/manual/dns-caveats.html.ko.euc-kr index 61ff7bd6bb..dd46f131fe 100644 --- a/docs/manual/dns-caveats.html.ko.euc-kr +++ b/docs/manual/dns-caveats.html.ko.euc-kr @@ -24,7 +24,7 @@ </div> <p>이 문서를 한 문장으로 요약할 수 있다. 아파치가 설정파일을 - 읽을때 DNS를 사용하지않도록 하라. 아파치가 설정파일을 읽는데 + 읽을때 DNS를 의존하지않도록 하라. 아파치가 설정파일을 읽는데 DNS가 필요하다면 서버는 신뢰성 문제 (시작이 안될 수도 있다) 혹은 서비스거부 공격과 (사용자가 다른 사용자에 대한 접근을 가로채는 것을 포함하여) 서비스도둑(theft of service) 공격에 @@ -40,34 +40,34 @@ <div class="section"> <h2><a name="example" id="example">간단한 예제</a></h2> - + <div class="example"><p><code> <VirtualHost www.abc.dom> <br /> ServerAdmin webgirl@abc.dom <br /> DocumentRoot /www/abc <br /> </VirtualHost> </code></p></div> - + <p>아파치가 정상적으로 동작하기위해서는 각 가상호스트에 대해 두가지 정보가 절대적으로 필요하다. 이 정보는 <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>과 서버가 - 응답할 최소 한개의 IP 주소이다. 이 예는 IP 주소가 없기때문에, - 아파치는 DNS를 사용하여 <code>www.abc.dom</code>의 주소를 - 찾아야 한다. 서버가 설정파일을 읽을때 어떤 이유에서건 DNS를 - 사용할 수 없다면 가상호스트를 <strong>만들 수 없다</strong>. + 기다리고 응답할 최소 한개의 IP 주소이다. 이 예는 IP 주소가 + 없기때문에, 아파치는 DNS를 사용하여 <code>www.abc.dom</code>의 + 주소를 찾아야 한다. 서버가 설정파일을 읽을때 어떤 이유에서건 + DNS를 사용할 수 없다면 가상호스트를 <strong>만들 수 없다</strong>. 이 가상호스트는 요청에 응답할 수 없다. (아파치 1.2 이전 버전에서는 심지어 서버가 부팅도 안한다.)</p> - + <p><code>www.abc.dom</code>의 주소가 10.0.0.1이라고 가정하자. 그리고 다음 설정을 보라:</p> - + <div class="example"><p><code> <VirtualHost 10.0.0.1> <br /> ServerAdmin webgirl@abc.dom <br /> DocumentRoot /www/abc <br /> </VirtualHost> </code></p></div> - + <p>이제 아파치는 이 가상호스트의 <code>ServerName</code>을 찾기위해 역DNS를 사용해야 한다. 역찾기가 실패하면 아파치는 가상호스트를 부분적으로 끈다. (아파치 1.2 이전 버전에서는 @@ -75,7 +75,7 @@ 가상호스트라면 가상호스트는 완전히 동작하지않고, ip기반이라면 대부분 동작한다. 그러나 아파치가 서버명을 포함하여 서버의 전체 URL을 만들어야 한다면 정상적인 URL을 만들지 못한다.</p> - + <p>아래 경우 이 두가지 문제가 없다.</p> <div class="example"><p><code> @@ -121,7 +121,7 @@ 그들이 자체 DNS를 사용하기때문에 당신은 그들이 원하는데로 <code>www.def.dom</code> 레코드를 설정하는 것을 막을 수 없다.</p> - + <p>(사용자가 <code>http://www.abc.dom/whatever</code> 형식의 URL을 입력하는 경우를 포함하여) 10.0.0.1로 오는 모든 요청을 <code>def.dom</code> 가상호스트가 서비스하게 된다. 왜 이런 @@ -132,7 +132,7 @@ <div class="section"> <h2><a name="main" id="main">"주서버" 주소</a></h2> - + <p>아파치 1.1에서 <a href="vhosts/name-based.html">이름기반 가상호스트 지원</a>이 포함되었기때문에 아파치는 웹서버를 실행하는 호스트의 IP 주소(들)를 알 필요가 생겼다. 이 주소는 @@ -140,7 +140,7 @@ 혹은 C 함수 <code>gethostname</code>으로 (명령프롬프트에 "hostname"을 입력했을때와 같은 결과) 얻는다. 그러면 이 주소로 DNS 검색을 한다. 현재 이 검색은 피할 수 없다.</p> - + <p>DNS 서버가 죽어서 이 검색이 실패할 것 같다면 <code>/etc/hosts</code>에 호스트명을 집어넣을 수 있다. (컴퓨터가 정상적으로 부팅되었다면 아마 이미 들어있을 것이다.) @@ -148,7 +148,7 @@ 사용하는지 확인하라. 사용하는 운영체제에 따라 <code>/etc/resolv.conf</code> 혹은 <code>/etc/nsswitch.conf</code>를 수정하면 될 것이다.</p> - + <p>서버가 어떤 이유에서건 DNS를 검색하면 안된다면 <code>HOSTRESORDER</code> 환경변수를 "local"로 설정하고 아파치를 실행할 수 있다. <code class="module"><a href="./mod/mod_env.html">mod_env</a></code>를 @@ -159,24 +159,24 @@ <div class="section"> <h2><a name="tips" id="tips">이 문제를 피하기위한 팁</a></h2> - + <ul> <li> <code class="directive"><a href="./mod/core.html#virtualhost">VirtualHost</a></code>에 IP 주소를 사용하라 </li> - + <li> <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>에 IP 주소를 사용하라 </li> - + <li> 모든 가상호스트는 명시적으로 <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>을 가지게 하라 </li> - + <li>어떤 페이지도 서비스하지않는 <code><VirtualHost _default_:*></code> 서버를 만들어라</li> @@ -185,25 +185,25 @@ <div class="section"> <h2><a name="appendix" id="appendix">부록: 앞으로는</a></h2> - + <p>DNS와 관련된 상황은 매우 바람직하지 못하다. 아파치 1.2에서 우리는 DNS가 실패한 경우에도 최소한 서버가 켜지도록 노력했지만 결과는 나빴다. 어쨌든 설정파일에 직접 IP 주소를 요구하는 것은 번호를 다시 설정해야할 요즘 인터넷에 매우 바람직하지 못하다.</p> - + <p>위에서 설명한 서비스도둑 공격을 막는 한가지 방법은 검색한 - ip 주소에 다시 역DNS 검색을 하여 두 이름을 비교하는 것이다. + IP 주소에 다시 역DNS 검색을 하여 두 이름을 비교하는 것이다. 서로 다른 경우 가상호스트를 가동하지 않을 수 있다. 이 방법은 역DNS가 올바로 설정되야 한다. (FTP 서버나 TCP wrapper가 "중복-역" DNS 검색을 자주 사용하기때문에 대부분의 관리자에게 익숙할 것이다.)</p> - + <p>어쨌든 IP 주소를 사용하지않으면 DNS가 실패한 경우 가상호스트 웹서버를 믿을 수 있게 시작할 수 없다. 설정의 일부를 무시하는 것과 같은 부분적인 해결책은 웹서버 전체를 시작하지않는 것보다 더 나쁠 수도 있다.</p> - + <p>HTTP/1.1이 나왔고 브라우저와 프록시가 <code>Host</code> 헤더를 보내기 시작했으므로 IP기반 가상호스트를 완전히 사용하지않는 것이 가능해질 것이다. 그러면 웹서버는 설정중에서 diff --git a/docs/manual/dns-caveats.xml.ko b/docs/manual/dns-caveats.xml.ko index fd26417068..b6a593ad1c 100644 --- a/docs/manual/dns-caveats.xml.ko +++ b/docs/manual/dns-caveats.xml.ko @@ -20,48 +20,48 @@ --> <manualpage metafile="dns-caveats.xml.meta"> - + <title>DNS와 아파치와 관련된 사항</title> - + <summary> <p>이 문서를 한 문장으로 요약할 수 있다. 아파치가 설정파일을 - 읽을때 DNS를 사용하지않도록 하라. 아파치가 설정파일을 읽는데 + 읽을때 DNS를 의존하지않도록 하라. 아파치가 설정파일을 읽는데 DNS가 필요하다면 서버는 신뢰성 문제 (시작이 안될 수도 있다) 혹은 서비스거부 공격과 (사용자가 다른 사용자에 대한 접근을 가로채는 것을 포함하여) 서비스도둑(theft of service) 공격에 시달릴 수 있다.</p> </summary> - + <section id="example"> <title>간단한 예제</title> - + <example> <VirtualHost www.abc.dom> <br /> ServerAdmin webgirl@abc.dom <br /> DocumentRoot /www/abc <br /> </VirtualHost> </example> - + <p>아파치가 정상적으로 동작하기위해서는 각 가상호스트에 대해 두가지 정보가 절대적으로 필요하다. 이 정보는 <directive module="core">ServerName</directive>과 서버가 - 응답할 최소 한개의 IP 주소이다. 이 예는 IP 주소가 없기때문에, - 아파치는 DNS를 사용하여 <code>www.abc.dom</code>의 주소를 - 찾아야 한다. 서버가 설정파일을 읽을때 어떤 이유에서건 DNS를 - 사용할 수 없다면 가상호스트를 <strong>만들 수 없다</strong>. + 기다리고 응답할 최소 한개의 IP 주소이다. 이 예는 IP 주소가 + 없기때문에, 아파치는 DNS를 사용하여 <code>www.abc.dom</code>의 + 주소를 찾아야 한다. 서버가 설정파일을 읽을때 어떤 이유에서건 + DNS를 사용할 수 없다면 가상호스트를 <strong>만들 수 없다</strong>. 이 가상호스트는 요청에 응답할 수 없다. (아파치 1.2 이전 버전에서는 심지어 서버가 부팅도 안한다.)</p> - + <p><code>www.abc.dom</code>의 주소가 10.0.0.1이라고 가정하자. 그리고 다음 설정을 보라:</p> - + <example> <VirtualHost 10.0.0.1> <br /> ServerAdmin webgirl@abc.dom <br /> DocumentRoot /www/abc <br /> </VirtualHost> </example> - + <p>이제 아파치는 이 가상호스트의 <code>ServerName</code>을 찾기위해 역DNS를 사용해야 한다. 역찾기가 실패하면 아파치는 가상호스트를 부분적으로 끈다. (아파치 1.2 이전 버전에서는 @@ -69,7 +69,7 @@ 가상호스트라면 가상호스트는 완전히 동작하지않고, ip기반이라면 대부분 동작한다. 그러나 아파치가 서버명을 포함하여 서버의 전체 URL을 만들어야 한다면 정상적인 URL을 만들지 못한다.</p> - + <p>아래 경우 이 두가지 문제가 없다.</p> <example> @@ -115,7 +115,7 @@ 그들이 자체 DNS를 사용하기때문에 당신은 그들이 원하는데로 <code>www.def.dom</code> 레코드를 설정하는 것을 막을 수 없다.</p> - + <p>(사용자가 <code>http://www.abc.dom/whatever</code> 형식의 URL을 입력하는 경우를 포함하여) 10.0.0.1로 오는 모든 요청을 <code>def.dom</code> 가상호스트가 서비스하게 된다. 왜 이런 @@ -123,10 +123,10 @@ 오는 요청을 처리하는지에 대한 설명이 필요하다. <a href="vhosts/details.html">여기</a>에 대강 설명되있다.</p> </section> - + <section id="main"> <title>"주서버" 주소</title> - + <p>아파치 1.1에서 <a href="vhosts/name-based.html">이름기반 가상호스트 지원</a>이 포함되었기때문에 아파치는 웹서버를 실행하는 호스트의 IP 주소(들)를 알 필요가 생겼다. 이 주소는 @@ -134,7 +134,7 @@ 혹은 C 함수 <code>gethostname</code>으로 (명령프롬프트에 "hostname"을 입력했을때와 같은 결과) 얻는다. 그러면 이 주소로 DNS 검색을 한다. 현재 이 검색은 피할 수 없다.</p> - + <p>DNS 서버가 죽어서 이 검색이 실패할 것 같다면 <code>/etc/hosts</code>에 호스트명을 집어넣을 수 있다. (컴퓨터가 정상적으로 부팅되었다면 아마 이미 들어있을 것이다.) @@ -142,7 +142,7 @@ 사용하는지 확인하라. 사용하는 운영체제에 따라 <code>/etc/resolv.conf</code> 혹은 <code>/etc/nsswitch.conf</code>를 수정하면 될 것이다.</p> - + <p>서버가 어떤 이유에서건 DNS를 검색하면 안된다면 <code>HOSTRESORDER</code> 환경변수를 "local"로 설정하고 아파치를 실행할 수 있다. <module>mod_env</module>를 @@ -150,54 +150,54 @@ CGI에도 영향을 준다. 운영체제의 manpage나 FAQ를 참고하는 것이 좋다.</p> </section> - + <section id="tips"> <title>이 문제를 피하기위한 팁</title> - + <ul> <li> <directive module="core">VirtualHost</directive>에 IP 주소를 사용하라 </li> - + <li> <directive module="mpm_common">Listen</directive>에 IP 주소를 사용하라 </li> - + <li> 모든 가상호스트는 명시적으로 <directive module="core">ServerName</directive>을 가지게 하라 </li> - + <li>어떤 페이지도 서비스하지않는 <code><VirtualHost _default_:*></code> 서버를 만들어라</li> </ul> </section> - + <section id="appendix"> <title>부록: 앞으로는</title> - + <p>DNS와 관련된 상황은 매우 바람직하지 못하다. 아파치 1.2에서 우리는 DNS가 실패한 경우에도 최소한 서버가 켜지도록 노력했지만 결과는 나빴다. 어쨌든 설정파일에 직접 IP 주소를 요구하는 것은 번호를 다시 설정해야할 요즘 인터넷에 매우 바람직하지 못하다.</p> - + <p>위에서 설명한 서비스도둑 공격을 막는 한가지 방법은 검색한 - ip 주소에 다시 역DNS 검색을 하여 두 이름을 비교하는 것이다. + IP 주소에 다시 역DNS 검색을 하여 두 이름을 비교하는 것이다. 서로 다른 경우 가상호스트를 가동하지 않을 수 있다. 이 방법은 역DNS가 올바로 설정되야 한다. (FTP 서버나 TCP wrapper가 "중복-역" DNS 검색을 자주 사용하기때문에 대부분의 관리자에게 익숙할 것이다.)</p> - + <p>어쨌든 IP 주소를 사용하지않으면 DNS가 실패한 경우 가상호스트 웹서버를 믿을 수 있게 시작할 수 없다. 설정의 일부를 무시하는 것과 같은 부분적인 해결책은 웹서버 전체를 시작하지않는 것보다 더 나쁠 수도 있다.</p> - + <p>HTTP/1.1이 나왔고 브라우저와 프록시가 <code>Host</code> 헤더를 보내기 시작했으므로 IP기반 가상호스트를 완전히 사용하지않는 것이 가능해질 것이다. 그러면 웹서버는 설정중에서 diff --git a/docs/manual/dso.html.ko.euc-kr b/docs/manual/dso.html.ko.euc-kr index 1e4392e140..3b94dd4882 100644 --- a/docs/manual/dso.html.ko.euc-kr +++ b/docs/manual/dso.html.ko.euc-kr @@ -51,7 +51,7 @@ 이 모듈은 <code class="module"><a href="./mod/core.html">core</a></code>를 제외하고 DSO가 될 수 없는 유일한 모듈이다. 실제로 다른 모든 아파치 모듈은 <a href="install.html">설치 문서</a>에서 설명한 - <code>configure</code>의 <code>--enable-<var>module</var>=shared</code> + <code>configure</code>의 <code>--enable-<em>module</em>=shared</code> 옵션을 사용하여 DSO로 컴파일할 수 있다. 모듈을 <code>mod_foo.so</code>와 같이 DSO로 컴파일한후 <code>httpd.conf</code> 파일에 <code class="module"><a href="./mod/mod_so.html">mod_so</a></code>의 diff --git a/docs/manual/dso.xml.ko b/docs/manual/dso.xml.ko index 7bc9130fff..bb4fa0ae23 100644 --- a/docs/manual/dso.xml.ko +++ b/docs/manual/dso.xml.ko @@ -54,7 +54,7 @@ 이 모듈은 <module>core</module>를 제외하고 DSO가 될 수 없는 유일한 모듈이다. 실제로 다른 모든 아파치 모듈은 <a href="install.html">설치 문서</a>에서 설명한 - <code>configure</code>의 <code>--enable-<var>module</var>=shared</code> + <code>configure</code>의 <code>--enable-<em>module</em>=shared</code> 옵션을 사용하여 DSO로 컴파일할 수 있다. 모듈을 <code>mod_foo.so</code>와 같이 DSO로 컴파일한후 <code>httpd.conf</code> 파일에 <module>mod_so</module>의 diff --git a/docs/manual/env.html.ko.euc-kr b/docs/manual/env.html.ko.euc-kr index e73efc5b79..152a0c65b0 100644 --- a/docs/manual/env.html.ko.euc-kr +++ b/docs/manual/env.html.ko.euc-kr @@ -22,15 +22,13 @@ <a href="./ja/env.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="./ko/env.html" title="Korean"> ko </a></p> </div> -<div class="outofdate">이 문서는 최신판 번역이 아닙니다. - 최근에 변경된 내용은 영어 문서를 참고하세요.</div> <p>아파치 웹서버는 <em>환경변수(environment variable)</em>라는 변수에 정보를 저장할 수 있다. 이 정보를 사용하여 로그나 접근제어 등 여러 작업을 조절한다. 또, 환경변수는 CGI 스크립트와 같은 외부 프로그램과 통신하는 수단이 된다. 이 문서는 환경변수를 다루고 사용하는 다양한 방법들을 설명한다.</p> - + <p>이 변수들을 <em>환경변수</em>라고 부르지만, 운영체제에서 말하는 환경변수와 다르다. 이 변수는 아파치 내부에 저장되고 사용된다. 환경변수는 CGI 스크립트나 Server Side Include @@ -48,18 +46,18 @@ <h2><a name="setting" id="setting">환경변수 설정하기</a></h2> <table class="related"><tr><th>관련된 모듈</th><th>관련된 지시어</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_env.html">mod_env</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li><li><code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code></li><li><code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#browsermatchnocase">BrowserMatchNoCase</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvifnocase">SetEnvIfNoCase</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#unsetenv">UnsetEnv</a></code></li></ul></td></tr></table> - + <h3><a name="basic-manipulation" id="basic-manipulation">기본적인 환경설정</a></h3> - + <p>아파치에서 환경변수를 설정하는 가장 기본적인 방법은 무조건적인 <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> 지시어를 사용하는 것이다. <code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code> 지시어를 사용하여 서버를 시작한 쉘에서 환경변수를 가져올 수도 있다.</p> - + <h3><a name="conditional" id="conditional">요청에 따른 조건부 설정</a></h3> - + <p>더 유연하게, mod_setenvif가 제공하는 지시어는 요청마다 요청의 특징에 따라 환경변수를 설정한다. 예를 들어, 특정 브라우저로 (User-Agent) 요청하거나 특정 Referer (맞춤법이 @@ -67,37 +65,37 @@ 있다. 심지어 mod_rewrite에 있는 <code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>의 <code>[E=...]</code> 옵션을 사용하여 더 유연하게 환경변수를 설정할 수도 있다.</p> - + <h3><a name="unique-identifiers" id="unique-identifiers">유일한 식별자</a></h3> - + <p>마지막으로 mod_unique_id는 각 요청에 대해 어떤 경우에도 "모든" 요청중에 확실히 유일한(겹치지않은) 값으로 <code>UNIQUE_ID</code> 환경변수를 설정한다.</p> - + <h3><a name="standard-cgi" id="standard-cgi">표준 CGI 변수</a></h3> - + <p>CGI 스크립트와 SSI 문서는 아파치 설정에서 설정하였거나 쉘에서 가져온 환경변수 외에 추가로 <a href="http://cgi-spec.golux.com/">CGI 규약</a>이 규정한 요청에 대한 정보를 알려주는 환경변수들을 받는다.</p> - + <h3><a name="caveats" id="caveats">주의할 점</a></h3> - + <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 @@ -108,44 +106,44 @@ <div class="section"> <h2><a name="using" id="using">환경변수 사용하기</a></h2> - + <table class="related"><tr><th>관련된 모듈</th><th>관련된 지시어</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</a></code></li><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_authz_host.html#allow">Allow</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="./mod/mod_authz_host.html#deny">Deny</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li></ul></td></tr></table> <h3><a name="cgi-scripts" id="cgi-scripts">CGI 스크립트</a></h3> - + <p>환경변수의 주된 용도중 하나는 CGI 스크립트와 정보를 교환하는 것이다. 앞에서 설명했듯이 아파치 설정에서 설정한 변수외에 요청에 대한 표준 정보를 가진 변수가 CGI 스크립트로 넘어간다. 더 자세한 내용은 <a href="howto/cgi.html">CGI 투토리얼</a>을 참고하라.</p> - + <h3><a name="ssi-pages" id="ssi-pages">SSI 페이지</a></h3> - + <p>mod_include의 <code>INCLUDES</code> 필터가 처리하는 서버파싱 (SSI) 문서는 <code>echo</code> 요소를 사용하여 환경변수를 출력할 수 있고, 환경변수를 사용하여 요청의 특징에 따라 흐름제어 요소로 페이지의 일부를 변경할 수 있다. 아파치는 또 SSI 문서에게 위에서 설명한 표준 CGI 환경변수를 제공한다. 더 자세한 내용은 <a href="howto/ssi.html">SSI 투토리얼</a>을 참고하라.</p> - + <h3><a name="access-control" id="access-control">접근제어</a></h3> - + <p><code>allow from env=</code>과 <code>deny from env=</code> 지시어를 사용하여 환경변수 값에 따라 서버로의 접근을 조절할 수 있다. <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>와 같이 사용하면 클라이언트의 특징에 따라 자유롭게 서버로의 접근을 제어할 수 있다. 예를 들어, 특정 브라우저의 (User-Agent) 접근을 거부할 수 있다.</p> - + <h3><a name="logging" id="logging">조건부 로그</a></h3> - + <p><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code>의 <code>%e</code> 옵션을 사용하여 환경변수를 접근 로그에 기록할 수 있다. 또, <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> 지시어의 @@ -158,13 +156,13 @@ <h3><a name="response-headers" id="response-headers">조건부 응답 헤더</a></h3> - + <p><code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code> 지시어는 클라이언트에게 응답을 보낼때 환경변수의 유무에 따라 어떤 HTTP 헤더를 포함할지 결정할 수 있다. 예를 들어, 클라이언트의 요청에 특정 헤더가 있는 경우에만 어떤 응답 헤더를 보낼 수 있다.</p> - + <h3><a name="external-filter" id="external-filter">외부 필터 실행하기</a></h3> @@ -178,7 +176,7 @@ <h3><a name="url-rewriting" id="url-rewriting">URL 재작성(Rewriting)</a></h3> - + <p><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>의 <em>TestString</em>에 <code>%{ENV:...}</code> 형식을 사용하면 mod_rewrite의 재작성 엔진이 환경변수에 따라 @@ -191,7 +189,7 @@ <div class="section"> <h2><a name="special" id="special">특별한 목적의 환경변수</a></h2> - + <p>클라이언트와 원활한 동작하기위해 아파치는 특별한 클라이언트에 대해 자신의 행동을 수정한다. 보통 <code class="directive"><a href="./mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code>에서 환경변수를 정의하여 이런 문제를 해결한다. 그러나 <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code>와 <code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code>로도 가능하다.</p> @@ -203,19 +201,25 @@ 처리한다.</p> - <h3><a name="force-no-vary" id="force-no-vary">force-no-vary</a></h3> + <h3><a name="force-gzip" id="force-gzip">force-gzip</a></h3> + <p><code>DEFLATE</code> 필터를 사용할때 이 환경변수는 + 브라우저의 accept-encoding 설정을 무시하고 무조건 + 압축된 결과를 보낸다.</p> + <h3><a name="force-no-vary" id="force-no-vary">force-no-vary</a></h3> + + <p>응답을 클라이언트에게 보내기 전에 응답 헤더에서 <code>Vary</code> 필드를 뺀다. 어떤 클라이언트는 이 필드를 제대로 해석하지 못한다. 이 변수는 이런 문제를 해결한다. 또한, 이 변수는 <strong>force-response-1.0</strong>을 가정한다.</p> - + <h3><a name="force-response" id="force-response">force-response-1.0</a></h3> - + <p>HTTP/1.0 요청을 하는 클라이언트에게 HTTP/1.0 응답을 강제한다. 원래 AOL 프록시에 문제가 있어서 만들어졌다. 어떤 HTTP/1.0 클라이언트는 HTTP/1.1 응답을 받으면 제대로 @@ -233,7 +237,7 @@ <h3><a name="no-gzip" id="no-gzip">no-gzip</a></h3> - + <p>이 옵션을 설정하면 <code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code>의 <code>DEFLATE</code> 필터를 사용하지 않고, <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>은 인코딩된 자원을 @@ -243,10 +247,10 @@ <h3><a name="nokeepalive" id="nokeepalive">nokeepalive</a></h3> - + <p><code class="directive"><a href="./mod/core.html#keepalive">KeepAlive</a></code>를 무시한다.</p> - + <h3><a name="prefer-language" id="prefer-language">prefer-language</a></h3> @@ -261,13 +265,13 @@ <h3><a name="redirect-carefully" id="redirect-carefully">redirect-carefully</a></h3> - + <p>서버가 더 조심히 클라이언트에게 리다이렉션을 보낸다. 보통 리다이렉션을 처리하는데 문제가 있는 클라이언트을 위해 사용한다. 원래 Microsoft의 WebFolders 소프트웨어가 DAV 메써드를 통해 디렉토리 자원의 리다이렉션을 처리하는데 문제가 있어서 만들어졌다.</p> - + <h3><a name="suppress-error-charset" id="suppress-error-charset">suppress-error-charset</a></h3> @@ -294,11 +298,11 @@ <div class="section"> <h2><a name="examples" id="examples">예제</a></h2> - + <h3><a name="misbehaving" id="misbehaving">잘못 동작하는 클라이언트들을 위해 프로토콜 행동 변경하기</a></h3> - + <p>클라이언트들의 이미 알려진 문제를 해결하기위해 httpd.conf에 다음 내용을 포함하길 바란다.</p> <div class="example"><pre> @@ -352,7 +356,7 @@ SetEnvIf Referer "^$" local_referal Deny from all Allow from env=local_referal </Directory></pre></div> - + <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> diff --git a/docs/manual/env.xml.ko b/docs/manual/env.xml.ko index a54826c955..78bf5cf665 100644 --- a/docs/manual/env.xml.ko +++ b/docs/manual/env.xml.ko @@ -1,7 +1,7 @@ <?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.16 (outdated: 1.18) --> +<!-- English Revision: 1.18 --> <!-- Copyright 2003-2004 The Apache Software Foundation @@ -29,7 +29,7 @@ 접근제어 등 여러 작업을 조절한다. 또, 환경변수는 CGI 스크립트와 같은 외부 프로그램과 통신하는 수단이 된다. 이 문서는 환경변수를 다루고 사용하는 다양한 방법들을 설명한다.</p> - + <p>이 변수들을 <em>환경변수</em>라고 부르지만, 운영체제에서 말하는 환경변수와 다르다. 이 변수는 아파치 내부에 저장되고 사용된다. 환경변수는 CGI 스크립트나 Server Side Include @@ -58,20 +58,20 @@ <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 (맞춤법이 @@ -80,38 +80,38 @@ 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 @@ -121,7 +121,7 @@ </section> <section id="using"> <title>환경변수 사용하기</title> - + <related> <modulelist> <module>mod_authz_host</module> @@ -146,17 +146,17 @@ <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> 요소를 사용하여 환경변수를 출력할 수 있고, 환경변수를 사용하여 요청의 @@ -164,11 +164,11 @@ 있다. 아파치는 또 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 @@ -176,11 +176,11 @@ 클라이언트의 특징에 따라 자유롭게 서버로의 접근을 제어할 수 있다. 예를 들어, 특정 브라우저의 (User-Agent) 접근을 거부할 수 있다.</p> - + </section> <section id="logging"> <title>조건부 로그</title> - + <p><directive module="mod_log_config">LogFormat</directive>의 <code>%e</code> 옵션을 사용하여 환경변수를 접근 로그에 기록할 수 있다. 또, <directive @@ -195,13 +195,13 @@ </section> <section id="response-headers"> <title>조건부 응답 헤더</title> - + <p><directive module="mod_headers">Header</directive> 지시어는 클라이언트에게 응답을 보낼때 환경변수의 유무에 따라 어떤 HTTP 헤더를 포함할지 결정할 수 있다. 예를 들어, 클라이언트의 요청에 특정 헤더가 있는 경우에만 어떤 응답 헤더를 보낼 수 있다.</p> - + </section> <section id="external-filter"> @@ -216,7 +216,7 @@ <section id="url-rewriting"> <title>URL 재작성(Rewriting)</title> - + <p><directive module="mod_rewrite">RewriteCond</directive>의 <em>TestString</em>에 <code>%{ENV:...}</code> 형식을 사용하면 mod_rewrite의 재작성 엔진이 환경변수에 따라 @@ -226,10 +226,10 @@ 변수다.</p> </section> </section> - + <section id="special"> <title>특별한 목적의 환경변수</title> - + <p>클라이언트와 원활한 동작하기위해 아파치는 특별한 클라이언트에 대해 자신의 행동을 수정한다. 보통 <directive module="mod_setenvif">BrowserMatch</directive>에서 @@ -244,19 +244,25 @@ 처리한다.</p> </section> + <section id="force-gzip"> + <title>force-gzip</title> + <p><code>DEFLATE</code> 필터를 사용할때 이 환경변수는 + 브라우저의 accept-encoding 설정을 무시하고 무조건 + 압축된 결과를 보낸다.</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 응답을 받으면 제대로 @@ -274,7 +280,7 @@ </section> <section id="no-gzip"><title>no-gzip</title> - + <p>이 옵션을 설정하면 <module>mod_deflate</module>의 <code>DEFLATE</code> 필터를 사용하지 않고, <module>mod_negotiation</module>은 인코딩된 자원을 @@ -284,10 +290,10 @@ <section id="nokeepalive"> <title>nokeepalive</title> - + <p><directive module="core">KeepAlive</directive>를 무시한다.</p> - + </section> <section id="prefer-language"><title>prefer-language</title> @@ -303,13 +309,13 @@ <section id="redirect-carefully"> <title>redirect-carefully</title> - + <p>서버가 더 조심히 클라이언트에게 리다이렉션을 보낸다. 보통 리다이렉션을 처리하는데 문제가 있는 클라이언트을 위해 사용한다. 원래 Microsoft의 WebFolders 소프트웨어가 DAV 메써드를 통해 디렉토리 자원의 리다이렉션을 처리하는데 문제가 있어서 만들어졌다.</p> - + </section> <section id="suppress-error-charset"> @@ -336,11 +342,11 @@ <section id="examples"> <title>예제</title> - + <section id="misbehaving"> <title>잘못 동작하는 클라이언트들을 위해 프로토콜 행동 변경하기</title> - + <p>클라이언트들의 이미 알려진 문제를 해결하기위해 httpd.conf에 다음 내용을 포함하길 바란다.</p> <example><pre> @@ -394,7 +400,7 @@ SetEnvIf Referer "^$" local_referal Deny from all Allow from env=local_referal </Directory></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> diff --git a/docs/manual/env.xml.meta b/docs/manual/env.xml.meta index fd4d4a5499..321cae6970 100644 --- a/docs/manual/env.xml.meta +++ b/docs/manual/env.xml.meta @@ -8,6 +8,6 @@ <variants> <variant>en</variant> <variant>ja</variant> - <variant outdated="yes">ko</variant> + <variant>ko</variant> </variants> </metafile> diff --git a/docs/manual/filter.html.ko.euc-kr b/docs/manual/filter.html.ko.euc-kr index b9d4236166..222f8dabec 100644 --- a/docs/manual/filter.html.ko.euc-kr +++ b/docs/manual/filter.html.ko.euc-kr @@ -32,7 +32,7 @@ <h2><a name="filters" id="filters">필터</a></h2> <table class="related"><tr><th>관련된 모듈</th><th>관련된 지시어</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code></li><li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_mime.html#addinputfilter">AddInputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removeinputfilter">RemoveInputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removeoutputfilter">RemoveOutputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilteroptions">ExtFilterOptions</a></code></li><li><code class="directive"><a href="./mod/core.html#setinputfilter">SetInputFilter</a></code></li><li><code class="directive"><a href="./mod/core.html#setoutputfilter">SetOutputFilter</a></code></li></ul></td></tr></table> - + <p><em>필터(filter)</em>는 서버가 보내거나 받는 자료에 적용되는 작업이다. 클라이언트가 서버에게 보내는 자료는 <em>입력필터(input filter)</em>가 처리하고, 서버가 diff --git a/docs/manual/filter.xml.ko b/docs/manual/filter.xml.ko index 9813472563..821e63a552 100644 --- a/docs/manual/filter.xml.ko +++ b/docs/manual/filter.xml.ko @@ -46,7 +46,7 @@ <directive module="core">SetOutputFilter</directive> </directivelist> </related> - + <p><em>필터(filter)</em>는 서버가 보내거나 받는 자료에 적용되는 작업이다. 클라이언트가 서버에게 보내는 자료는 <em>입력필터(input filter)</em>가 처리하고, 서버가 diff --git a/docs/manual/glossary.html.ko.euc-kr b/docs/manual/glossary.html.ko.euc-kr index 4f13f5411b..3c76cccb9c 100644 --- a/docs/manual/glossary.html.ko.euc-kr +++ b/docs/manual/glossary.html.ko.euc-kr @@ -93,7 +93,7 @@ Authority)</a>에 제출하여 CA <em>인증서 (Certificate)</em>의 프로그램 사이의 인터페이스 표준. 인터페이스는 원래 <a href="http://hoohoo.ncsa.uiuc.edu/cgi/overview.html">NCSA</a>가 정의했지만, <a href="http://cgi-spec.golux.com/">RFC 프로젝트</a>이기도 하다.<br /> -참고: <a href="howto/cgi.html">CGI로 동적 내용 생성</a></dd> +참고: <a href="howto/cgi.html">CGI로 동적 페이지 생성</a></dd> <dt><a name="configurationdirective">설정 지시어 (Configuration diff --git a/docs/manual/glossary.xml.ko b/docs/manual/glossary.xml.ko index 46031abffb..3879cd21bc 100644 --- a/docs/manual/glossary.xml.ko +++ b/docs/manual/glossary.xml.ko @@ -100,7 +100,7 @@ href="#plaintext">평문 (Plaintext)</a>을 <a href="#cipher">암호기 href="http://hoohoo.ncsa.uiuc.edu/cgi/overview.html">NCSA</a>가 정의했지만, <a href="http://cgi-spec.golux.com/">RFC 프로젝트</a>이기도 하다.<br /> -참고: <a href="howto/cgi.html">CGI로 동적 내용 생성</a></dd> +참고: <a href="howto/cgi.html">CGI로 동적 페이지 생성</a></dd> <dt><a name="configurationdirective">설정 지시어 (Configuration diff --git a/docs/manual/handler.html.ko.euc-kr b/docs/manual/handler.html.ko.euc-kr index 94244a295b..05a84fa825 100644 --- a/docs/manual/handler.html.ko.euc-kr +++ b/docs/manual/handler.html.ko.euc-kr @@ -35,7 +35,7 @@ <h2><a name="definition" id="definition">핸들러가 무엇인가</a></h2> <table class="related"><tr><th>관련된 모듈</th><th>관련된 지시어</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_actions.html">mod_actions</a></code></li><li><code class="module"><a href="./mod/mod_asis.html">mod_asis</a></code></li><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="./mod/mod_imap.html">mod_imap</a></code></li><li><code class="module"><a href="./mod/mod_info.html">mod_info</a></code></li><li><code class="module"><a href="./mod/mod_mime.html">mod_mime</a></code></li><li><code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code></li><li><code class="module"><a href="./mod/mod_status.html">mod_status</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_actions.html#action">Action</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removehandler">RemoveHandler</a></code></li><li><code class="directive"><a href="./mod/core.html#sethandler">SetHandler</a></code></li></ul></td></tr></table> - + <p>파일을 요청할때 아파치가 내부적으로 수행할 작업을 "핸들러(handler)"라고 한다. 일반적으로 파일은 파일 종류에 @@ -86,7 +86,7 @@ <p>다음 지시어는 확장자가 <code>html</code>인 파일을 요청할 경우 <code>footer.pl</code> CGI 스크립트를 띄운다.</p> - + <div class="example"><p><code> Action add-footer /cgi-bin/footer.pl<br /> AddHandler add-footer .html @@ -111,7 +111,7 @@ SetHandler send-as-is<br /> </Directory> </code></p></div> - + </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div> <div class="section"> diff --git a/docs/manual/handler.xml.ko b/docs/manual/handler.xml.ko index 5e3497a620..1cec8efc5c 100644 --- a/docs/manual/handler.xml.ko +++ b/docs/manual/handler.xml.ko @@ -47,7 +47,7 @@ <directive module="core">SetHandler</directive> </directivelist> </related> - + <p>파일을 요청할때 아파치가 내부적으로 수행할 작업을 "핸들러(handler)"라고 한다. 일반적으로 파일은 파일 종류에 @@ -99,7 +99,7 @@ <p>다음 지시어는 확장자가 <code>html</code>인 파일을 요청할 경우 <code>footer.pl</code> CGI 스크립트를 띄운다.</p> - + <example> Action add-footer /cgi-bin/footer.pl<br/> AddHandler add-footer .html @@ -124,7 +124,7 @@ SetHandler send-as-is<br/> </Directory> </example> - + </section> </section> <section id="programmer"> diff --git a/docs/manual/howto/auth.html b/docs/manual/howto/auth.html index 01390fb9e8..807297b388 100644 --- a/docs/manual/howto/auth.html +++ b/docs/manual/howto/auth.html @@ -5,3 +5,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: auth.html.ja.jis Content-Language: ja Content-type: text/html; charset=ISO-2022-JP + +URI: auth.html.ko.euc-kr +Content-Language: ko +Content-type: text/html; charset=EUC-KR diff --git a/docs/manual/howto/auth.html.en b/docs/manual/howto/auth.html.en index 4e99650eef..df322477e4 100644 --- a/docs/manual/howto/auth.html.en +++ b/docs/manual/howto/auth.html.en @@ -19,7 +19,8 @@ <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.1</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>Authentication, Authorization and Access Control</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/howto/auth.html" title="English"> en </a> | -<a href="../ja/howto/auth.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> +<a href="../ja/howto/auth.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/auth.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> <p>Authentication is any process by which you verify that @@ -343,7 +344,8 @@ do?</a></h2> </div></div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/howto/auth.html" title="English"> en </a> | -<a href="../ja/howto/auth.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> +<a href="../ja/howto/auth.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/auth.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> <p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> diff --git a/docs/manual/howto/auth.html.ja.jis b/docs/manual/howto/auth.html.ja.jis index 7aec5a0667..0d689c1917 100644 --- a/docs/manual/howto/auth.html.ja.jis +++ b/docs/manual/howto/auth.html.ja.jis @@ -19,7 +19,8 @@ <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP $B%5!<%P(B</a> > <a href="http://httpd.apache.org/docs-project/">$B%I%-%e%a%s%F!<%7%g%s(B</a> > <a href="../">$B%P!<%8%g%s(B 2.1</a> > <a href="./">How-To / $B%A%e!<%H%j%"%k(B</a></div><div id="page-content"><div id="preamble"><h1>$BG'>Z!">5G'!"%"%/%;%9@)8f(B</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/howto/auth.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../ja/howto/auth.html" title="Japanese"> ja </a></p> +<a href="../ja/howto/auth.html" title="Japanese"> ja </a> | +<a href="../ko/howto/auth.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> <div class="outofdate">This translation may be out of date. Check the English version for recent changes.</div> @@ -377,7 +378,8 @@ </div></div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/howto/auth.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../ja/howto/auth.html" title="Japanese"> ja </a></p> +<a href="../ja/howto/auth.html" title="Japanese"> ja </a> | +<a href="../ko/howto/auth.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> <p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">$B%b%8%e!<%k(B</a> | <a href="../mod/directives.html">$B%G%#%l%/%F%#%V(B</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">$BMQ(B$B8l(B</a> | <a href="../sitemap.html">$B%5%$%H%^%C%W(B</a></p></div> diff --git a/docs/manual/howto/auth.html.ko.euc-kr b/docs/manual/howto/auth.html.ko.euc-kr new file mode 100644 index 0000000000..46553fd2aa --- /dev/null +++ b/docs/manual/howto/auth.html.ko.euc-kr @@ -0,0 +1,321 @@ +<?xml version="1.0" encoding="EUC-KR"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="ko" xml:lang="ko"><head><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>인증(Authentication), 권한부여(Authorization), +접근제어(Access Control) - Apache HTTP Server</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /> +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p> +<p class="apache">Apache HTTP Server Version 2.1</p> +<img alt="" src="../images/feather.gif" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.1</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>인증(Authentication), 권한부여(Authorization), +접근제어(Access Control)</h1> +<div class="toplang"> +<p><span>가능한 언어: </span><a href="../en/howto/auth.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../ja/howto/auth.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/auth.html" title="Korean"> ko </a></p> +</div> + + <p>인증(authentication)은 자신이 누구라고 주장하는 사람을 + 확인하는 절차이다. 권한부여(authorization)는 가고 싶은 곳으로 + 가도록 혹은 원하는 정보를 얻도록 허용하는 과정이다.</p> +</div> +<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">관련 모듈과 지시어</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#introduction">소개</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#theprerequisites">기본 지식</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#gettingitworking">기본적인 설정하기</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#lettingmorethanonepersonin">여러명을 들여보내기</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#possibleproblems">발생할 수 있는 문제점</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#whatotherneatstuffcanido">다른 방법도 가능한가?</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#moreinformation">더 많은 정보</a></li> +</ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="related" id="related">관련 모듈과 지시어</a></h2> + <table class="related"><tr><th>관련된 모듈</th><th>관련된 지시어</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code></li><li><code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code></li><li><code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code></li><li><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_authz_host.html#allow">Allow</a></code></li><li><code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code></li><li><code class="directive"><a href="../mod/core.html#authname">AuthName</a></code></li><li><code class="directive"><a href="../mod/core.html#authtype">AuthType</a></code></li><li><code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_host.html#deny">Deny</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/core.html#require">Require</a></code></li></ul></td></tr></table> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="introduction" id="introduction">소개</a></h2> + <p>당신의 웹사이트에 있는 정보가 소수의 사람들만의 비밀이거나 + 이들만을 위한 정보라면, 이 글에서 설명하는 기법을 사용하여 + 당신이 보길 원하는 사람만 페이지를 보도록 할 수 있다.</p> + + <p>이 글은 웹사이트의 일부를 보호하기위해 많은 사람들이 + 사용하는 "표준적인" 방법을 다룬다.</p> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="theprerequisites" id="theprerequisites">기본 지식</a></h2> + <p>이 글에서 다루는 지시어는 서버의 주설정파일(일반적으로 + <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> + 섹션)이나 디렉토리별 설정파일(<code>.htaccess</code> 파일)에서 + 사용한다.</p> + + <p><code>.htaccess</code> 파일을 사용하려면 이 파일에 있는 + 인증 지시어를 허용하도록 서버를 설정해야 한다. 이를 위해 + 디렉토리별 설정파일에 어떤 지시어를 사용할 수 있는지를 결정하는 + <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> 지시어를 + 사용한다.</p> + + <p>여기서는 인증을 다루기 때문에, 다음과 같은 + <code>AllowOverride</code> 지시어가 필요하다.</p> + + <div class="example"><p><code> + AllowOverride AuthConfig + </code></p></div> + + <p>혹은 지시어를 직접 서버 주설정파일에 적는다면, 그 파일에 + 쓰기 권한이 물론 있어야 한다.</p> + + <p>그리고 보호할 파일이 어디있는지 알기위해 서버의 디렉토리 + 구조에 대해 조금 알아야한다. 이 일은 어렵지않고, 적당한 + 때에 자세히 설명할 것이다.</p> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="gettingitworking" id="gettingitworking">기본적인 설정하기</a></h2> + <p>이제 서버의 디렉토리를 암호로 보호하는 기본적인 방법을 + 설명한다.</p> + + <p>먼저 암호파일을 만들어야 한다. 이 파일은 웹에서 접근할 + 수 없는 곳에 있어야 한다. 다른사람이 암호파일을 다운로드하지 + 못하게하기 위해서다. 예를 들어, 문서들이 + <code>/usr/local/apache/htdocs</code>에 있다면 암호파일(들)은 + <code>/usr/local/apache/passwd</code>에 둔다.</p> + + <p>아파치에 포함된 <a href="../programs/htpasswd.html">htpasswd</a> 도구를 사용하여 + 암호파일을 만든다. 이 프로그램은 아파치를 설치한 곳의 + <code>bin</code> 디렉토리에 있다. 파일을 만들려면 다음과 + 같이 입력한다.</p> + + <div class="example"><p><code> + htpasswd -c /usr/local/apache/passwd/passwords rbowen + </code></p></div> + + <p><code>htpasswd</code>는 암호를 물어보고, 확인을 위해 + 암호를 다시 입력하라고 요청한다.</p> + + <div class="example"><p><code> + # htpasswd -c /usr/local/apache/passwd/passwords rbowen<br /> + New password: mypassword<br /> + Re-type new password: mypassword<br /> + Adding password for user rbowen + </code></p></div> + + <p>물론 <code>htpasswd</code>이 실행파일 경로에 없다면 + 실행파일의 전체 경로를 입력해야 한다. 내가 사용하는 서버에서는 + <code>/usr/local/apache/bin/htpasswd</code>에 실행파일이 + 있다.</p> + + <p>다음으로 서버가 암호를 요청하도록 설정하고, 서버에게 + 어떤 사용자의 접근을 허용할지 알려줘야 한다. + <code>httpd.conf</code>를 편집하거나 <code>.htaccess</code> + 파일을 사용하여 설정한다. 예를 들어, + <code>/usr/local/apache/htdocs/secret</code> 디렉토리를 + 보호하려면, 아래 지시어를 + <code>/usr/local/apache/htdocs/secret/.htaccess</code> 파일이나 + <code>httpd.conf</code>의 <Directory + /usr/local/apache/apache/htdocs/secret> 섹션에 적어야 + 한다.</p> + + <div class="example"><p><code> + AuthType Basic<br /> + AuthName "Restricted Files"<br /> + AuthUserFile /usr/local/apache/passwd/passwords<br /> + Require user rbowen + </code></p></div> + + <p>지시어를 하나씩 살펴보자. <code class="directive"><a href="../mod/core.html#authtype">AuthType</a></code> 지시어는 사용자를 인증할 + 방법을 선택한다. 가장 일반적인 방법은 <code>Basic</code>으로, + <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>이 구현한다. 그러나 Basic + 인증은 브라우저가 서버로 암호를 암호화하지 않고 보낸다. + 그러므로 기밀 자료를 보호하기위해 이 방법을 사용하면 안된다. + 아파치는 <code>AuthType Digest</code>라는 인증 방법도 지원한다. + 이 방법은 <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>가 구현하며, 매우 + 안전하다. 가장 최근 클라이언트들만이 Digest 인증을 지원한다고 + 한다.</p> + + <p><code class="directive"><a href="../mod/core.html#authname">AuthName</a></code> 지시어는 + 인증에 사용할 <dfn>영역(realm)</dfn>을 지정한다. 영역은 + 두가지 역할을 한다. 첫번째는 클라이언트가 보통 이 정보를 + 암호 대화창에 보여준다. 두번째는 영역 정보를 사용하여 + 클라이언트가 특정 인증구역에 어떤 암호를 보낼지 결정한다.</p> + + <p>예를 들어, 일단 클라이언트가 <code>"Restricted Files"</code> + 영역에 인증이 성공하였다면, 클라이언트는 자동으로 같은 서버에서 + <code>"Restricted Files"</code> 영역으로 표시된 구역에 대해 + 동일한 암호를 시도한다. 그래서 여러 제한 구역이 같은 영역을 + 공유하면 사용자가 여러번 암호를 입력하지 않아도 된다. 물론 + 보안상 이유로 클라이언트는 서버의 호스트명이 다르면 항상 + 새로 암호를 물어본다.</p> + + <p><code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code> + 지시어는 우리가 방금 <code>htpasswd</code>로 만든 암호파일의 + 경로를 설정한다. 사용자가 많다면 요청마다 매번 사용자를 + 인증하기위해 일반 문서파일을 검색하는데 시간이 상당히 많이 + 걸릴 수 있다. 아파치는 빠른 데이타베이스 파일에 사용자 정보를 + 저장할 수 있다. <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> 모듈은 <code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code> 지시어를 + 제공한다. <a href="../programs/dbmmanage.html">dbmmanage</a> + 프로그램을 사용하여 암호파일을 만들고 다룬다. <a href="http://modules.apache.org/">아파치 모듈 + 데이타베이스</a>에는 여러 다른 인증 방식을 제공하는 제삼자가 + 만든 모듈들이 있다.</p> + + <p>마지막으로 <code class="directive"><a href="../mod/core.html#require">Require</a></code> + 지시어는 서버의 특정 영역에 접근할 수 있는 사용자를 지정하여 + 권한부여를 한다. 다음 절은 <code>require</code> 지시어를 + 사용하는 다양한 방법을 설명한다.</p> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="lettingmorethanonepersonin" id="lettingmorethanonepersonin">여러명을 들여보내기</a></h2> + <p>위의 지시어는 디렉토리로 (사용자명이 <code>rbowen</code>인) + 한 사람만을 들여보낸다. 대부분의 경우 여러 사람을 들여보내고 + 싶을 것이다. 이제 <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>을 + 사용할 때다.</p> + + <p>여러 사람을 들여보내고 싶다면 그룹명과 그 그룹에 어떤 + 사용자들이 있는지 알려주는 그룹파일이 필요하다. 이 파일의 + 형식은 매우 간단하여, 아무 편집기로나 만들 수 있다. 파일내용은 + 다음과 같다.</p> + + <div class="example"><p><code> + GroupName: rbowen dpitts sungo rshersey + </code></p></div> + + <p>그냥 공백으로 구분한 긴 그룹 구성원 목록일 뿐이다.</p> + + <p>기존의 암호파일에 사용자를 추가하려면 다음과 같이 입력한다</p> + + <div class="example"><p><code> + htpasswd /usr/local/apache/passwd/passwords dpitts + </code></p></div> + + <p>전과 같지만, 새로 파일을 만들지 않고 기존 파일에 사용자를 + 추가한다. (<code>-c</code> 옵션은 새로 암호파일을 만든다).</p> + + <p>이제 <code>.htaccess</code> 파일을 다음과 같이 수정한다.</p> + + <div class="example"><p><code> + AuthType Basic<br /> + AuthName "By Invitation Only"<br /> + AuthUserFile /usr/local/apache/passwd/passwords<br /> + AuthGroupFile /usr/local/apache/passwd/groups<br /> + Require group GroupName + </code></p></div> + + <p>그러면 <code>GroupName</code> 그룹에 속하며 + <code>password</code> 파일에 항목이 있는 사용자가 올바른 + 암호를 입력하면 접근을 허용한다.</p> + + <p>여러 일반 사용자를 들여보내는 다른 방법이 있다. 그룹파일을 + 만들 필요없이 다음 지시어를 사용하기만 하면 된다.</p> + + <div class="example"><p><code> + Require valid-user + </code></p></div> + + <p><code>Require user rbowen</code> 대신 이 지시어를 사용하면 + 암호파일에 있는 누구라도 올바른 암호를 입력하기만 하면 접근을 + 허용한다. 그룹별로 다른 암호파일을 사용하여 그룹과 비슷한 + 효과를 얻을 수도 있다. 이 경우 아파치가 파일 두개(암호파일과 + 그룹파일)가 아닌 파일 한개(암호파일)만 검사하면 된다는 것이 + 장점이다. 그러나 여러 암호파일을 관리해야 하고, <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code> 지시어에 + 정확한 암호파일을 지정해야 하는 것은 단점이다.</p> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="possibleproblems" id="possibleproblems">발생할 수 있는 문제점</a></h2> + <p>Basic 인증 방식은 서버에서 문서를 요청할 때마다 사용자명과 + 암호를 확인한다. 심지어 같은 페이지를 새로 고침할 때도 페이지와 + (그림이 암호로 보호하는 디렉토리에 있는 경우) 페이지에 있는 + 모든 그림에 대해 다시 확인한다. 짐작하듯이 속도가 조금 느려진다. + 암호파일을 열어서 사용자명을 찾을 때까지 사용자 목록을 살펴봐야 + 하기때문에 암호파일 크기가 커질 수록 더 느려진다. 그리고 + 이 작업을 페이지를 요청할 때마다 진행한다.</p> + + <p>그래서 현실적으로 한 암호파일에 저장할 수 있는 사용자수에는 + 한계가 있다. 이 한계는 사용하는 서버의 성능에 따라 다르지만, + 항목이 수백개가 넘는다면 느려진다고 생각하고 다른 인증 방법을 + 고려해야 한다.</p> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="whatotherneatstuffcanido" id="whatotherneatstuffcanido">다른 방법도 가능한가?</a></h2> + <p>사용자명과 암호를 사용한 인증이 다가 아니다. 종종 접속한 + 장소와 같은 다른 정보를 가지고 사용자를 들여보내고 싶을 + 때가 있다.</p> + + <p><code class="directive"><a href="../mod/mod_authz_host.html#allow">Allow</a></code>와 + <code class="directive"><a href="../mod/mod_authz_host.html#deny">Deny</a></code> 지시어는 + 문서를 요청한 컴퓨터의 호스트명 혹은 호스트 주소를 가지고 + 접근을 허용하거나 거부한다. <code class="directive"><a href="../mod/mod_authz_host.html#order">Order</a></code> 지시어는 이 두 + 지시어와 같이 사용하여, 아파치에게 어떤 순서로 규칙을 적용할지 + 알린다.</p> + + <p>이들 지시어 사용법은 다음과 같다.</p> + + <div class="example"><p><code> + Allow from <var>address</var> + </code></p></div> + + <p>여기서 <var>address</var>는 IP 주소(혹은 IP 주소 일부)나 + 완전한 도메인명(혹은 도메인명 일부)이다. 원한다면 여러 주소나 + 도메인명을 사용할 수 있다.</p> + + <p>예를 들어, 누군가가 게시판에 광고를 올리고 있다면 다음과 + 같이 접근을 막을 수 있다.</p> + + <div class="example"><p><code> + Deny from 205.252.46.165 + </code></p></div> + + <p>그 주소에서 들어오는 방문자는 이 지시어가 보호하는 페이지를 + 볼 수 없다. IP 주소 대신 다음과 같이 컴퓨터명을 사용할 수도 + 있다.</p> + + <div class="example"><p><code> + Deny from <var>host.example.com</var> + </code></p></div> + + <p>또, 전체 도메인의 접근을 막으려면 주소나 도메인명의 일부를 + 사용한다.</p> + + <div class="example"><p><code> + Deny from <var>192.101.205</var><br /> + Deny from <var>cyberthugs.com</var> <var>moreidiots.com</var><br /> + Deny from ke + </code></p></div> + + <p><code class="directive"><a href="../mod/mod_authz_host.html#order">Order</a></code>를 + <code class="directive"><a href="../mod/mod_authz_host.html#deny">Deny</a></code>와 <code class="directive"><a href="../mod/mod_authz_host.html#allow">Allow</a></code> 지시어와 같이 + 사용하여 실제로 원하는 대상을 막을 수 있다.</p> + + <div class="example"><p><code> + Order deny,allow<br /> + Deny from all<br /> + Allow from <var>dev.example.com</var> + </code></p></div> + + <p><code class="directive"><a href="../mod/mod_authz_host.html#allow">Allow</a></code> + 지시어만 사용하면, 해당 호스트의 사용자를 허용하고 거기에 + 추가로 모든 사람을 허용하므로 원하는 결과를 얻지 못한다. + 당신은 특정 사람<em>만</em> 허용하길 원한다.</p> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="moreinformation" id="moreinformation">더 많은 정보</a></h2> + <p><code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>과 + <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> 문서에 접근제어가 동작하는 + 방법에 대한 더 많은 정보가 있다.</p> +</div></div> +<div class="bottomlang"> +<p><span>가능한 언어: </span><a href="../en/howto/auth.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../ja/howto/auth.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/auth.html" title="Korean"> ko </a></p> +</div><div id="footer"> +<p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/howto/auth.xml.ko b/docs/manual/howto/auth.xml.ko new file mode 100644 index 0000000000..66d85f591c --- /dev/null +++ b/docs/manual/howto/auth.xml.ko @@ -0,0 +1,333 @@ +<?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.10 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed 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. +--> + +<manualpage metafile="auth.xml.meta"> +<parentdocument href="./">How-To / Tutorials</parentdocument> + +<title>인증(Authentication), 권한부여(Authorization), +접근제어(Access Control)</title> + +<summary> + <p>인증(authentication)은 자신이 누구라고 주장하는 사람을 + 확인하는 절차이다. 권한부여(authorization)는 가고 싶은 곳으로 + 가도록 혹은 원하는 정보를 얻도록 허용하는 과정이다.</p> +</summary> + +<section id="related"><title>관련 모듈과 지시어</title> + <related> + <modulelist> + <module>mod_auth_basic</module> + <module>mod_authn_file</module> + <module>mod_authz_groupfile</module> + <module>mod_authz_host</module> + </modulelist> + + <directivelist> + <directive module="mod_authz_host">Allow</directive> + <directive module="mod_authz_groupfile">AuthGroupFile</directive> + <directive module="core">AuthName</directive> + <directive module="core">AuthType</directive> + <directive module="mod_authn_file">AuthUserFile</directive> + <directive module="mod_authz_host">Deny</directive> + <directive module="core">Options</directive> + <directive module="core">Require</directive> + </directivelist> + </related> +</section> + +<section id="introduction"><title>소개</title> + <p>당신의 웹사이트에 있는 정보가 소수의 사람들만의 비밀이거나 + 이들만을 위한 정보라면, 이 글에서 설명하는 기법을 사용하여 + 당신이 보길 원하는 사람만 페이지를 보도록 할 수 있다.</p> + + <p>이 글은 웹사이트의 일부를 보호하기위해 많은 사람들이 + 사용하는 "표준적인" 방법을 다룬다.</p> +</section> + +<section id="theprerequisites"><title>기본 지식</title> + <p>이 글에서 다루는 지시어는 서버의 주설정파일(일반적으로 + <directive module="core" type="section">Directory</directive> + 섹션)이나 디렉토리별 설정파일(<code>.htaccess</code> 파일)에서 + 사용한다.</p> + + <p><code>.htaccess</code> 파일을 사용하려면 이 파일에 있는 + 인증 지시어를 허용하도록 서버를 설정해야 한다. 이를 위해 + 디렉토리별 설정파일에 어떤 지시어를 사용할 수 있는지를 결정하는 + <directive module="core">AllowOverride</directive> 지시어를 + 사용한다.</p> + + <p>여기서는 인증을 다루기 때문에, 다음과 같은 + <code>AllowOverride</code> 지시어가 필요하다.</p> + + <example> + AllowOverride AuthConfig + </example> + + <p>혹은 지시어를 직접 서버 주설정파일에 적는다면, 그 파일에 + 쓰기 권한이 물론 있어야 한다.</p> + + <p>그리고 보호할 파일이 어디있는지 알기위해 서버의 디렉토리 + 구조에 대해 조금 알아야한다. 이 일은 어렵지않고, 적당한 + 때에 자세히 설명할 것이다.</p> +</section> + +<section id="gettingitworking"><title>기본적인 설정하기</title> + <p>이제 서버의 디렉토리를 암호로 보호하는 기본적인 방법을 + 설명한다.</p> + + <p>먼저 암호파일을 만들어야 한다. 이 파일은 웹에서 접근할 + 수 없는 곳에 있어야 한다. 다른사람이 암호파일을 다운로드하지 + 못하게하기 위해서다. 예를 들어, 문서들이 + <code>/usr/local/apache/htdocs</code>에 있다면 암호파일(들)은 + <code>/usr/local/apache/passwd</code>에 둔다.</p> + + <p>아파치에 포함된 <a + href="../programs/htpasswd.html">htpasswd</a> 도구를 사용하여 + 암호파일을 만든다. 이 프로그램은 아파치를 설치한 곳의 + <code>bin</code> 디렉토리에 있다. 파일을 만들려면 다음과 + 같이 입력한다.</p> + + <example> + htpasswd -c /usr/local/apache/passwd/passwords rbowen + </example> + + <p><code>htpasswd</code>는 암호를 물어보고, 확인을 위해 + 암호를 다시 입력하라고 요청한다.</p> + + <example> + # htpasswd -c /usr/local/apache/passwd/passwords rbowen<br /> + New password: mypassword<br /> + Re-type new password: mypassword<br /> + Adding password for user rbowen + </example> + + <p>물론 <code>htpasswd</code>이 실행파일 경로에 없다면 + 실행파일의 전체 경로를 입력해야 한다. 내가 사용하는 서버에서는 + <code>/usr/local/apache/bin/htpasswd</code>에 실행파일이 + 있다.</p> + + <p>다음으로 서버가 암호를 요청하도록 설정하고, 서버에게 + 어떤 사용자의 접근을 허용할지 알려줘야 한다. + <code>httpd.conf</code>를 편집하거나 <code>.htaccess</code> + 파일을 사용하여 설정한다. 예를 들어, + <code>/usr/local/apache/htdocs/secret</code> 디렉토리를 + 보호하려면, 아래 지시어를 + <code>/usr/local/apache/htdocs/secret/.htaccess</code> 파일이나 + <code>httpd.conf</code>의 <Directory + /usr/local/apache/apache/htdocs/secret> 섹션에 적어야 + 한다.</p> + + <example> + AuthType Basic<br /> + AuthName "Restricted Files"<br /> + AuthUserFile /usr/local/apache/passwd/passwords<br /> + Require user rbowen + </example> + + <p>지시어를 하나씩 살펴보자. <directive + module="core">AuthType</directive> 지시어는 사용자를 인증할 + 방법을 선택한다. 가장 일반적인 방법은 <code>Basic</code>으로, + <module>mod_auth_basic</module>이 구현한다. 그러나 Basic + 인증은 브라우저가 서버로 암호를 암호화하지 않고 보낸다. + 그러므로 기밀 자료를 보호하기위해 이 방법을 사용하면 안된다. + 아파치는 <code>AuthType Digest</code>라는 인증 방법도 지원한다. + 이 방법은 <module>mod_auth_digest</module>가 구현하며, 매우 + 안전하다. 가장 최근 클라이언트들만이 Digest 인증을 지원한다고 + 한다.</p> + + <p><directive module="core">AuthName</directive> 지시어는 + 인증에 사용할 <dfn>영역(realm)</dfn>을 지정한다. 영역은 + 두가지 역할을 한다. 첫번째는 클라이언트가 보통 이 정보를 + 암호 대화창에 보여준다. 두번째는 영역 정보를 사용하여 + 클라이언트가 특정 인증구역에 어떤 암호를 보낼지 결정한다.</p> + + <p>예를 들어, 일단 클라이언트가 <code>"Restricted Files"</code> + 영역에 인증이 성공하였다면, 클라이언트는 자동으로 같은 서버에서 + <code>"Restricted Files"</code> 영역으로 표시된 구역에 대해 + 동일한 암호를 시도한다. 그래서 여러 제한 구역이 같은 영역을 + 공유하면 사용자가 여러번 암호를 입력하지 않아도 된다. 물론 + 보안상 이유로 클라이언트는 서버의 호스트명이 다르면 항상 + 새로 암호를 물어본다.</p> + + <p><directive module="mod_authn_file">AuthUserFile</directive> + 지시어는 우리가 방금 <code>htpasswd</code>로 만든 암호파일의 + 경로를 설정한다. 사용자가 많다면 요청마다 매번 사용자를 + 인증하기위해 일반 문서파일을 검색하는데 시간이 상당히 많이 + 걸릴 수 있다. 아파치는 빠른 데이타베이스 파일에 사용자 정보를 + 저장할 수 있다. <module>mod_authn_dbm</module> 모듈은 <directive + module="mod_authn_dbm">AuthDBMUserFile</directive> 지시어를 + 제공한다. <a href="../programs/dbmmanage.html">dbmmanage</a> + 프로그램을 사용하여 암호파일을 만들고 다룬다. <a + href="http://modules.apache.org/">아파치 모듈 + 데이타베이스</a>에는 여러 다른 인증 방식을 제공하는 제삼자가 + 만든 모듈들이 있다.</p> + + <p>마지막으로 <directive module="core">Require</directive> + 지시어는 서버의 특정 영역에 접근할 수 있는 사용자를 지정하여 + 권한부여를 한다. 다음 절은 <code>require</code> 지시어를 + 사용하는 다양한 방법을 설명한다.</p> +</section> + +<section id="lettingmorethanonepersonin"><title>여러명을 들여보내기</title> + <p>위의 지시어는 디렉토리로 (사용자명이 <code>rbowen</code>인) + 한 사람만을 들여보낸다. 대부분의 경우 여러 사람을 들여보내고 + 싶을 것이다. 이제 <directive + module="mod_authz_groupfile">AuthGroupFile</directive>을 + 사용할 때다.</p> + + <p>여러 사람을 들여보내고 싶다면 그룹명과 그 그룹에 어떤 + 사용자들이 있는지 알려주는 그룹파일이 필요하다. 이 파일의 + 형식은 매우 간단하여, 아무 편집기로나 만들 수 있다. 파일내용은 + 다음과 같다.</p> + + <example> + GroupName: rbowen dpitts sungo rshersey + </example> + + <p>그냥 공백으로 구분한 긴 그룹 구성원 목록일 뿐이다.</p> + + <p>기존의 암호파일에 사용자를 추가하려면 다음과 같이 입력한다</p> + + <example> + htpasswd /usr/local/apache/passwd/passwords dpitts + </example> + + <p>전과 같지만, 새로 파일을 만들지 않고 기존 파일에 사용자를 + 추가한다. (<code>-c</code> 옵션은 새로 암호파일을 만든다).</p> + + <p>이제 <code>.htaccess</code> 파일을 다음과 같이 수정한다.</p> + + <example> + AuthType Basic<br /> + AuthName "By Invitation Only"<br /> + AuthUserFile /usr/local/apache/passwd/passwords<br /> + AuthGroupFile /usr/local/apache/passwd/groups<br /> + Require group GroupName + </example> + + <p>그러면 <code>GroupName</code> 그룹에 속하며 + <code>password</code> 파일에 항목이 있는 사용자가 올바른 + 암호를 입력하면 접근을 허용한다.</p> + + <p>여러 일반 사용자를 들여보내는 다른 방법이 있다. 그룹파일을 + 만들 필요없이 다음 지시어를 사용하기만 하면 된다.</p> + + <example> + Require valid-user + </example> + + <p><code>Require user rbowen</code> 대신 이 지시어를 사용하면 + 암호파일에 있는 누구라도 올바른 암호를 입력하기만 하면 접근을 + 허용한다. 그룹별로 다른 암호파일을 사용하여 그룹과 비슷한 + 효과를 얻을 수도 있다. 이 경우 아파치가 파일 두개(암호파일과 + 그룹파일)가 아닌 파일 한개(암호파일)만 검사하면 된다는 것이 + 장점이다. 그러나 여러 암호파일을 관리해야 하고, <directive + module="mod_authn_file">AuthUserFile</directive> 지시어에 + 정확한 암호파일을 지정해야 하는 것은 단점이다.</p> +</section> + +<section id="possibleproblems"><title>발생할 수 있는 문제점</title> + <p>Basic 인증 방식은 서버에서 문서를 요청할 때마다 사용자명과 + 암호를 확인한다. 심지어 같은 페이지를 새로 고침할 때도 페이지와 + (그림이 암호로 보호하는 디렉토리에 있는 경우) 페이지에 있는 + 모든 그림에 대해 다시 확인한다. 짐작하듯이 속도가 조금 느려진다. + 암호파일을 열어서 사용자명을 찾을 때까지 사용자 목록을 살펴봐야 + 하기때문에 암호파일 크기가 커질 수록 더 느려진다. 그리고 + 이 작업을 페이지를 요청할 때마다 진행한다.</p> + + <p>그래서 현실적으로 한 암호파일에 저장할 수 있는 사용자수에는 + 한계가 있다. 이 한계는 사용하는 서버의 성능에 따라 다르지만, + 항목이 수백개가 넘는다면 느려진다고 생각하고 다른 인증 방법을 + 고려해야 한다.</p> +</section> + +<section id="whatotherneatstuffcanido"><title>다른 방법도 가능한가?</title> + <p>사용자명과 암호를 사용한 인증이 다가 아니다. 종종 접속한 + 장소와 같은 다른 정보를 가지고 사용자를 들여보내고 싶을 + 때가 있다.</p> + + <p><directive module="mod_authz_host">Allow</directive>와 + <directive module="mod_authz_host">Deny</directive> 지시어는 + 문서를 요청한 컴퓨터의 호스트명 혹은 호스트 주소를 가지고 + 접근을 허용하거나 거부한다. <directive + module="mod_authz_host">Order</directive> 지시어는 이 두 + 지시어와 같이 사용하여, 아파치에게 어떤 순서로 규칙을 적용할지 + 알린다.</p> + + <p>이들 지시어 사용법은 다음과 같다.</p> + + <example> + Allow from <var>address</var> + </example> + + <p>여기서 <var>address</var>는 IP 주소(혹은 IP 주소 일부)나 + 완전한 도메인명(혹은 도메인명 일부)이다. 원한다면 여러 주소나 + 도메인명을 사용할 수 있다.</p> + + <p>예를 들어, 누군가가 게시판에 광고를 올리고 있다면 다음과 + 같이 접근을 막을 수 있다.</p> + + <example> + Deny from 205.252.46.165 + </example> + + <p>그 주소에서 들어오는 방문자는 이 지시어가 보호하는 페이지를 + 볼 수 없다. IP 주소 대신 다음과 같이 컴퓨터명을 사용할 수도 + 있다.</p> + + <example> + Deny from <var>host.example.com</var> + </example> + + <p>또, 전체 도메인의 접근을 막으려면 주소나 도메인명의 일부를 + 사용한다.</p> + + <example> + Deny from <var>192.101.205</var><br /> + Deny from <var>cyberthugs.com</var> <var>moreidiots.com</var><br /> + Deny from ke + </example> + + <p><directive module="mod_authz_host">Order</directive>를 + <directive module="mod_authz_host">Deny</directive>와 <directive + module="mod_authz_host">Allow</directive> 지시어와 같이 + 사용하여 실제로 원하는 대상을 막을 수 있다.</p> + + <example> + Order deny,allow<br /> + Deny from all<br /> + Allow from <var>dev.example.com</var> + </example> + + <p><directive module="mod_authz_host">Allow</directive> + 지시어만 사용하면, 해당 호스트의 사용자를 허용하고 거기에 + 추가로 모든 사람을 허용하므로 원하는 결과를 얻지 못한다. + 당신은 특정 사람<em>만</em> 허용하길 원한다.</p> +</section> + +<section id="moreinformation"><title>더 많은 정보</title> + <p><module>mod_auth_basic</module>과 + <module>mod_authz_host</module> 문서에 접근제어가 동작하는 + 방법에 대한 더 많은 정보가 있다.</p> +</section> + +</manualpage> + diff --git a/docs/manual/howto/auth.xml.meta b/docs/manual/howto/auth.xml.meta index 6ba65e70b8..57b8321c58 100644 --- a/docs/manual/howto/auth.xml.meta +++ b/docs/manual/howto/auth.xml.meta @@ -8,5 +8,6 @@ <variants> <variant>en</variant> <variant outdated="yes">ja</variant> + <variant>ko</variant> </variants> </metafile> diff --git a/docs/manual/howto/cgi.html b/docs/manual/howto/cgi.html index 6714970c80..1d71f9927a 100644 --- a/docs/manual/howto/cgi.html +++ b/docs/manual/howto/cgi.html @@ -5,3 +5,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: cgi.html.ja.jis Content-Language: ja Content-type: text/html; charset=ISO-2022-JP + +URI: cgi.html.ko.euc-kr +Content-Language: ko +Content-type: text/html; charset=EUC-KR diff --git a/docs/manual/howto/cgi.html.en b/docs/manual/howto/cgi.html.en index e995562e85..4575092faa 100644 --- a/docs/manual/howto/cgi.html.en +++ b/docs/manual/howto/cgi.html.en @@ -19,7 +19,8 @@ <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.1</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>Apache Tutorial: Dynamic Content with CGI</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/howto/cgi.html" title="English"> en </a> | -<a href="../ja/howto/cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> +<a href="../ja/howto/cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> </div> <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#intro">Introduction</a></li> @@ -546,7 +547,8 @@ </div></div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/howto/cgi.html" title="English"> en </a> | -<a href="../ja/howto/cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> +<a href="../ja/howto/cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> <p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> diff --git a/docs/manual/howto/cgi.html.ja.jis b/docs/manual/howto/cgi.html.ja.jis index 79252063df..16fc379a5b 100644 --- a/docs/manual/howto/cgi.html.ja.jis +++ b/docs/manual/howto/cgi.html.ja.jis @@ -19,7 +19,8 @@ <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP $B%5!<%P(B</a> > <a href="http://httpd.apache.org/docs-project/">$B%I%-%e%a%s%F!<%7%g%s(B</a> > <a href="../">$B%P!<%8%g%s(B 2.1</a> > <a href="./">How-To / $B%A%e!<%H%j%"%k(B</a></div><div id="page-content"><div id="preamble"><h1>Apache Tutorial: CGI $B$K$h$kF0E*%3%s%F%s%D(B</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/howto/cgi.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../ja/howto/cgi.html" title="Japanese"> ja </a></p> +<a href="../ja/howto/cgi.html" title="Japanese"> ja </a> | +<a href="../ko/howto/cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> </div> <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#intro">$B$O$8$a$K(B</a></li> @@ -535,7 +536,8 @@ </div></div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/howto/cgi.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../ja/howto/cgi.html" title="Japanese"> ja </a></p> +<a href="../ja/howto/cgi.html" title="Japanese"> ja </a> | +<a href="../ko/howto/cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> <p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">$B%b%8%e!<%k(B</a> | <a href="../mod/directives.html">$B%G%#%l%/%F%#%V(B</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">$BMQ(B$B8l(B</a> | <a href="../sitemap.html">$B%5%$%H%^%C%W(B</a></p></div> diff --git a/docs/manual/howto/cgi.html.ko.euc-kr b/docs/manual/howto/cgi.html.ko.euc-kr new file mode 100644 index 0000000000..0b54a79c6d --- /dev/null +++ b/docs/manual/howto/cgi.html.ko.euc-kr @@ -0,0 +1,501 @@ +<?xml version="1.0" encoding="EUC-KR"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="ko" xml:lang="ko"><head><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>아파치 투토리얼: CGI를 사용한 동적 페이지 생성 - Apache HTTP Server</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /> +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p> +<p class="apache">Apache HTTP Server Version 2.1</p> +<img alt="" src="../images/feather.gif" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.1</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>아파치 투토리얼: CGI를 사용한 동적 페이지 생성</h1> +<div class="toplang"> +<p><span>가능한 언어: </span><a href="../en/howto/cgi.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../ja/howto/cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/cgi.html" title="Korean"> ko </a></p> +</div> +</div> +<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#intro">소개</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#configuring">CGI를 허용하도록 아파치 설정하기</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#writing">CGI 프로그램 작성하기</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">그러나 아직 동작하지 않아요!</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#behindscenes">뒤에서는 무슨 일이 벌어지는가?</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#libraries">CGI 모듈/라이브러리</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#moreinfo">더 많은 정보...</a></li> +</ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="intro" id="intro">소개</a></h2> + + + <table class="related"><tr><th>관련된 모듈</th><th>관련된 지시어</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code></li><li><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li></ul></td></tr></table> + + <p>CGI (Common Gateway Interface)는 웹서버가 보통 CGI 프로그램 + 혹은 CGI 스크립트라고 부르는, (웹페이지 내용을 만드는) 외부 + 프로그램과 통신하는 방법을 정의한다. 웹사이트에서 동적인 + 페이지를 만드는 가장 흔하고 간단한 방법이다. 이 문서는 아파치 + 웹서버에 CGI를 구성하는 방법을 소개하고, CGI 프로그램을 + 작성해본다.</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="configuring" id="configuring">CGI를 허용하도록 아파치 설정하기</a></h2> + + + <p>CGI 프로그램이 올바로 동작하려면 CGI 실행이 가능하도록 + 아파치를 설정해야 한다. 설정하는 방법은 여러가지다.</p> + + <h3><a name="scriptalias" id="scriptalias">ScriptAlias</a></h3> + + + <p><code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> + 지시어를 사용하면 아파치는 특정 디렉토리를 CGI 프로그램용으로 + 둔다. 아파치는 이 디렉토리에 있는 모든 파일이 CGI + 프로그램이라고 가정하여 클라이언트가 자원을 요청하면 자원을 + 실행하려고 시도한다.</p> + + <p><code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> + 지시어는 다음과 같이 사용한다.</p> + + <div class="example"><p><code> + ScriptAlias /cgi-bin/ /usr/local/apache2/cgi-bin/ + </code></p></div> + + <p>위 예제는 아파치를 기본 장소에 설치한 경우 + <code>httpd.conf</code> 설정파일에 있는 내용이다. <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> 지시어는 <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> 지시어와 같이 URL + 앞부분을 특정 디렉토리로 대응한다. + <code class="directive">Alias</code>와 + <code class="directive">ScriptAlias</code>는 보통 <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> 디렉토리 밖에 있는 + 디렉토리에 사용한다. <code class="directive">Alias</code>와 + <code class="directive">ScriptAlias</code>의 차이점은 + <code class="directive">ScriptAlias</code>가 추가로 URL 앞부분으로 + 시작하는 모든 파일을 CGI 프로그램으로 취급하는 점이다. + 그래서 위의 설정은 아파치에게 <code>/cgi-bin/</code>으로 + 시작하는 자원을 요청하면 + <code>/usr/local/apache2/cgi-bin/</code> 디렉토리에서 + 찾아서 CGI 프로그램으로 처리하라고 알린다.</p> + + <p>예를 들어, URL + <code>http://www.example.com/cgi-bin/test.pl</code>을 + 요청하면 아파치는 + <code>/usr/local/apache2/cgi-bin/test.pl</code> 파일을 + 실행하여 결과를 반환한다. 물론 파일이 존재하고 실행가능하며 + 어떤 방법으로든 출력을 해야 한다. 그렇지 않으면 아파치는 + 오류문을 보낸다.</p> + + + <h3><a name="nonscriptalias" id="nonscriptalias">ScriptAlias 디렉토리 밖에 있는 CGI</a></h3> + + + <p>보통 보안상 이유때문에 CGI 프로그램은 <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>한 디렉토리에 + 한정한다. 그래서 관리자는 누가 CGI 프로그램을 사용할 수 + 있는지 엄격히 감독할 수 있다. 그러나 적당한 보안조치를 + 취했다면 아무 디렉토리에서나 CGI 프로그램을 실행하지 않을 + 이유가 없다. 예를 들어, <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> 지시어를 사용하여 + 사용자가 자신의 홈디렉토리에 웹페이지를 가지는 경우를 + 가정하자. 사용자가 자신의 CGI 프로그램을 사용하고 싶은데 + <code>cgi-bin</code> 디렉토리에 접근권한이 없다면, 다른 + 곳에서라도 CGI 프로그램을 실행하고 싶을 것이다.</p> + + <p>아무 디렉토리에서나 CGI 실행을 허용하려면 두 과정이 + 필요하다. 먼저, <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code>나 <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code> 지시어를 사용하여 + <code>cgi-script</code> 핸들러를 작동해야 한다. 두번째로, + <code class="directive"><a href="../mod/core.html#options">Options</a></code> 지시어에 + <code>ExecCGI</code>를 지정해야 한다.</p> + + + <h3><a name="options" id="options">Options를 사용하여 명시적으로 CGI 실행을 허용하기</a></h3> + + + <p>서버의 주설정파일에 직접 <code class="directive"><a href="../mod/core.html#options">Options</a></code> 지시어를 사용하여 특정 + 디렉토리에서 CGI 실행을 허용할 수 있다.</p> + + <div class="example"><p><code> + <Directory /usr/local/apache2/htdocs/somedir><br /> + <span class="indent"> + Options +ExecCGI<br /> + </span> + </Directory> + </code></p></div> + + <p>위 지시어로 아파치는 CGI 파일의 실행을 허용한다. 어떤 + 파일이 CGI 파일인지도 서버에게 알려야 한다. 다음 <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> 지시어는 서버에게 + 확장자가 <code>cgi</code>나 <code>pl</code>인 파일은 모두 + CGI 프로그램이라고 알린다.</p> + + <div class="example"><p><code> + AddHandler cgi-script .cgi .pl + </code></p></div> + + + <h3><a name="htaccess" id="htaccess">.htaccess 파일</a></h3> + + + <p><a href="htaccess.html"><code>.htaccess</code> 투토리얼</a>은 + <code>httpd.conf</code>에 접근권한이 없는 경우에 CGI 프로그램을 + 사용할 수 있는 방법을 알려준다.</p> + + + <h3><a name="userdir" id="userdir">사용자 디렉토리</a></h3> + + + <p>아래 설정을 사용하면 사용자 디렉토리에서 <code>.cgi</code>로 + 끝나는 파일을 CGI 프로그램으로 실행한다.</p> + + <div class="example"><p><code> + <Directory /home/*/public_html><br /> + <span class="indent"> + Options +ExecCGI<br /> + AddHandler cgi-script .cgi<br /> + </span> + </Directory> + </code></p></div> + + <p>다음을 사용하면 사용자 디렉토리의 <code>cgi-bin</code> + 하위디렉토리에 있는 모든 파일을 CGI 프로그램으로 인식한다.</p> + + <div class="example"><p><code> + <Directory /home/*/public_html/cgi-bin><br /> + <span class="indent"> + Options ExecCGI<br /> + SetHandler cgi-script<br /> + </span> + </Directory> + </code></p></div> + + + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="writing" id="writing">CGI 프로그램 작성하기</a></h2> + + + <p>``일반적인'' 프로그래밍과 CGI 프로그래밍 사이에는 두가지 + 주된 차이점이 있다.</p> + + <p>첫번째 차이는 CGI 프로그램은 다른 출력을 하기전에 먼저 + MIME-type 헤더를 출력해야 한다는 점이다. HTTP 헤더는 + 클라이언트에게 클라이언트가 어떤 내용을 받게될지 미리 알린다. + 보통 다음과 같다.</p> + + <div class="example"><p><code> + Content-type: text/html + </code></p></div> + + <p>두번째 차이는 HTML 혹은 브라우저가 보여줄 수 있는 형식으로 + 출력해야 한다는 점이다. 대부분의 경우 HTML을 출력하지만, + 때때로 gif 그림과 같이 HTML이 아닌 내용을 출력하는 CGI + 프로그램을 작성하는 경우도 있다.</p> + + <p>두가지를 제외하고는 CGI 프로그램 작성은 이미 만들어 보았을 + 다른 프로그램들과 매우 비슷하다.</p> + + <h3><a name="firstcgi" id="firstcgi">처음으로 만든 CGI 프로그램</a></h3> + + + <p>다음은 브라우저에 한 줄을 찍는 CGI 프로그램 예제다. + 그대로 <code>first.pl</code>이라는 파일에 저장하고, + <code>cgi-bin</code> 디렉토리에 복사한다.</p> + + <div class="example"><p><code> + #!/usr/bin/perl<br /> + print "Content-type: text/html\n\n";<br /> + print "Hello, World."; + </code></p></div> + + <p>Perl에 익숙하지 않더라도 무슨 일이 일어나는지 알 수 + 있다. 첫번째 줄은 아파치(혹은 사용하는 쉘)에게 + <code>/usr/bin/perl</code> 위치에 있는 인터프리터을 사용하여 + 이 프로그램 파일을 실행하라고 알린다. 두번째 줄은 방금 + 말한 content-type 선언을 출력하고 carriage-return 줄바꿈을 + 두번 출력한다. 그러면 헤더 뒤에 HTTP 헤더의 끝을 뜻하는 + 빈줄이 생기고, 본문이 시작한다. 세번째 줄은 "Hello, World." + 문자열을 출력한다. 이것으로 끝이다.</p> + + <p>브라우저를 실행하고 주소를 입력한다</p> + + <div class="example"><p><code> + http://www.example.com/cgi-bin/first.pl + </code></p></div> + + <p>파일 장소를 입력하면, 브라우저창에 <code>Hello, World.</code> + 한 줄이 보인다. 흥분되지는 않지만, 한번 동작하는 것을 + 보았으니 이제 다른 것을 시도해 볼 수 있다.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="troubleshoot" id="troubleshoot">그러나 아직 동작하지 않아요!</a></h2> + + + <p>웹에서 CGI 프로그램에 접근할때 브라우저에 나올 수 있는 + 내용은 기본적으로 네가지다.</p> + + <dl> + <dt>CGI 프로그램의 출력</dt> + <dd>좋다! 모든 것이 잘 동작한다는 뜻이다. 출력은 정확하지만 + 브라우저가 올바로 처리하지 못한다면, CGI 프로그램에서 + 올바른 <code>Content-Type</code>을 설정하였는지 확인한다.</dd> + + <dt>CGI 프로그램 소스코드 혹은 "POST Method Not Allowed" + 문구</dt> + <dd>CGI 프로그램을 실행하도록 아파치를 적절히 설정하지 + 않았다는 뜻이다. <a href="#configuring">아파치 설정하기</a> + 절을 다시 읽고 빼먹은 부분이 있는지 찾아봐라.</dd> + + <dt>"Forbidden"으로 시작하는 문구</dt> + <dd>권한 문제가 있다는 뜻이다. <a href="#errorlogs">아파치 + 오류 로그</a>와 아래 <a href="#permissions">파일권한</a> + 절을 확인하라.</dd> + + <dt>"Internal Server Error"라는 문구</dt> + <dd><a href="#errorlogs">아파치 오류 로그</a>를 보면 아마도 + CGI 프로그램이 출력한 오류문과 함께 "Premature end of + script headers"가 보일 것이다. 이 경우 아래 내용들을 하나씩 + 확인하여 어떤 이유로 CGI 프로그램이 적절한 HTTP 헤더를 + 출력하지 못했는지 알아본다.</dd> + </dl> + + <h3><a name="permissions" id="permissions">파일권한</a></h3> + + + <p>서버는 당신과 동일한 계정으로 동작하지 않음을 명심하라. + 즉, 서버가 시작하면 서버는 비특권 사용자 권한(보통 + <code>nobody</code>나 <code>www</code>)으로 동작한다. + 그래서 당신이 소유한 파일을 실행하려면 권한이 필요하다. + 파일에 <code>nobody</code>가 실행하기에 충분한 권한을 + 주기위해 보통 모두에게 파일의 실행 권한을 준다.</p> + + <div class="example"><p><code> + chmod a+x first.pl + </code></p></div> + + <p>또, 프로그램이 다른 파일을 읽거나 쓴다면 이 파일에도 + 적절한 권한이 필요하다.</p> + + + + <h3><a name="pathinformation" id="pathinformation">경로 정보와 환경</a></h3> + + + <p>명령행에서 프로그램을 실행하면 자동으로 어떤 정보가 + 쉘로 전달된다. 예를 들어, <code>PATH</code>는 쉘에게 당신이 + 말한 파일을 찾을 장소를 알려준다.</p> + + <p>웹서버가 프로그램을 CGI 프로그램으로 실행할때는 + <code>PATH</code>가 다를 수 있다. (예를 들어, + <code>sendmail</code> 같이) CGI 프로그램 안에서 실행하는 + 명령어는 완전한 경로로 명시해야 쉘이 명령어를 찾을 수 + 있다.</p> + + <p>경로 문제는 다음과 같이 CGI 프로그램 첫번째 줄에 나오는 + 스크립트 인터프리터 (보통 <code>perl</code>) 경로에서 + 자주 발생한다.</p> + + <div class="example"><p><code> + #!/usr/bin/perl + </code></p></div> + + <p>실제로 인터프리터의 경로인지 확인한다.</p> + + <p>또, CGI 프로그램이 다른 <a href="#env">환경변수</a>를 + 사용한다면 아파치가 이 변수들을 프로그램에게 전달해야 + 한다.</p> + + + + <h3><a name="syntaxerrors" id="syntaxerrors">프로그램 오류</a></h3> + + + <p>CGI 프로그램이 실패하는 경우 대부분 프로그램 자체 + 문제때문이다. 특히 위의 두가지 실수를 하지 않았고 이 글을 + 계속 보고 있다면 더더욱 그렇다. 먼저 웹서버에서 실행하기 + 전에 명령행에서 프로그램을 실행해본다. 예를 들어, 다음과 + 같이 실행한다.</p> + + <div class="example"><p><code> + cd /usr/local/apache2/cgi-bin<br /> + ./first.pl + </code></p></div> + + <p>(<code>perl</code> 인터프리터를 실행하지 마라. 쉘과 + 아파치는 스크립트 첫번째 줄에 있는 <a href="#pathinformation">경로 정보</a>를 사용하여 인터프리터를 + 찾아야 한다.)</p> + + <p>프로그램은 제일 먼저 <code>Content-Type</code>을 포함한 + HTTP 헤더들을 출력하고 빈 줄을 출력해야 한다. 다른 것을 + 출력한다면 웹서버에서 실행할 경우 아파치는 <code>Premature + end of script headers</code>를 반환한다. 자세한 내용은 + 위의 <a href="#writing">CGI 프로그램 작성하기</a>를 참고하라.</p> + + + <h3><a name="errorlogs" id="errorlogs">오류 로그</a></h3> + + + <p>오류 로그는 당신 편이다. 무언가 잘못되면 오류 로그에 + 문구가 생긴다. 오류 로그를 제일 먼저 살펴봐야 한다. 웹사이트를 + 호스팅하는 곳에서 오류 로그를 보지 못하게 한다면, 아마도 + 다른 업체를 알아봐야 한다. 오류 로그를 보는 방법을 익히면, + 대부분의 문제를 빨리 파악하여 해결할 수 있다.</p> + + + <h3><a name="suexec" id="suexec">Suexec</a></h3> + + + <p><a href="../suexec.html">suexec</a> 지원 프로그램을 + 사용하면 어떤 가상호스트 혹은 어떤 사용자 디렉토리에 있는지에 + 따라 CGI 프로그램을 다른 사용자 권한으로 실행할 수 있다. + Suexec는 매우 엄격하게 권한을 검사하며, 검사를 하나라도 + 통과하지 못하면 CGI 프로그램을 실행하지 않고 <code>Premature + end of script headers</code>를 반환한다.</p> + + <p>suexec를 사용하고 있는지 알려면 <code>apachectl -V</code>를 + 실행하여 <code>SUEXEC_BIN</code> 위치를 확인한다. 아파치가 + 시작할때 그 장소에서 suexec 실행파일을 발견하면, suexec를 + 사용할 수 있다.</p> + + <p>suexec를 완전히 이해하지 못했다면 사용해서는 안된다. + suexec를 사용하지 않으려면 <code>SUEXEC_BIN</code> 위치에 + 있는 <code>suexec</code> 실행파일을 지우고 (혹은 파일명을 + 바꾸고) 서버를 재시작하면 된다. <a href="../suexec.html">suexec</a>에 대해 읽은 다음 그래도 + 사용하고 싶다면, <code>suexec -V</code>를 실행하여 suexec + 로그파일 위치를 알아내고 로그파일에서 당신이 어떤 규칙을 + 어기고 있는지 찾는다.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="behindscenes" id="behindscenes">뒤에서는 무슨 일이 벌어지는가?</a></h2> + + + <p>CGI 프로그래밍에 익숙해질수록 뒤에서 벌어지는 일을 이해하면 + 도움이 된다. 구체적으로 브라우저와 서버가 서로 통신하는 + 방법을 말하는 것이다. 몰라도 "Hello, World."를 출력하는 + 프로그램을 작성할 수 있지만 이런 프로그램은 별로 쓸모가 + 없기때문이다.</p> + + <h3><a name="env" id="env">환경변수</a></h3> + + + <p>환경변수는 당신이 컴퓨터를 사용하는 동안 당신 주위를 + 떠다니는 값이다. 환경변수는 path (컴퓨터가 당신이 입력한 + 명령어에 해당하는 실제 파일을 찾는 장소), 사용자명, 터미널 + 종류와 같이 유용한 정보다. 일반적인 환경변수를 모두 보려면 + 명령행 프롬프트에서 <code>env</code>를 입력한다.</p> + + <p>CGI를 실행할때도 서버와 브라우저는 각자의 환경변수를 + 서로 교환한다. 이 정보에는 브라우저 종류 (Netscape, IE, + Lynx), 서버 종류 (아파치, IIS, WebSite), 실행하는 CGI + 프로그램명 등이 있다.</p> + + <p>CGI 프로그래머는 이런 변수들을 사용할 수 있고, + 환경변수는 클라이언트-서버 통신에는 일부분을 차지한다. + 전체 필수 변수 목록은 <a href="http://hoohoo.ncsa.uiuc.edu/cgi/env.html">http://hoohoo.ncsa.uiuc.edu/cgi/env.html</a>에 있다.</p> + + <p>아래 간단한 Perl CGI 프로그램은 자신에게 전달된 모든 + 환경변수를 보여준다. 아파치 배포본의 <code>cgi-bin</code> + 디렉토리에 이와 비슷한 프로그램이 두개 있다. 몇몇 변수는 + 필수이고 나머지는 선택적이다. 그래서 공식 목록에 없는 + 변수도 보인다. 또, 아파치는 기본적으로 제공하는 환경변수 + 외에 여러가지 방법으로 <a href="../env.html">직접 환경변수를 + 추가할 수 있다</a>.</p> + + <div class="example"><p><code> + #!/usr/bin/perl<br /> + print "Content-type: text/html\n\n";<br /> + foreach $key (keys %ENV) {<br /> + <span class="indent"> + print "$key --> $ENV{$key}<br>";<br /> + </span> + } + </code></p></div> + + + <h3><a name="stdin" id="stdin">STDIN과 STDOUT</a></h3> + + + <p>또, 서버와 클라이언트는 표준입력(<code>STDIN</code>)과 + 표준출력(<code>STDOUT</code>)으로 통신한다. 일상적인 경우 + <code>STDIN</code>은 키보드나 프로그램이 처리하는 파일을 + 나타내고, <code>STDOUT</code>은 보통 콘솔이나 화면을 뜻한다.</p> + + <p>CGI 프로그램에게 웹 양식(form)을 <code>POST</code>하면 + 양식에 입력한 자료를 특별한 형식으로 묶어서 CGI 프로그램의 + <code>STDIN</code>으로 전달한다. 그러면 프로그램은 키보드나 + 파일에서 얻은 자료를 처리하듯이 자료를 처리할 수 있다.</p> + + <p>"특별한 형식"은 매우 간단하다. 항목 이름과 값을 등호(=)로 + 연결하고, 항목 이름과 값의 쌍들을 서로 앤퍼샌드(&)로 + 연결한다. 공백, 앰퍼샌드, 등호 같은 부자연스러운 문자는 + 혼동하지 않도록 16진수로 변환한다. 완전한 자료 문자열은 + 다음과 같이 생겼다.</p> + + <div class="example"><p><code> + name=Rich%20Bowen&city=Lexington&state=KY&sidekick=Squirrel%20Monkey + </code></p></div> + + <p>종종 URL 뒤에서 이런 문자열을 보게 된다. 이 경우 서버는 + 문자열을 <code>QUERY_STRING</code>이라는 환경변수에 저장한다. + 이를 <code>GET</code> 요청이라고 한다. <code>FORM</code> + 태그의 <code>METHOD</code> 속성을 지정하여 HTML 양식(form)이 + 자료를 <code>GET</code>할지 <code>POST</code>할지 결정한다.</p> + + <p>이제 프로그램은 이런 문자열을 유용한 정보로 쪼개야 + 한다. 다행히도 이런 자료 처리를 돕고 CGI 프로그램의 다른 + 여러 면을 살피는 라이브러리와 모듈들이 있다.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="libraries" id="libraries">CGI 모듈/라이브러리</a></h2> + + + <p>CGI 프로그램을 작성할때 지루한 작업을 대신해주는 코드 + 라이브러리 혹은 모듈을 사용할지 고려해봐야 한다. 이런 것을 + 사용하면 버그가 줄고 더 빨리 프로그램을 개발할 수 있다.</p> + + <p>Perl로 CGI 프로그램을 작성한다면 <a href="http://www.cpan.org/">CPAN</a>에서 관련 모듈들을 찾을 + 수 있다. CGI 개발에 가장 널리 사용되는 모듈은 + <code>CGI.pm</code>이다. 대부분의 프로그램에 충분한 최소 + 기능을 구현한 <code>CGI::Lite</code>도 고려해 볼 수 있다.</p> + + <p>C로 CGI 프로그램을 작성한다면 선택의 여지가 많다. 이중 + 하나가 <a href="http://www.boutell.com/cgic/">http://www.boutell.com/cgic/</a>에 + 있는 <code>CGIC</code> 라이브러리다.</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="moreinfo" id="moreinfo">더 많은 정보...</a></h2> + + + <p>웹에 매우 많은 CGI 정보가 있다. 뉴스그룹 <a href="news:comp.infosystems.www.authoring.cgi">comp.infosystems.www.authoring.cgi</a>에서 여러 사람들과 + CGI 문제를 논의할 수 있다. HTML Writers Guild의 -servers + 메일링리스트는 질문에 대한 답을 찾기에 훌륭한 장소다. <a href="http://www.hwg.org/lists/hwg-servers/">http://www.hwg.org/lists/hwg-servers/</a>에서 더 많은 것을 + 알 수 있다.</p> + + <p>그리고 물론 CGI 프로그램 동작에 대한 모든 내용을 설명한 + CGI 규약을 읽어야 할지도 모른다. <a href="http://hoohoo.ncsa.uiuc.edu/cgi/interface.html">NCSA</a>에 + 원본 문서가 있고, 수정한 초안은 <a href="http://web.golux.com/coar/cgi/">Common Gateway Interface + RFC 프로젝트</a>에 있다.</p> + + <p>메일링리스트나 뉴스그룹에 현재 격고 있는 CGI 문제에 대해 + 질문할때는 발생한 현상과 원래 기대한 결과, 실제로 발생한 + 현상이 어떻게 다른지, 사용하는 서버, CGI 프로그램을 작성한 + 언어, 가능하면 해당 코드를 자세히 적어라. 그러면 해결책을 + 찾기 쉬워진다.</p> + + <p>아파치 소스코드가 잘못되었다고 확신하지 않는 한 CGI 질문을 + 아파치 버그 데이터베이스에 올리면 <strong>절대로</strong> + 안된다.</p> + </div></div> +<div class="bottomlang"> +<p><span>가능한 언어: </span><a href="../en/howto/cgi.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../ja/howto/cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/cgi.html" title="Korean"> ko </a></p> +</div><div id="footer"> +<p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/howto/cgi.xml.ko b/docs/manual/howto/cgi.xml.ko new file mode 100644 index 0000000000..07b1fed16d --- /dev/null +++ b/docs/manual/howto/cgi.xml.ko @@ -0,0 +1,518 @@ +<?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.12 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed 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. +--> + +<manualpage metafile="cgi.xml.meta"> + <parentdocument href="./">How-To / Tutorials</parentdocument> + + <title>아파치 투토리얼: CGI를 사용한 동적 페이지 생성</title> + + <section id="intro"> + <title>소개</title> + + <related> + <modulelist> + <module>mod_alias</module> + <module>mod_cgi</module> + </modulelist> + + <directivelist> + <directive module="mod_mime">AddHandler</directive> + <directive module="core">Options</directive> + <directive module="mod_alias">ScriptAlias</directive> + </directivelist> + </related> + + <p>CGI (Common Gateway Interface)는 웹서버가 보통 CGI 프로그램 + 혹은 CGI 스크립트라고 부르는, (웹페이지 내용을 만드는) 외부 + 프로그램과 통신하는 방법을 정의한다. 웹사이트에서 동적인 + 페이지를 만드는 가장 흔하고 간단한 방법이다. 이 문서는 아파치 + 웹서버에 CGI를 구성하는 방법을 소개하고, CGI 프로그램을 + 작성해본다.</p> + </section> + + <section id="configuring"> + <title>CGI를 허용하도록 아파치 설정하기</title> + + <p>CGI 프로그램이 올바로 동작하려면 CGI 실행이 가능하도록 + 아파치를 설정해야 한다. 설정하는 방법은 여러가지다.</p> + + <section id="scriptalias"> + <title>ScriptAlias</title> + + <p><directive module="mod_alias">ScriptAlias</directive> + 지시어를 사용하면 아파치는 특정 디렉토리를 CGI 프로그램용으로 + 둔다. 아파치는 이 디렉토리에 있는 모든 파일이 CGI + 프로그램이라고 가정하여 클라이언트가 자원을 요청하면 자원을 + 실행하려고 시도한다.</p> + + <p><directive module="mod_alias">ScriptAlias</directive> + 지시어는 다음과 같이 사용한다.</p> + + <example> + ScriptAlias /cgi-bin/ /usr/local/apache2/cgi-bin/ + </example> + + <p>위 예제는 아파치를 기본 장소에 설치한 경우 + <code>httpd.conf</code> 설정파일에 있는 내용이다. <directive + module="mod_alias">ScriptAlias</directive> 지시어는 <directive + module="mod_alias">Alias</directive> 지시어와 같이 URL + 앞부분을 특정 디렉토리로 대응한다. + <directive>Alias</directive>와 + <directive>ScriptAlias</directive>는 보통 <directive + module="core">DocumentRoot</directive> 디렉토리 밖에 있는 + 디렉토리에 사용한다. <directive>Alias</directive>와 + <directive>ScriptAlias</directive>의 차이점은 + <directive>ScriptAlias</directive>가 추가로 URL 앞부분으로 + 시작하는 모든 파일을 CGI 프로그램으로 취급하는 점이다. + 그래서 위의 설정은 아파치에게 <code>/cgi-bin/</code>으로 + 시작하는 자원을 요청하면 + <code>/usr/local/apache2/cgi-bin/</code> 디렉토리에서 + 찾아서 CGI 프로그램으로 처리하라고 알린다.</p> + + <p>예를 들어, URL + <code>http://www.example.com/cgi-bin/test.pl</code>을 + 요청하면 아파치는 + <code>/usr/local/apache2/cgi-bin/test.pl</code> 파일을 + 실행하여 결과를 반환한다. 물론 파일이 존재하고 실행가능하며 + 어떤 방법으로든 출력을 해야 한다. 그렇지 않으면 아파치는 + 오류문을 보낸다.</p> + </section> + + <section id="nonscriptalias"> + <title>ScriptAlias 디렉토리 밖에 있는 CGI</title> + + <p>보통 보안상 이유때문에 CGI 프로그램은 <directive + module="mod_alias">ScriptAlias</directive>한 디렉토리에 + 한정한다. 그래서 관리자는 누가 CGI 프로그램을 사용할 수 + 있는지 엄격히 감독할 수 있다. 그러나 적당한 보안조치를 + 취했다면 아무 디렉토리에서나 CGI 프로그램을 실행하지 않을 + 이유가 없다. 예를 들어, <directive + module="mod_userdir">UserDir</directive> 지시어를 사용하여 + 사용자가 자신의 홈디렉토리에 웹페이지를 가지는 경우를 + 가정하자. 사용자가 자신의 CGI 프로그램을 사용하고 싶은데 + <code>cgi-bin</code> 디렉토리에 접근권한이 없다면, 다른 + 곳에서라도 CGI 프로그램을 실행하고 싶을 것이다.</p> + + <p>아무 디렉토리에서나 CGI 실행을 허용하려면 두 과정이 + 필요하다. 먼저, <directive + module="mod_mime">AddHandler</directive>나 <directive + module="core">SetHandler</directive> 지시어를 사용하여 + <code>cgi-script</code> 핸들러를 작동해야 한다. 두번째로, + <directive module="core">Options</directive> 지시어에 + <code>ExecCGI</code>를 지정해야 한다.</p> + </section> + + <section id="options"> + <title>Options를 사용하여 명시적으로 CGI 실행을 허용하기</title> + + <p>서버의 주설정파일에 직접 <directive + module="core">Options</directive> 지시어를 사용하여 특정 + 디렉토리에서 CGI 실행을 허용할 수 있다.</p> + + <example> + <Directory /usr/local/apache2/htdocs/somedir><br /> + <indent> + Options +ExecCGI<br /> + </indent> + </Directory> + </example> + + <p>위 지시어로 아파치는 CGI 파일의 실행을 허용한다. 어떤 + 파일이 CGI 파일인지도 서버에게 알려야 한다. 다음 <directive + module="mod_mime">AddHandler</directive> 지시어는 서버에게 + 확장자가 <code>cgi</code>나 <code>pl</code>인 파일은 모두 + CGI 프로그램이라고 알린다.</p> + + <example> + AddHandler cgi-script .cgi .pl + </example> + </section> + + <section id="htaccess"> + <title>.htaccess 파일</title> + + <p><a href="htaccess.html"><code>.htaccess</code> 투토리얼</a>은 + <code>httpd.conf</code>에 접근권한이 없는 경우에 CGI 프로그램을 + 사용할 수 있는 방법을 알려준다.</p> + </section> + + <section id="userdir"> + <title>사용자 디렉토리</title> + + <p>아래 설정을 사용하면 사용자 디렉토리에서 <code>.cgi</code>로 + 끝나는 파일을 CGI 프로그램으로 실행한다.</p> + + <example> + <Directory /home/*/public_html><br/> + <indent> + Options +ExecCGI<br/> + AddHandler cgi-script .cgi<br/> + </indent> + </Directory> + </example> + + <p>다음을 사용하면 사용자 디렉토리의 <code>cgi-bin</code> + 하위디렉토리에 있는 모든 파일을 CGI 프로그램으로 인식한다.</p> + + <example> + <Directory /home/*/public_html/cgi-bin><br/> + <indent> + Options ExecCGI<br/> + SetHandler cgi-script<br/> + </indent> + </Directory> + </example> + + </section> + + </section> + + <section id="writing"> + <title>CGI 프로그램 작성하기</title> + + <p>``일반적인'' 프로그래밍과 CGI 프로그래밍 사이에는 두가지 + 주된 차이점이 있다.</p> + + <p>첫번째 차이는 CGI 프로그램은 다른 출력을 하기전에 먼저 + MIME-type 헤더를 출력해야 한다는 점이다. HTTP 헤더는 + 클라이언트에게 클라이언트가 어떤 내용을 받게될지 미리 알린다. + 보통 다음과 같다.</p> + + <example> + Content-type: text/html + </example> + + <p>두번째 차이는 HTML 혹은 브라우저가 보여줄 수 있는 형식으로 + 출력해야 한다는 점이다. 대부분의 경우 HTML을 출력하지만, + 때때로 gif 그림과 같이 HTML이 아닌 내용을 출력하는 CGI + 프로그램을 작성하는 경우도 있다.</p> + + <p>두가지를 제외하고는 CGI 프로그램 작성은 이미 만들어 보았을 + 다른 프로그램들과 매우 비슷하다.</p> + + <section id="firstcgi"> + <title>처음으로 만든 CGI 프로그램</title> + + <p>다음은 브라우저에 한 줄을 찍는 CGI 프로그램 예제다. + 그대로 <code>first.pl</code>이라는 파일에 저장하고, + <code>cgi-bin</code> 디렉토리에 복사한다.</p> + + <example> + #!/usr/bin/perl<br /> + print "Content-type: text/html\n\n";<br /> + print "Hello, World."; + </example> + + <p>Perl에 익숙하지 않더라도 무슨 일이 일어나는지 알 수 + 있다. 첫번째 줄은 아파치(혹은 사용하는 쉘)에게 + <code>/usr/bin/perl</code> 위치에 있는 인터프리터을 사용하여 + 이 프로그램 파일을 실행하라고 알린다. 두번째 줄은 방금 + 말한 content-type 선언을 출력하고 carriage-return 줄바꿈을 + 두번 출력한다. 그러면 헤더 뒤에 HTTP 헤더의 끝을 뜻하는 + 빈줄이 생기고, 본문이 시작한다. 세번째 줄은 "Hello, World." + 문자열을 출력한다. 이것으로 끝이다.</p> + + <p>브라우저를 실행하고 주소를 입력한다</p> + + <example> + http://www.example.com/cgi-bin/first.pl + </example> + + <p>파일 장소를 입력하면, 브라우저창에 <code>Hello, World.</code> + 한 줄이 보인다. 흥분되지는 않지만, 한번 동작하는 것을 + 보았으니 이제 다른 것을 시도해 볼 수 있다.</p> + </section> + </section> + + <section id="troubleshoot"> + <title>그러나 아직 동작하지 않아요!</title> + + <p>웹에서 CGI 프로그램에 접근할때 브라우저에 나올 수 있는 + 내용은 기본적으로 네가지다.</p> + + <dl> + <dt>CGI 프로그램의 출력</dt> + <dd>좋다! 모든 것이 잘 동작한다는 뜻이다. 출력은 정확하지만 + 브라우저가 올바로 처리하지 못한다면, CGI 프로그램에서 + 올바른 <code>Content-Type</code>을 설정하였는지 확인한다.</dd> + + <dt>CGI 프로그램 소스코드 혹은 "POST Method Not Allowed" + 문구</dt> + <dd>CGI 프로그램을 실행하도록 아파치를 적절히 설정하지 + 않았다는 뜻이다. <a href="#configuring">아파치 설정하기</a> + 절을 다시 읽고 빼먹은 부분이 있는지 찾아봐라.</dd> + + <dt>"Forbidden"으로 시작하는 문구</dt> + <dd>권한 문제가 있다는 뜻이다. <a href="#errorlogs">아파치 + 오류 로그</a>와 아래 <a href="#permissions">파일권한</a> + 절을 확인하라.</dd> + + <dt>"Internal Server Error"라는 문구</dt> + <dd><a href="#errorlogs">아파치 오류 로그</a>를 보면 아마도 + CGI 프로그램이 출력한 오류문과 함께 "Premature end of + script headers"가 보일 것이다. 이 경우 아래 내용들을 하나씩 + 확인하여 어떤 이유로 CGI 프로그램이 적절한 HTTP 헤더를 + 출력하지 못했는지 알아본다.</dd> + </dl> + + <section id="permissions"> + <title>파일권한</title> + + <p>서버는 당신과 동일한 계정으로 동작하지 않음을 명심하라. + 즉, 서버가 시작하면 서버는 비특권 사용자 권한(보통 + <code>nobody</code>나 <code>www</code>)으로 동작한다. + 그래서 당신이 소유한 파일을 실행하려면 권한이 필요하다. + 파일에 <code>nobody</code>가 실행하기에 충분한 권한을 + 주기위해 보통 모두에게 파일의 실행 권한을 준다.</p> + + <example> + chmod a+x first.pl + </example> + + <p>또, 프로그램이 다른 파일을 읽거나 쓴다면 이 파일에도 + 적절한 권한이 필요하다.</p> + + </section> + + <section id="pathinformation"> + <title>경로 정보와 환경</title> + + <p>명령행에서 프로그램을 실행하면 자동으로 어떤 정보가 + 쉘로 전달된다. 예를 들어, <code>PATH</code>는 쉘에게 당신이 + 말한 파일을 찾을 장소를 알려준다.</p> + + <p>웹서버가 프로그램을 CGI 프로그램으로 실행할때는 + <code>PATH</code>가 다를 수 있다. (예를 들어, + <code>sendmail</code> 같이) CGI 프로그램 안에서 실행하는 + 명령어는 완전한 경로로 명시해야 쉘이 명령어를 찾을 수 + 있다.</p> + + <p>경로 문제는 다음과 같이 CGI 프로그램 첫번째 줄에 나오는 + 스크립트 인터프리터 (보통 <code>perl</code>) 경로에서 + 자주 발생한다.</p> + + <example> + #!/usr/bin/perl + </example> + + <p>실제로 인터프리터의 경로인지 확인한다.</p> + + <p>또, CGI 프로그램이 다른 <a href="#env">환경변수</a>를 + 사용한다면 아파치가 이 변수들을 프로그램에게 전달해야 + 한다.</p> + + </section> + + <section id="syntaxerrors"> + <title>프로그램 오류</title> + + <p>CGI 프로그램이 실패하는 경우 대부분 프로그램 자체 + 문제때문이다. 특히 위의 두가지 실수를 하지 않았고 이 글을 + 계속 보고 있다면 더더욱 그렇다. 먼저 웹서버에서 실행하기 + 전에 명령행에서 프로그램을 실행해본다. 예를 들어, 다음과 + 같이 실행한다.</p> + + <example> + cd /usr/local/apache2/cgi-bin<br/> + ./first.pl + </example> + + <p>(<code>perl</code> 인터프리터를 실행하지 마라. 쉘과 + 아파치는 스크립트 첫번째 줄에 있는 <a + href="#pathinformation">경로 정보</a>를 사용하여 인터프리터를 + 찾아야 한다.)</p> + + <p>프로그램은 제일 먼저 <code>Content-Type</code>을 포함한 + HTTP 헤더들을 출력하고 빈 줄을 출력해야 한다. 다른 것을 + 출력한다면 웹서버에서 실행할 경우 아파치는 <code>Premature + end of script headers</code>를 반환한다. 자세한 내용은 + 위의 <a href="#writing">CGI 프로그램 작성하기</a>를 참고하라.</p> + </section> + + <section id="errorlogs"> + <title>오류 로그</title> + + <p>오류 로그는 당신 편이다. 무언가 잘못되면 오류 로그에 + 문구가 생긴다. 오류 로그를 제일 먼저 살펴봐야 한다. 웹사이트를 + 호스팅하는 곳에서 오류 로그를 보지 못하게 한다면, 아마도 + 다른 업체를 알아봐야 한다. 오류 로그를 보는 방법을 익히면, + 대부분의 문제를 빨리 파악하여 해결할 수 있다.</p> + </section> + + <section id="suexec"> + <title>Suexec</title> + + <p><a href="../suexec.html">suexec</a> 지원 프로그램을 + 사용하면 어떤 가상호스트 혹은 어떤 사용자 디렉토리에 있는지에 + 따라 CGI 프로그램을 다른 사용자 권한으로 실행할 수 있다. + Suexec는 매우 엄격하게 권한을 검사하며, 검사를 하나라도 + 통과하지 못하면 CGI 프로그램을 실행하지 않고 <code>Premature + end of script headers</code>를 반환한다.</p> + + <p>suexec를 사용하고 있는지 알려면 <code>apachectl -V</code>를 + 실행하여 <code>SUEXEC_BIN</code> 위치를 확인한다. 아파치가 + 시작할때 그 장소에서 suexec 실행파일을 발견하면, suexec를 + 사용할 수 있다.</p> + + <p>suexec를 완전히 이해하지 못했다면 사용해서는 안된다. + suexec를 사용하지 않으려면 <code>SUEXEC_BIN</code> 위치에 + 있는 <code>suexec</code> 실행파일을 지우고 (혹은 파일명을 + 바꾸고) 서버를 재시작하면 된다. <a + href="../suexec.html">suexec</a>에 대해 읽은 다음 그래도 + 사용하고 싶다면, <code>suexec -V</code>를 실행하여 suexec + 로그파일 위치를 알아내고 로그파일에서 당신이 어떤 규칙을 + 어기고 있는지 찾는다.</p> + </section> + </section> + + <section id="behindscenes"> + <title>뒤에서는 무슨 일이 벌어지는가?</title> + + <p>CGI 프로그래밍에 익숙해질수록 뒤에서 벌어지는 일을 이해하면 + 도움이 된다. 구체적으로 브라우저와 서버가 서로 통신하는 + 방법을 말하는 것이다. 몰라도 "Hello, World."를 출력하는 + 프로그램을 작성할 수 있지만 이런 프로그램은 별로 쓸모가 + 없기때문이다.</p> + + <section id="env"> + <title>환경변수</title> + + <p>환경변수는 당신이 컴퓨터를 사용하는 동안 당신 주위를 + 떠다니는 값이다. 환경변수는 path (컴퓨터가 당신이 입력한 + 명령어에 해당하는 실제 파일을 찾는 장소), 사용자명, 터미널 + 종류와 같이 유용한 정보다. 일반적인 환경변수를 모두 보려면 + 명령행 프롬프트에서 <code>env</code>를 입력한다.</p> + + <p>CGI를 실행할때도 서버와 브라우저는 각자의 환경변수를 + 서로 교환한다. 이 정보에는 브라우저 종류 (Netscape, IE, + Lynx), 서버 종류 (아파치, IIS, WebSite), 실행하는 CGI + 프로그램명 등이 있다.</p> + + <p>CGI 프로그래머는 이런 변수들을 사용할 수 있고, + 환경변수는 클라이언트-서버 통신에는 일부분을 차지한다. + 전체 필수 변수 목록은 <a + href="http://hoohoo.ncsa.uiuc.edu/cgi/env.html" + >http://hoohoo.ncsa.uiuc.edu/cgi/env.html</a>에 있다.</p> + + <p>아래 간단한 Perl CGI 프로그램은 자신에게 전달된 모든 + 환경변수를 보여준다. 아파치 배포본의 <code>cgi-bin</code> + 디렉토리에 이와 비슷한 프로그램이 두개 있다. 몇몇 변수는 + 필수이고 나머지는 선택적이다. 그래서 공식 목록에 없는 + 변수도 보인다. 또, 아파치는 기본적으로 제공하는 환경변수 + 외에 여러가지 방법으로 <a href="../env.html">직접 환경변수를 + 추가할 수 있다</a>.</p> + + <example> + #!/usr/bin/perl<br /> + print "Content-type: text/html\n\n";<br /> + foreach $key (keys %ENV) {<br /> + <indent> + print "$key --> $ENV{$key}<br>";<br /> + </indent> + } + </example> + </section> + + <section id="stdin"> + <title>STDIN과 STDOUT</title> + + <p>또, 서버와 클라이언트는 표준입력(<code>STDIN</code>)과 + 표준출력(<code>STDOUT</code>)으로 통신한다. 일상적인 경우 + <code>STDIN</code>은 키보드나 프로그램이 처리하는 파일을 + 나타내고, <code>STDOUT</code>은 보통 콘솔이나 화면을 뜻한다.</p> + + <p>CGI 프로그램에게 웹 양식(form)을 <code>POST</code>하면 + 양식에 입력한 자료를 특별한 형식으로 묶어서 CGI 프로그램의 + <code>STDIN</code>으로 전달한다. 그러면 프로그램은 키보드나 + 파일에서 얻은 자료를 처리하듯이 자료를 처리할 수 있다.</p> + + <p>"특별한 형식"은 매우 간단하다. 항목 이름과 값을 등호(=)로 + 연결하고, 항목 이름과 값의 쌍들을 서로 앤퍼샌드(&)로 + 연결한다. 공백, 앰퍼샌드, 등호 같은 부자연스러운 문자는 + 혼동하지 않도록 16진수로 변환한다. 완전한 자료 문자열은 + 다음과 같이 생겼다.</p> + + <example> + name=Rich%20Bowen&city=Lexington&state=KY&sidekick=Squirrel%20Monkey + </example> + + <p>종종 URL 뒤에서 이런 문자열을 보게 된다. 이 경우 서버는 + 문자열을 <code>QUERY_STRING</code>이라는 환경변수에 저장한다. + 이를 <code>GET</code> 요청이라고 한다. <code>FORM</code> + 태그의 <code>METHOD</code> 속성을 지정하여 HTML 양식(form)이 + 자료를 <code>GET</code>할지 <code>POST</code>할지 결정한다.</p> + + <p>이제 프로그램은 이런 문자열을 유용한 정보로 쪼개야 + 한다. 다행히도 이런 자료 처리를 돕고 CGI 프로그램의 다른 + 여러 면을 살피는 라이브러리와 모듈들이 있다.</p> + </section> + </section> + + <section id="libraries"> + <title>CGI 모듈/라이브러리</title> + + <p>CGI 프로그램을 작성할때 지루한 작업을 대신해주는 코드 + 라이브러리 혹은 모듈을 사용할지 고려해봐야 한다. 이런 것을 + 사용하면 버그가 줄고 더 빨리 프로그램을 개발할 수 있다.</p> + + <p>Perl로 CGI 프로그램을 작성한다면 <a + href="http://www.cpan.org/">CPAN</a>에서 관련 모듈들을 찾을 + 수 있다. CGI 개발에 가장 널리 사용되는 모듈은 + <code>CGI.pm</code>이다. 대부분의 프로그램에 충분한 최소 + 기능을 구현한 <code>CGI::Lite</code>도 고려해 볼 수 있다.</p> + + <p>C로 CGI 프로그램을 작성한다면 선택의 여지가 많다. 이중 + 하나가 <a + href="http://www.boutell.com/cgic/">http://www.boutell.com/cgic/</a>에 + 있는 <code>CGIC</code> 라이브러리다.</p> + </section> + + <section id="moreinfo"> + <title>더 많은 정보...</title> + + <p>웹에 매우 많은 CGI 정보가 있다. 뉴스그룹 <a + href="news:comp.infosystems.www.authoring.cgi" + >comp.infosystems.www.authoring.cgi</a>에서 여러 사람들과 + CGI 문제를 논의할 수 있다. HTML Writers Guild의 -servers + 메일링리스트는 질문에 대한 답을 찾기에 훌륭한 장소다. <a + href="http://www.hwg.org/lists/hwg-servers/" + >http://www.hwg.org/lists/hwg-servers/</a>에서 더 많은 것을 + 알 수 있다.</p> + + <p>그리고 물론 CGI 프로그램 동작에 대한 모든 내용을 설명한 + CGI 규약을 읽어야 할지도 모른다. <a + href="http://hoohoo.ncsa.uiuc.edu/cgi/interface.html">NCSA</a>에 + 원본 문서가 있고, 수정한 초안은 <a + href="http://web.golux.com/coar/cgi/">Common Gateway Interface + RFC 프로젝트</a>에 있다.</p> + + <p>메일링리스트나 뉴스그룹에 현재 격고 있는 CGI 문제에 대해 + 질문할때는 발생한 현상과 원래 기대한 결과, 실제로 발생한 + 현상이 어떻게 다른지, 사용하는 서버, CGI 프로그램을 작성한 + 언어, 가능하면 해당 코드를 자세히 적어라. 그러면 해결책을 + 찾기 쉬워진다.</p> + + <p>아파치 소스코드가 잘못되었다고 확신하지 않는 한 CGI 질문을 + 아파치 버그 데이터베이스에 올리면 <strong>절대로</strong> + 안된다.</p> + </section> +</manualpage> + diff --git a/docs/manual/howto/cgi.xml.meta b/docs/manual/howto/cgi.xml.meta index ee3c3b54a4..b941092d76 100644 --- a/docs/manual/howto/cgi.xml.meta +++ b/docs/manual/howto/cgi.xml.meta @@ -8,5 +8,6 @@ <variants> <variant>en</variant> <variant>ja</variant> + <variant>ko</variant> </variants> </metafile> diff --git a/docs/manual/howto/htaccess.html b/docs/manual/howto/htaccess.html index 356457a8f6..9c9fe2f646 100755 --- a/docs/manual/howto/htaccess.html +++ b/docs/manual/howto/htaccess.html @@ -5,3 +5,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: htaccess.html.ja.jis Content-Language: ja Content-type: text/html; charset=ISO-2022-JP + +URI: htaccess.html.ko.euc-kr +Content-Language: ko +Content-type: text/html; charset=EUC-KR diff --git a/docs/manual/howto/htaccess.html.en b/docs/manual/howto/htaccess.html.en index e61b85e774..c56c1eb09e 100644 --- a/docs/manual/howto/htaccess.html.en +++ b/docs/manual/howto/htaccess.html.en @@ -19,7 +19,8 @@ <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.1</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>Apache Tutorial: .htaccess files</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/howto/htaccess.html" title="English"> en </a> | -<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> +<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> <p><code>.htaccess</code> files provide a way to make configuration @@ -346,7 +347,8 @@ changes on a per-directory basis.</p> </div></div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/howto/htaccess.html" title="English"> en </a> | -<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> +<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> <p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> diff --git a/docs/manual/howto/htaccess.html.ja.jis b/docs/manual/howto/htaccess.html.ja.jis index c581d0922d..7a576ba1f9 100644 --- a/docs/manual/howto/htaccess.html.ja.jis +++ b/docs/manual/howto/htaccess.html.ja.jis @@ -19,7 +19,8 @@ <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP $B%5!<%P(B</a> > <a href="http://httpd.apache.org/docs-project/">$B%I%-%e%a%s%F!<%7%g%s(B</a> > <a href="../">$B%P!<%8%g%s(B 2.1</a> > <a href="./">How-To / $B%A%e!<%H%j%"%k(B</a></div><div id="page-content"><div id="preamble"><h1>Apache $B%A%e!<%H%j%"%k(B: .htaccess $B%U%!%$%k(B</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../ja/howto/htaccess.html" title="Japanese"> ja </a></p> +<a href="../ja/howto/htaccess.html" title="Japanese"> ja </a> | +<a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> <p><code>.htaccess</code> $B%U%!%$%k$O%G%#%l%/%H%jKh$K@_Dj$rJQ99$9$kJ}K!$r(B @@ -332,7 +333,8 @@ </div></div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../ja/howto/htaccess.html" title="Japanese"> ja </a></p> +<a href="../ja/howto/htaccess.html" title="Japanese"> ja </a> | +<a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> <p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">$B%b%8%e!<%k(B</a> | <a href="../mod/directives.html">$B%G%#%l%/%F%#%V(B</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">$BMQ(B$B8l(B</a> | <a href="../sitemap.html">$B%5%$%H%^%C%W(B</a></p></div> diff --git a/docs/manual/howto/htaccess.html.ko.euc-kr b/docs/manual/howto/htaccess.html.ko.euc-kr new file mode 100644 index 0000000000..914ca03cea --- /dev/null +++ b/docs/manual/howto/htaccess.html.ko.euc-kr @@ -0,0 +1,329 @@ +<?xml version="1.0" encoding="EUC-KR"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="ko" xml:lang="ko"><head><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>아파치 투토리얼: .htaccess 파일 - Apache HTTP Server</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /> +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p> +<p class="apache">Apache HTTP Server Version 2.1</p> +<img alt="" src="../images/feather.gif" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.1</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>아파치 투토리얼: .htaccess 파일</h1> +<div class="toplang"> +<p><span>가능한 언어: </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/htaccess.html" title="Korean"> ko </a></p> +</div> + +<p><code>.htaccess</code> 파일을 사용하여 디렉토리별로 설정을 +변경할 수 있다.</p> +</div> +<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">.htaccess 파일</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#what">무엇이며/어떻게 사용하는가</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#when">언제 .htaccess 파일을 사용하나 + (혹은 사용하지 않나)</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#how">어떻게 지시어를 적용하나</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#auth">인증 예제</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#ssi">Server Side Includes 예제</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#cgi">CGI 예제</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">문제해결</a></li> +</ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="related" id="related">.htaccess 파일</a></h2> + <table class="related"><tr><th>관련된 모듈</th><th>관련된 지시어</th></tr><tr><td><ul><li><code class="module"><a href="../mod/core.html">core</a></code></li><li><code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code></li><li><code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code></li><li><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="../mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code></li><li><code class="directive"><a href="../mod/core.html#authtype">AuthType</a></code></li><li><code class="directive"><a href="../mod/core.html#authname">AuthName</a></code></li><li><code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code></li><li><code class="directive"><a href="../mod/core.html#require">Require</a></code></li></ul></td></tr></table> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="what" id="what">무엇이며/어떻게 사용하는가</a></h2> + + + <p><code>.htaccess</code> 파일(혹은 "분산 설정파일")을 + 사용하면 디렉토리별로 설정을 변경할 수 있다. 여러 설정 지시어가 + 있는 파일을 특정 문서 디렉토리에 두면, 그 디렉토리와 모든 + 하위디렉토리에 지시어를 적용한다.</p> + + <div class="note"><h3>주의:</h3> + <p><code>.htaccess</code> 파일명을 다르게 사용하고 싶다면, + <code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code> 지시어를 + 사용하여 변경할 수 있다. 예를 들어, <code>.config</code> + 파일명을 사용하려면 서버 설정파일에 다음과 같이 추가한다.</p> + + <div class="example"><p><code> + AccessFileName .config + </code></p></div> + </div> + + <p>일반적으로 <code>.htaccess</code> 파일은 <a href="../configuring.html#syntax">주설정파일</a>과 문법이 + 같다. <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> + 지시어가 이 파일에 나올 수 있는 내용을 결정한다. 이 지시어는 + <code>.htaccess</code> 파일에서 허용하는 지시어 분류를 지정한다. + 지시어를 <code>.htaccess</code> 파일에서 사용할 수 있다면, + 해당 지시어 문서의 Override 항목은 지시어를 허용하기위해 + <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>에 사용할 + 값을 알려준다.</p> + + <p>예를 들어, <code class="directive"><a href="../mod/core.html#adddefaultcharset">AddDefaultCharset</a></code> + 지시어 문서를 보면 이 지시어를 <code>.htaccess</code> 파일에서 + 사용할 수 있다. (지시어 요약에서 사용장소 항목을 보라.) + <a href="../mod/directive-dict.html#Context">Override</a> + 줄에 <code>FileInfo</code>가 있다. 그래서 이 지시어를 + <code>.htaccess</code> 파일에서 사용하기위해서는 최소한 + <code>AllowOverride FileInfo</code>가 필요하다.</p> + + <div class="example"><h3>예제:</h3><table> + <tr> + <td><a href="../mod/directive-dict.html#Context">사용장소:</a></td> + <td>주서버설정, 가상호스트, directory, .htaccess</td> + </tr> + + <tr> + <td><a href="../mod/directive-dict.html#Override">Override:</a></td> + <td>FileInfo</td> + </tr> + </table></div> + + <p>특정 지시어를 <code>.htaccess</code> 파일에서 사용할 + 수 있는지 궁금하면 지시어 문서의 사용장소 항목에 ".htaccess"가 + 있는지 확인한다.</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="when" id="when">언제 .htaccess 파일을 사용하나 + (혹은 사용하지 않나)</a></h2> + + <p>일반적으로 주서버파일에 접근할 수 없는 경우가 아니라면 + <code>.htaccess</code> 파일을 사용하면 안된다. 예를 들어, + 사용자 인증이 항상 <code>.htaccess</code> 파일에 있어야 + 한다는 것은 잘못 알려진 오해다. 이는 사실이 아니다. 주서버설정에 + 사용자 인증 설정을 적을 수 있고, 사실 이러길 권한다.</p> + + <p><code>.htaccess</code> 파일은 컨텐츠 제공자가 디렉토리별로 + 서버 설정을 다르게하고 싶지만 서버 시스템에 root 권한이 + 없는 경우에 사용한다. 서버 관리자가 설정을 자주 변경하고 + 싶지 않은 경우 일반 사용자가 직접 <code>.htaccess</code> + 파일을 수정하도록 허용하는 것이 바람직하다. 예를 들어, 한 + 컴퓨터에 여러 사용자 사이트를 서비스하는 ISP에서 사용자가 + 자신의 설정을 변경하고 싶은 경우가 그러하다.</p> + + <p>그러나 일반적으로 <code>.htaccess</code> 파일은 가급적 + 피해야 한다. <code>.htaccess</code> 파일에서 허용하는 지시어는 + 주설정파일의 <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> 섹션과 같은 효과가 + 있다.</p> + + <p>다음 두가지 큰 이유때문에 <code>.htaccess</code> 파일 + 사용을 피해야 한다.</p> + + <p>첫번째는 성능이다. <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>가 <code>.htaccess</code> + 파일을 사용하도록 허용하면, 아파치는 디렉토리마다 + <code>.htaccess</code> 파일을 찾는다. 그래서 + <code>.htaccess</code> 파일을 허용하면 실제로 파일을 사용하지 + 않는 경우에도 성능이 떨어진다! 또, <code>.htaccess</code> + 파일은 문서를 요청할때마다 읽어들인다.</p> + + <p>게다가 적용해야 하는 전체 지시어를 모으기위해 아파치는 + 모든 상위 디렉토리에서 <code>.htaccess</code> 파일을 찾는다. + (<a href="#how">어떻게 지시어를 적용하나</a> 절을 참고.) + 그래서 <code>/www/htdocs/example</code> 디렉토리에 있는 + 파일을 요청하면, 아파치는 다음 파일들을 찾아야 한다.</p> + + <div class="example"><p><code> + /.htaccess<br /> + /www/.htaccess<br /> + /www/htdocs/.htaccess<br /> + /www/htdocs/example/.htaccess + </code></p></div> + + <p>그래서 그 디렉토리에 있는 파일을 접근할 때마다 설정파일이 + 전혀 없어도 파일시스템을 4번 더 접근해야 한다. + (<code>/</code>에서도 <code>.htaccess</code> 파일을 허용한 + 경우를 말한다. 보통은 허용하지 않는다.)</p> + + <p>두번째 이유는 보안이다. 사용자에게 서버설정 변경 권한을 + 주면 당신이 감당할 수 없는 변화가 일어날 수 있다. 사용자에게 + 이런 권한을 줄지 곰곰이 생각하라. 또, 사용자가 원하는 것보다 + 적은 권한을 주면 기술지원요청이 들어온다. 사용자에게 가능한 + 권한 수준을 명확히 알려라. 사용자에게 <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>를 어떻게 설정하였는지 + 정확히 알리고 관련 문서를 제공하면 앞으로 혼란을 피할 수 + 있다.</p> + + <p>지시어를 <code>/www/htdocs/example</code> 디렉토리의 + <code>.htaccess</code> 파일을 두는 것과 주서버설정의 + <code><Directory /www/htdocs/example></code> Directory + 설정에 두는 것은 완전히 같다.</p> + + <p><code>/www/htdocs/example</code>에 있는 + <code>.htaccess</code> 섹션:</p> + + <div class="example"><h3><code>/www/htdocs/example</code>에 있는 + .htaccess 파일 내용</h3><p><code> + AddType text/example .exm + </code></p></div> + + <div class="example"><h3><code>httpd.conf</code> 파일에 있는 섹션</h3><p><code> + <Directory /www/htdocs/example><br /> + <span class="indent"> + AddType text/example .exm<br /> + </span> + </Directory> + </code></p></div> + + <p>그러나 파일을 요청할 때마다 설정을 읽지않고 아파치가 + 시작할때 한번만 설정을 읽기때문에 같은 설정을 서버설정파일에 + 사용하면 성능이 더 빠르다.</p> + + <p><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> 지시어를 + <code>none</code>으로 설정하면 <code>.htaccess</code> 파일을 + 완전히 사용할 수 없다.</p> + + <div class="example"><p><code> + AllowOverride None + </code></p></div> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="how" id="how">어떻게 지시어를 적용하나</a></h2> + + <p><code>.htaccess</code> 파일을 발견한 디렉토리와 그 디렉토리의 + 모든 하위디렉토리에 <code>.htaccess</code> 파일에 있는 설정 + 지시어를 적용한다. 그래서 상위디렉토리의 <code>.htaccess</code> + 파일을 주의해야 한다. 발견한 순서로 지시어를 적용한다. 특정 + 디렉토리에 있는 <code>.htaccess</code> 파일은 상위디렉토리에 + 있는 <code>.htaccess</code> 파일의 지시어를 무효로 만들 + 수 있고, 상위디렉토리에 있는 지시어는 더 상위디렉토리 혹은 + 주설정파일에 있는 지시어를 무효로 만들 수 있다.</p> + + <p>예제:</p> + + <p><code>/www/htdocs/example1</code> 디렉토리에 다음과 같은 + <code>.htaccess</code> 파일이 있다.</p> + + <div class="example"><p><code> + Options +ExecCGI + </code></p></div> + + <p>(주의: <code>.htaccess</code> 파일에 "<code class="directive"><a href="../mod/core.html#options">Options</a></code>" 지시어를 사용하려면 + "<code>AllowOverride Options</code>"가 필요하다.)</p> + + <p><code>/www/htdocs/example1/example2</code> 디렉토리에는 + 다음과 같은 <code>.htaccess</code> 파일이 있다.</p> + + <div class="example"><p><code> + Options Includes + </code></p></div> + + <p>이 두번째 <code>.htaccess</code> 파일의 + <code>Options Includes</code>가 이전 설정을 완전히 무효로 + 만들기때문에 <code>/www/htdocs/example1/example2</code> + 디렉토리는 CGI 실행을 허용하지 않는다.</p> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="auth" id="auth">인증 예제</a></h2> + + <p>인증 방법을 알기위해 바로 이곳부터 읽는다면 주의할 것이 + 있다. 암호 인증을 하려면 <code>.htaccess</code> 파일이 + 필요하다는 오해가 널리 퍼져있다. 이는 사실이 아니다. + 주설정파일의 <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> 섹션에 인증 지시어를 + 두는 것이 더 권장하는 방법이고, 서버의 주설정파일을 수정할 + 수 없는 경우에만 <code>.htaccess</code> 파일을 사용해야 + 한다. 언제 <code>.htaccess</code> 파일을 사용해야 하는지와 + 사용하지 말아야 하는지는 <a href="#when">위에서</a> + 설명하였다.</p> + + <p>앞에서 말했지만 아직도 <code>.htaccess</code> 파일이 + 필요하다고 생각되면 아래 설정이 도움이 될 것이다.</p> + + <p><code>.htaccess</code> 파일 내용.</p> + + <div class="example"><p><code> + AuthType Basic<br /> + AuthName "암호가 필요합니다"<br /> + AuthUserFile /www/passwords/password.file<br /> + AuthGroupFile /www/passwords/group.file<br /> + Require Group admins + </code></p></div> + + <p>이 지시어가 동작하기위해서는 + <code>AllowOverride AuthConfig</code> 지시어가 필요함을 + 명심하라.</p> + + <p>인증과 권한부여에 대한 자세한 설명은 <a href="auth.html">인증 + 투토리얼</a>을 보길 바란다.</p> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="ssi" id="ssi">Server Side Includes 예제</a></h2> + + <p>또다른 일반적인 <code>.htaccess</code> 파일의 용도는 + 특정 디렉토리에서 Server Side Includes를 가능하게 만드는 + 것이다. 원하는 디렉토리의 <code>.htaccess</code> 파일에 + 다음과 같은 설정 지시어를 사용하면 된다.</p> + + <div class="example"><p><code> + Options +Includes<br /> + AddType text/html shtml<br /> + AddHandler server-parsed shtml + </code></p></div> + + <p>이 지시어가 동작하려면 <code>AllowOverride Options</code>와 + <code>AllowOverride FileInfo</code>가 모두 필요함을 명심하라.</p> + + <p>server-side includes에 대한 자세한 설명은 <a href="ssi.html">SSI 투토리얼</a>을 보길 바란다.</p> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="cgi" id="cgi">CGI 예제</a></h2> + + <p>마지막으로 <code>.htaccess</code> 파일을 사용하여 특정 + 디렉토리에서 CGI 프로그램 실행을 허용하고 싶다면, 다음과 + 같은 설정을 사용한다.</p> + + <div class="example"><p><code> + Options +ExecCGI<br /> + AddHandler cgi-script cgi pl + </code></p></div> + + <p>혹은 이 디렉토리에 있는 모든 파일을 CGI 프로그램으로 + 처리하고 싶다면 다음과 같은 설정도 가능하다.</p> + + <div class="example"><p><code> + Options +ExecCGI<br /> + SetHandler cgi-script + </code></p></div> + + <p>이 지시어가 동작하려면 <code>AllowOverride Options</code>와 + <code>AllowOverride FileInfo</code>가 모두 필요함을 명심하라.</p> + + <p>CGI 프로그래밍과 설정에 대한 자세한 설명은 <a href="cgi.html">CGI 투토리얼</a>을 보길 바란다.</p> + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="troubleshoot" id="troubleshoot">문제해결</a></h2> + + <p><code>.htaccess</code> 파일에 둔 설정 지시어가 원하는 + 기능을 하지 않는 경우 여러가지 이유가 있을 수 있다.</p> + + <p>가장 일반적인 문제는 설정 지시어를 가능하게 만드는 <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>를 설정하지 않은 + 경우다. 문제가 되는 파일 영역에 <code>AllowOverride None</code>이 + 없는지 확인한다. <code>.htaccess</code> 파일을 아무렇게나 + 적은 다음 페이지를 다시 접근하여 쉽게 검사해볼 수 있다. + 서버 오류가 나오지 않으면 거의 확실히 + <code>AllowOverride None</code>을 사용한 경우다.</p> + + <p>반대로 문서에 접근할때 서버 오류가 발생하면 아파치 오류로그를 + 살펴봐라. 아마도 <code>.htaccess</code> 파일에 있는 지시어를 + 허용하지 않는다고 할 것이다. 아니고 문법 오류가 있다면 오류를 + 고친다.</p> + +</div></div> +<div class="bottomlang"> +<p><span>가능한 언어: </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/htaccess.html" title="Korean"> ko </a></p> +</div><div id="footer"> +<p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/howto/htaccess.xml.ko b/docs/manual/howto/htaccess.xml.ko new file mode 100644 index 0000000000..6b3a367703 --- /dev/null +++ b/docs/manual/howto/htaccess.xml.ko @@ -0,0 +1,350 @@ +<?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 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed 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. +--> + +<manualpage metafile="htaccess.xml.meta"> +<parentdocument href="./">How-To / Tutorials</parentdocument> + +<title>아파치 투토리얼: .htaccess 파일</title> + +<summary> +<p><code>.htaccess</code> 파일을 사용하여 디렉토리별로 설정을 +변경할 수 있다.</p> +</summary> + +<section id="related"><title>.htaccess 파일</title> + <related> + <modulelist> + <module>core</module> + <module>mod_authn_file</module> + <module>mod_authz_groupfile</module> + <module>mod_cgi</module> + <module>mod_include</module> + <module>mod_mime</module> + </modulelist> + + <directivelist> + <directive module="core">AccessFileName</directive> + <directive module="core">AllowOverride</directive> + <directive module="core">Options</directive> + <directive module="mod_mime">AddHandler</directive> + <directive module="core">SetHandler</directive> + <directive module="core">AuthType</directive> + <directive module="core">AuthName</directive> + <directive module="mod_authn_file">AuthUserFile</directive> + <directive module="mod_authz_groupfile">AuthGroupFile</directive> + <directive module="core">Require</directive> + </directivelist> + + </related> +</section> + +<section id="what"> +<title>무엇이며/어떻게 사용하는가</title> + + <p><code>.htaccess</code> 파일(혹은 "분산 설정파일")을 + 사용하면 디렉토리별로 설정을 변경할 수 있다. 여러 설정 지시어가 + 있는 파일을 특정 문서 디렉토리에 두면, 그 디렉토리와 모든 + 하위디렉토리에 지시어를 적용한다.</p> + + <note><title>주의:</title> + <p><code>.htaccess</code> 파일명을 다르게 사용하고 싶다면, + <directive module="core">AccessFileName</directive> 지시어를 + 사용하여 변경할 수 있다. 예를 들어, <code>.config</code> + 파일명을 사용하려면 서버 설정파일에 다음과 같이 추가한다.</p> + + <example> + AccessFileName .config + </example> + </note> + + <p>일반적으로 <code>.htaccess</code> 파일은 <a + href="../configuring.html#syntax">주설정파일</a>과 문법이 + 같다. <directive module="core">AllowOverride</directive> + 지시어가 이 파일에 나올 수 있는 내용을 결정한다. 이 지시어는 + <code>.htaccess</code> 파일에서 허용하는 지시어 분류를 지정한다. + 지시어를 <code>.htaccess</code> 파일에서 사용할 수 있다면, + 해당 지시어 문서의 Override 항목은 지시어를 허용하기위해 + <directive module="core">AllowOverride</directive>에 사용할 + 값을 알려준다.</p> + + <p>예를 들어, <directive module="core">AddDefaultCharset</directive> + 지시어 문서를 보면 이 지시어를 <code>.htaccess</code> 파일에서 + 사용할 수 있다. (지시어 요약에서 사용장소 항목을 보라.) + <a href="../mod/directive-dict.html#Context">Override</a> + 줄에 <code>FileInfo</code>가 있다. 그래서 이 지시어를 + <code>.htaccess</code> 파일에서 사용하기위해서는 최소한 + <code>AllowOverride FileInfo</code>가 필요하다.</p> + + <example><title>예제:</title> + <table> + <tr> + <td><a + href="../mod/directive-dict.html#Context">사용장소:</a></td> + <td>주서버설정, 가상호스트, directory, .htaccess</td> + </tr> + + <tr> + <td><a + href="../mod/directive-dict.html#Override">Override:</a></td> + <td>FileInfo</td> + </tr> + </table> + </example> + + <p>특정 지시어를 <code>.htaccess</code> 파일에서 사용할 + 수 있는지 궁금하면 지시어 문서의 사용장소 항목에 ".htaccess"가 + 있는지 확인한다.</p> + </section> + + <section id="when"><title>언제 .htaccess 파일을 사용하나 + (혹은 사용하지 않나)</title> + + <p>일반적으로 주서버파일에 접근할 수 없는 경우가 아니라면 + <code>.htaccess</code> 파일을 사용하면 안된다. 예를 들어, + 사용자 인증이 항상 <code>.htaccess</code> 파일에 있어야 + 한다는 것은 잘못 알려진 오해다. 이는 사실이 아니다. 주서버설정에 + 사용자 인증 설정을 적을 수 있고, 사실 이러길 권한다.</p> + + <p><code>.htaccess</code> 파일은 컨텐츠 제공자가 디렉토리별로 + 서버 설정을 다르게하고 싶지만 서버 시스템에 root 권한이 + 없는 경우에 사용한다. 서버 관리자가 설정을 자주 변경하고 + 싶지 않은 경우 일반 사용자가 직접 <code>.htaccess</code> + 파일을 수정하도록 허용하는 것이 바람직하다. 예를 들어, 한 + 컴퓨터에 여러 사용자 사이트를 서비스하는 ISP에서 사용자가 + 자신의 설정을 변경하고 싶은 경우가 그러하다.</p> + + <p>그러나 일반적으로 <code>.htaccess</code> 파일은 가급적 + 피해야 한다. <code>.htaccess</code> 파일에서 허용하는 지시어는 + 주설정파일의 <directive module="core" + type="section">Directory</directive> 섹션과 같은 효과가 + 있다.</p> + + <p>다음 두가지 큰 이유때문에 <code>.htaccess</code> 파일 + 사용을 피해야 한다.</p> + + <p>첫번째는 성능이다. <directive + module="core">AllowOverride</directive>가 <code>.htaccess</code> + 파일을 사용하도록 허용하면, 아파치는 디렉토리마다 + <code>.htaccess</code> 파일을 찾는다. 그래서 + <code>.htaccess</code> 파일을 허용하면 실제로 파일을 사용하지 + 않는 경우에도 성능이 떨어진다! 또, <code>.htaccess</code> + 파일은 문서를 요청할때마다 읽어들인다.</p> + + <p>게다가 적용해야 하는 전체 지시어를 모으기위해 아파치는 + 모든 상위 디렉토리에서 <code>.htaccess</code> 파일을 찾는다. + (<a href="#how">어떻게 지시어를 적용하나</a> 절을 참고.) + 그래서 <code>/www/htdocs/example</code> 디렉토리에 있는 + 파일을 요청하면, 아파치는 다음 파일들을 찾아야 한다.</p> + + <example> + /.htaccess<br /> + /www/.htaccess<br /> + /www/htdocs/.htaccess<br /> + /www/htdocs/example/.htaccess + </example> + + <p>그래서 그 디렉토리에 있는 파일을 접근할 때마다 설정파일이 + 전혀 없어도 파일시스템을 4번 더 접근해야 한다. + (<code>/</code>에서도 <code>.htaccess</code> 파일을 허용한 + 경우를 말한다. 보통은 허용하지 않는다.)</p> + + <p>두번째 이유는 보안이다. 사용자에게 서버설정 변경 권한을 + 주면 당신이 감당할 수 없는 변화가 일어날 수 있다. 사용자에게 + 이런 권한을 줄지 곰곰이 생각하라. 또, 사용자가 원하는 것보다 + 적은 권한을 주면 기술지원요청이 들어온다. 사용자에게 가능한 + 권한 수준을 명확히 알려라. 사용자에게 <directive + module="core">AllowOverride</directive>를 어떻게 설정하였는지 + 정확히 알리고 관련 문서를 제공하면 앞으로 혼란을 피할 수 + 있다.</p> + + <p>지시어를 <code>/www/htdocs/example</code> 디렉토리의 + <code>.htaccess</code> 파일을 두는 것과 주서버설정의 + <code><Directory /www/htdocs/example></code> Directory + 설정에 두는 것은 완전히 같다.</p> + + <p><code>/www/htdocs/example</code>에 있는 + <code>.htaccess</code> 섹션:</p> + + <example><title><code>/www/htdocs/example</code>에 있는 + .htaccess 파일 내용</title> + AddType text/example .exm + </example> + + <example><title><code>httpd.conf</code> 파일에 있는 섹션</title> + <Directory /www/htdocs/example><br /> + <indent> + AddType text/example .exm<br /> + </indent> + </Directory> + </example> + + <p>그러나 파일을 요청할 때마다 설정을 읽지않고 아파치가 + 시작할때 한번만 설정을 읽기때문에 같은 설정을 서버설정파일에 + 사용하면 성능이 더 빠르다.</p> + + <p><directive module="core">AllowOverride</directive> 지시어를 + <code>none</code>으로 설정하면 <code>.htaccess</code> 파일을 + 완전히 사용할 수 없다.</p> + + <example> + AllowOverride None + </example> +</section> + +<section id="how"><title>어떻게 지시어를 적용하나</title> + + <p><code>.htaccess</code> 파일을 발견한 디렉토리와 그 디렉토리의 + 모든 하위디렉토리에 <code>.htaccess</code> 파일에 있는 설정 + 지시어를 적용한다. 그래서 상위디렉토리의 <code>.htaccess</code> + 파일을 주의해야 한다. 발견한 순서로 지시어를 적용한다. 특정 + 디렉토리에 있는 <code>.htaccess</code> 파일은 상위디렉토리에 + 있는 <code>.htaccess</code> 파일의 지시어를 무효로 만들 + 수 있고, 상위디렉토리에 있는 지시어는 더 상위디렉토리 혹은 + 주설정파일에 있는 지시어를 무효로 만들 수 있다.</p> + + <p>예제:</p> + + <p><code>/www/htdocs/example1</code> 디렉토리에 다음과 같은 + <code>.htaccess</code> 파일이 있다.</p> + + <example> + Options +ExecCGI + </example> + + <p>(주의: <code>.htaccess</code> 파일에 "<directive + module="core">Options</directive>" 지시어를 사용하려면 + "<code>AllowOverride Options</code>"가 필요하다.)</p> + + <p><code>/www/htdocs/example1/example2</code> 디렉토리에는 + 다음과 같은 <code>.htaccess</code> 파일이 있다.</p> + + <example> + Options Includes + </example> + + <p>이 두번째 <code>.htaccess</code> 파일의 + <code>Options Includes</code>가 이전 설정을 완전히 무효로 + 만들기때문에 <code>/www/htdocs/example1/example2</code> + 디렉토리는 CGI 실행을 허용하지 않는다.</p> +</section> + +<section id="auth"><title>인증 예제</title> + + <p>인증 방법을 알기위해 바로 이곳부터 읽는다면 주의할 것이 + 있다. 암호 인증을 하려면 <code>.htaccess</code> 파일이 + 필요하다는 오해가 널리 퍼져있다. 이는 사실이 아니다. + 주설정파일의 <directive module="core" + type="section">Directory</directive> 섹션에 인증 지시어를 + 두는 것이 더 권장하는 방법이고, 서버의 주설정파일을 수정할 + 수 없는 경우에만 <code>.htaccess</code> 파일을 사용해야 + 한다. 언제 <code>.htaccess</code> 파일을 사용해야 하는지와 + 사용하지 말아야 하는지는 <a href="#when">위에서</a> + 설명하였다.</p> + + <p>앞에서 말했지만 아직도 <code>.htaccess</code> 파일이 + 필요하다고 생각되면 아래 설정이 도움이 될 것이다.</p> + + <p><code>.htaccess</code> 파일 내용.</p> + + <example> + AuthType Basic<br /> + AuthName "암호가 필요합니다"<br /> + AuthUserFile /www/passwords/password.file<br /> + AuthGroupFile /www/passwords/group.file<br /> + Require Group admins + </example> + + <p>이 지시어가 동작하기위해서는 + <code>AllowOverride AuthConfig</code> 지시어가 필요함을 + 명심하라.</p> + + <p>인증과 권한부여에 대한 자세한 설명은 <a href="auth.html">인증 + 투토리얼</a>을 보길 바란다.</p> +</section> + +<section id="ssi"><title>Server Side Includes 예제</title> + + <p>또다른 일반적인 <code>.htaccess</code> 파일의 용도는 + 특정 디렉토리에서 Server Side Includes를 가능하게 만드는 + 것이다. 원하는 디렉토리의 <code>.htaccess</code> 파일에 + 다음과 같은 설정 지시어를 사용하면 된다.</p> + + <example> + Options +Includes<br /> + AddType text/html shtml<br /> + AddHandler server-parsed shtml + </example> + + <p>이 지시어가 동작하려면 <code>AllowOverride Options</code>와 + <code>AllowOverride FileInfo</code>가 모두 필요함을 명심하라.</p> + + <p>server-side includes에 대한 자세한 설명은 <a + href="ssi.html">SSI 투토리얼</a>을 보길 바란다.</p> +</section> + +<section id="cgi"><title>CGI 예제</title> + + <p>마지막으로 <code>.htaccess</code> 파일을 사용하여 특정 + 디렉토리에서 CGI 프로그램 실행을 허용하고 싶다면, 다음과 + 같은 설정을 사용한다.</p> + + <example> + Options +ExecCGI<br /> + AddHandler cgi-script cgi pl + </example> + + <p>혹은 이 디렉토리에 있는 모든 파일을 CGI 프로그램으로 + 처리하고 싶다면 다음과 같은 설정도 가능하다.</p> + + <example> + Options +ExecCGI<br /> + SetHandler cgi-script + </example> + + <p>이 지시어가 동작하려면 <code>AllowOverride Options</code>와 + <code>AllowOverride FileInfo</code>가 모두 필요함을 명심하라.</p> + + <p>CGI 프로그래밍과 설정에 대한 자세한 설명은 <a + href="cgi.html">CGI 투토리얼</a>을 보길 바란다.</p> + +</section> + +<section id="troubleshoot"><title>문제해결</title> + + <p><code>.htaccess</code> 파일에 둔 설정 지시어가 원하는 + 기능을 하지 않는 경우 여러가지 이유가 있을 수 있다.</p> + + <p>가장 일반적인 문제는 설정 지시어를 가능하게 만드는 <directive + module="core">AllowOverride</directive>를 설정하지 않은 + 경우다. 문제가 되는 파일 영역에 <code>AllowOverride None</code>이 + 없는지 확인한다. <code>.htaccess</code> 파일을 아무렇게나 + 적은 다음 페이지를 다시 접근하여 쉽게 검사해볼 수 있다. + 서버 오류가 나오지 않으면 거의 확실히 + <code>AllowOverride None</code>을 사용한 경우다.</p> + + <p>반대로 문서에 접근할때 서버 오류가 발생하면 아파치 오류로그를 + 살펴봐라. 아마도 <code>.htaccess</code> 파일에 있는 지시어를 + 허용하지 않는다고 할 것이다. 아니고 문법 오류가 있다면 오류를 + 고친다.</p> + +</section> + +</manualpage> diff --git a/docs/manual/howto/htaccess.xml.meta b/docs/manual/howto/htaccess.xml.meta index ab23f24ec4..55704b009b 100644 --- a/docs/manual/howto/htaccess.xml.meta +++ b/docs/manual/howto/htaccess.xml.meta @@ -8,5 +8,6 @@ <variants> <variant>en</variant> <variant>ja</variant> + <variant>ko</variant> </variants> </metafile> diff --git a/docs/manual/howto/index.html b/docs/manual/howto/index.html index f1c25a51ec..5cc8a8a133 100644 --- a/docs/manual/howto/index.html +++ b/docs/manual/howto/index.html @@ -5,3 +5,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: index.html.ja.jis Content-Language: ja Content-type: text/html; charset=ISO-2022-JP + +URI: index.html.ko.euc-kr +Content-Language: ko +Content-type: text/html; charset=EUC-KR diff --git a/docs/manual/howto/index.html.en b/docs/manual/howto/index.html.en index 5f6ab302e4..e33f43d132 100644 --- a/docs/manual/howto/index.html.en +++ b/docs/manual/howto/index.html.en @@ -19,7 +19,8 @@ <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.1</a></div><div id="page-content"><div id="preamble"><h1>How-To / Tutorials</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/howto/" title="English"> en </a> | -<a href="../ja/howto/" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> +<a href="../ja/howto/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> @@ -96,7 +97,8 @@ </div></div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/howto/" title="English"> en </a> | -<a href="../ja/howto/" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> +<a href="../ja/howto/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> <p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> diff --git a/docs/manual/howto/index.html.ja.jis b/docs/manual/howto/index.html.ja.jis index 650e45c2e3..a388951a2f 100644 --- a/docs/manual/howto/index.html.ja.jis +++ b/docs/manual/howto/index.html.ja.jis @@ -19,7 +19,8 @@ <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP $B%5!<%P(B</a> > <a href="http://httpd.apache.org/docs-project/">$B%I%-%e%a%s%F!<%7%g%s(B</a> > <a href="../">$B%P!<%8%g%s(B 2.1</a></div><div id="page-content"><div id="preamble"><h1>How-To / $B%A%e!<%H%j%"%k(B</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/howto/" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../ja/howto/" title="Japanese"> ja </a></p> +<a href="../ja/howto/" title="Japanese"> ja </a> | +<a href="../ko/howto/" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> @@ -93,7 +94,8 @@ </div></div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/howto/" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../ja/howto/" title="Japanese"> ja </a></p> +<a href="../ja/howto/" title="Japanese"> ja </a> | +<a href="../ko/howto/" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> <p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">$B%b%8%e!<%k(B</a> | <a href="../mod/directives.html">$B%G%#%l%/%F%#%V(B</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">$BMQ(B$B8l(B</a> | <a href="../sitemap.html">$B%5%$%H%^%C%W(B</a></p></div> diff --git a/docs/manual/howto/index.html.ko.euc-kr b/docs/manual/howto/index.html.ko.euc-kr new file mode 100644 index 0000000000..2a850020f5 --- /dev/null +++ b/docs/manual/howto/index.html.ko.euc-kr @@ -0,0 +1,107 @@ +<?xml version="1.0" encoding="EUC-KR"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="ko" xml:lang="ko"><head><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>How-To / 투토리얼 - Apache HTTP Server</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /> +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page" class="no-sidebar"><div id="page-header"> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p> +<p class="apache">Apache HTTP Server Version 2.1</p> +<img alt="" src="../images/feather.gif" /></div> +<div class="up"><a href="../"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.1</a></div><div id="page-content"><div id="preamble"><h1>How-To / 투토리얼</h1> +<div class="toplang"> +<p><span>가능한 언어: </span><a href="../en/howto/" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../ja/howto/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/" title="Korean"> ko </a></p> +</div> +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="howto" id="howto">How-To / 투토리얼</a></h2> + + + + <dl> + <dt>인증</dt> + <dd> + <p>인증(authentication)은 자신이 누구라고 주장하는 사람을 + 확인하는 절차이다. 권한부여(authorization)는 가고 싶은 + 곳으로 가도록 혹은 원하는 정보를 얻도록 허용하는 과정이다.</p> + + <p>참고: <a href="auth.html">인증, 권한부여, 접근제어</a></p> + </dd> + </dl> + + <dl> + <dt>CGI를 사용한 동적 페이지 생성</dt> + <dd> + <p>CGI (Common Gateway Interface)는 웹서버가 보통 CGI + 프로그램 혹은 CGI 스크립트하고 부르는, (웹페이지 내용을 + 만드는) 외부 프로그램과 상호작용하는 방법을 정의한다. + 웹사이트에서 동적인 페이지를 만드는 가장 흔하고 간단한 + 방법이다. 이 문서는 아파치 웹서버에 CGI를 구성하는 방법을 + 소개하고, CGI 프로그램을 작성해본다.</p> + + <p>참고: <a href="cgi.html">CGI: 동적 페이지 생성</a></p> + </dd> + </dl> + + <dl> + <dt><code>.htaccess</code> 파일</dt> + <dd> + <p><code>.htaccess</code> 파일을 사용하여 디렉토리별로 + 설정을 변경할 수 있다. 여러 설정 지시어가 있는 파일을 + 특정 문서 디렉토리에 두면, 그 디렉토리와 모든 하위디렉토리에 + 지시어를 적용한다.</p> + + <p>참고: <a href="htaccess.html"><code>.htaccess</code> + 파일</a></p> + </dd> + </dl> + + <dl> + <dt>Server Side Includes 소개</dt> + <dd> + <p>SSI (Server Side Includes)는 HTML 페이지에 사용하는 + 지시어로, 페이지를 서비스할때 서버가 처리한다. SSI를 + 사용하면 CGI 프로그램이나 다른 동적인 기술로 페이지 + 전체를 만들어서 서비스하지 않고도 HTML 페이지에 동적으로 + 생성한 내용을 추가할 수 있다.</p> + + <p>참고: <a href="ssi.html">Server Side Includes (SSI)</a></p> + </dd> + </dl> + + <dl> + <dt>사용자별 웹디렉토리</dt> + <dd> + <p>여러 사용자가 있는 시스템에서 <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> 지시어를 사용하면 + 각 사용자는 자신의 홈디렉토리 안에 웹사이트를 만들 수 + 있다. URL <code>http://example.com/~username/</code>에 + 접근하면 사용자 "<code>username</code>"의 홈디렉토리에서 + <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> + 지시어로 지정한 하위디렉토리에 있는 페이지를 가져오게 + 된다.</p> + + <p>참고: <a href="public_html.html">사용자 웹디렉토리 + (<code>public_html</code>)</a></p> + </dd> + </dl> + + </div></div> +<div class="bottomlang"> +<p><span>가능한 언어: </span><a href="../en/howto/" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../ja/howto/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/" title="Korean"> ko </a></p> +</div><div id="footer"> +<p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/howto/index.xml.ko b/docs/manual/howto/index.xml.ko new file mode 100644 index 0000000000..1013712adc --- /dev/null +++ b/docs/manual/howto/index.xml.ko @@ -0,0 +1,103 @@ +<?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.7 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed 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. +--> + +<manualpage metafile="index.xml.meta"> + <parentdocument href="../"/> + + <title>How-To / 투토리얼</title> + + <section id="howto"> + + <title>How-To / 투토리얼</title> + + <dl> + <dt>인증</dt> + <dd> + <p>인증(authentication)은 자신이 누구라고 주장하는 사람을 + 확인하는 절차이다. 권한부여(authorization)는 가고 싶은 + 곳으로 가도록 혹은 원하는 정보를 얻도록 허용하는 과정이다.</p> + + <p>참고: <a href="auth.html">인증, 권한부여, 접근제어</a></p> + </dd> + </dl> + + <dl> + <dt>CGI를 사용한 동적 페이지 생성</dt> + <dd> + <p>CGI (Common Gateway Interface)는 웹서버가 보통 CGI + 프로그램 혹은 CGI 스크립트하고 부르는, (웹페이지 내용을 + 만드는) 외부 프로그램과 상호작용하는 방법을 정의한다. + 웹사이트에서 동적인 페이지를 만드는 가장 흔하고 간단한 + 방법이다. 이 문서는 아파치 웹서버에 CGI를 구성하는 방법을 + 소개하고, CGI 프로그램을 작성해본다.</p> + + <p>참고: <a href="cgi.html">CGI: 동적 페이지 생성</a></p> + </dd> + </dl> + + <dl> + <dt><code>.htaccess</code> 파일</dt> + <dd> + <p><code>.htaccess</code> 파일을 사용하여 디렉토리별로 + 설정을 변경할 수 있다. 여러 설정 지시어가 있는 파일을 + 특정 문서 디렉토리에 두면, 그 디렉토리와 모든 하위디렉토리에 + 지시어를 적용한다.</p> + + <p>참고: <a href="htaccess.html"><code>.htaccess</code> + 파일</a></p> + </dd> + </dl> + + <dl> + <dt>Server Side Includes 소개</dt> + <dd> + <p>SSI (Server Side Includes)는 HTML 페이지에 사용하는 + 지시어로, 페이지를 서비스할때 서버가 처리한다. SSI를 + 사용하면 CGI 프로그램이나 다른 동적인 기술로 페이지 + 전체를 만들어서 서비스하지 않고도 HTML 페이지에 동적으로 + 생성한 내용을 추가할 수 있다.</p> + + <p>참고: <a href="ssi.html">Server Side Includes (SSI)</a></p> + </dd> + </dl> + + <dl> + <dt>사용자별 웹디렉토리</dt> + <dd> + <p>여러 사용자가 있는 시스템에서 <directive + module="mod_userdir">UserDir</directive> 지시어를 사용하면 + 각 사용자는 자신의 홈디렉토리 안에 웹사이트를 만들 수 + 있다. URL <code>http://example.com/~username/</code>에 + 접근하면 사용자 "<code>username</code>"의 홈디렉토리에서 + <directive module="mod_userdir">UserDir</directive> + 지시어로 지정한 하위디렉토리에 있는 페이지를 가져오게 + 된다.</p> + + <p>참고: <a href="public_html.html">사용자 웹디렉토리 + (<code>public_html</code>)</a></p> + </dd> + </dl> + + </section> + +</manualpage> + + diff --git a/docs/manual/howto/index.xml.meta b/docs/manual/howto/index.xml.meta index 43f93e1200..c91f4a8999 100644 --- a/docs/manual/howto/index.xml.meta +++ b/docs/manual/howto/index.xml.meta @@ -8,5 +8,6 @@ <variants> <variant>en</variant> <variant>ja</variant> + <variant>ko</variant> </variants> </metafile> diff --git a/docs/manual/howto/public_html.html b/docs/manual/howto/public_html.html index f4066de685..4529900542 100644 --- a/docs/manual/howto/public_html.html +++ b/docs/manual/howto/public_html.html @@ -5,3 +5,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: public_html.html.ja.jis Content-Language: ja Content-type: text/html; charset=ISO-2022-JP + +URI: public_html.html.ko.euc-kr +Content-Language: ko +Content-type: text/html; charset=EUC-KR diff --git a/docs/manual/howto/public_html.html.en b/docs/manual/howto/public_html.html.en index 65843b803c..109d2dceb6 100644 --- a/docs/manual/howto/public_html.html.en +++ b/docs/manual/howto/public_html.html.en @@ -19,7 +19,8 @@ <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.1</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>Per-user web directories</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/howto/public_html.html" title="English"> en </a> | -<a href="../ja/howto/public_html.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> +<a href="../ja/howto/public_html.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/public_html.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> <p>On systems with multiple users, each user can be permitted to have a @@ -152,7 +153,8 @@ </div></div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/howto/public_html.html" title="English"> en </a> | -<a href="../ja/howto/public_html.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> +<a href="../ja/howto/public_html.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/public_html.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> <p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> diff --git a/docs/manual/howto/public_html.html.ja.jis b/docs/manual/howto/public_html.html.ja.jis index dba9132668..68245aad23 100644 --- a/docs/manual/howto/public_html.html.ja.jis +++ b/docs/manual/howto/public_html.html.ja.jis @@ -19,7 +19,8 @@ <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP $B%5!<%P(B</a> > <a href="http://httpd.apache.org/docs-project/">$B%I%-%e%a%s%F!<%7%g%s(B</a> > <a href="../">$B%P!<%8%g%s(B 2.1</a> > <a href="./">How-To / $B%A%e!<%H%j%"%k(B</a></div><div id="page-content"><div id="preamble"><h1>$B%f!<%6Kh$N%&%'%V%G%#%l%/%H%j(B</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/howto/public_html.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../ja/howto/public_html.html" title="Japanese"> ja </a></p> +<a href="../ja/howto/public_html.html" title="Japanese"> ja </a> | +<a href="../ko/howto/public_html.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> <p>$BJ#?t$N%f!<%6$N$$$k%7%9%F%`$G$O!"(B<code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> $B%G%#%l%/%F%#%V$r;H$C$F(B @@ -146,7 +147,8 @@ </div></div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/howto/public_html.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../ja/howto/public_html.html" title="Japanese"> ja </a></p> +<a href="../ja/howto/public_html.html" title="Japanese"> ja </a> | +<a href="../ko/howto/public_html.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> <p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">$B%b%8%e!<%k(B</a> | <a href="../mod/directives.html">$B%G%#%l%/%F%#%V(B</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">$BMQ(B$B8l(B</a> | <a href="../sitemap.html">$B%5%$%H%^%C%W(B</a></p></div> diff --git a/docs/manual/howto/public_html.html.ko.euc-kr b/docs/manual/howto/public_html.html.ko.euc-kr new file mode 100644 index 0000000000..c059272fbc --- /dev/null +++ b/docs/manual/howto/public_html.html.ko.euc-kr @@ -0,0 +1,156 @@ +<?xml version="1.0" encoding="EUC-KR"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="ko" xml:lang="ko"><head><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>사용자별 웹디렉토리 - Apache HTTP Server</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /> +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p> +<p class="apache">Apache HTTP Server Version 2.1</p> +<img alt="" src="../images/feather.gif" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.1</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>사용자별 웹디렉토리</h1> +<div class="toplang"> +<p><span>가능한 언어: </span><a href="../en/howto/public_html.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../ja/howto/public_html.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/public_html.html" title="Korean"> ko </a></p> +</div> + +<p>여러 사용자가 있는 시스템에서 <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> 지시어를 사용하면 + 각 사용자는 자신의 홈디렉토리 안에 웹사이트를 만들 수 있다. + URL <code>http://example.com/~username/</code>에 접근하면 + 사용자 "<code>username</code>"의 홈디렉토리에서 <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> 지시어로 지정한 + 하위디렉토리에 있는 페이지를 가져오게 된다.</p> + +</div> +<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">사용자별 웹디렉토리</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#userdir">UserDir로 파일경로 지정하기</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#enable">기능을 이용할 사용자 제한하기</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#cgi">각 사용자별 cgi 디렉토리 지정하기</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#htaccess">사용자가 설정을 변경할 수 있도록 만들기</a></li> +</ul><h3>참고</h3><ul class="seealso"><li><a href="../urlmapping.html">URL을 파일시스템에 대응</a></li></ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="related" id="related">사용자별 웹디렉토리</a></h2> + + <table class="related"><tr><th>관련된 모듈</th><th>관련된 지시어</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code></li><li><code class="directive"><a href="../mod/core.html#directorymatch">DirectoryMatch</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li></ul></td></tr></table> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="userdir" id="userdir">UserDir로 파일경로 지정하기</a></h2> + + + <p><code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> + 지시어는 사용자별 페이지를 가져올 디렉토리를 지정한다. 이 + 지시어의 사용법은 여러가지다.</p> + + <p>슬래쉬로 시작하지않는 경로를 지정하면 각 사용자의 + 홈디렉토리에 상대적인 디렉토리 경로로 처리한다. 예를 들어, + 아래 설정의 경우:</p> + + <div class="example"><p><code> + UserDir public_html + </code></p></div> + + <p>URL <code>http://example.com/~rbowen/file.html</code>은 + 파일 경로 <code>/home/rbowen/public_html/file.html</code>을 + 뜻한다.</p> + + <p>슬래쉬로 시작하는 경로를 지정하면 지정한 디렉토리에 + 사용자명을 더한 디렉토리 경로를 사용한다. 예를 들어, 아래 + 설정의 경우:</p> + + <div class="example"><p><code> + UserDir /var/html + </code></p></div> + + <p>URL <code>http://example.com/~rbowen/file.html</code>은 + 파일 경로 <code>/var/html/rbowen/file.html</code>을 뜻한다.</p> + + <p>별표 (*)를 포함한 경로를 지정하면 별표를 사용자명으로 + 대체한 경로를 사용한다. 예를 들어, 아래 설정의 경우:</p> + + <div class="example"><p><code> + UserDir /var/www/*/docs + </code></p></div> + + <p>URL <code>http://example.com/~rbowen/file.html</code>은 + 파일 경로 <code>/var/www/rbowen/docs/file.html</code>을 + 뜻한다.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="enable" id="enable">기능을 이용할 사용자 제한하기</a></h2> + + + <p>UserDir 문서에 있는 문법을 사용하여 사용자별 웹디렉토리 + 기능을 이용할 수 있는 사용자를 제한할 수 있다:</p> + + <div class="example"><p><code> + UserDir enabled<br /> + UserDir disabled root jro fish + </code></p></div> + + <p>위 설정은 <code>disabled</code> 문장에 열거한 사람을 + 제외하고 모든 사용자에게 웹디렉토리 기능을 허락한다. 또, + 다음과 같이 몇몇 사용자를 제외하고 기능을 허락하지 않을 + 수도 있다:</p> + + <div class="example"><p><code> + UserDir disabled<br /> + UserDir enabled rbowen krietz + </code></p></div> + + <p><code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> + 문서에 있는 다른 예들도 참고하라.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="cgi" id="cgi">각 사용자별 cgi 디렉토리 지정하기</a></h2> + + + <p>사용자마다 cgi-bin 디렉토리를 부여하려면 <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> 지시어를 + 사용하여 사용자 홈디렉토리의 특정 하위디렉토리를 cgi 가능하게 + 만든다.</p> + + <div class="example"><p><code> + <Directory /home/*/public_html/cgi-bin/><br /> + Options ExecCGI<br /> + SetHandler cgi-script<br /> + </Directory> + </code></p></div> + + <p><code>UserDir</code>이 <code>public_html</code>이라고 + 가정하면, 다음과 같이 그 안에 있는 cgi 프로그램 + <code>example.cgi</code>를 실행할 수 있다.</p> + + <div class="example"><p><code> + http://example.com/~rbowen/cgi-bin/example.cgi + </code></p></div> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="htaccess" id="htaccess">사용자가 설정을 변경할 수 있도록 만들기</a></h2> + + + <p>사용자가 자신의 웹공간에 대한 웹서버 설정을 수정하려면, + <code>.htaccess</code> 파일을 사용할 수 있어야 한다. <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>를 사용자가 수정할 + 수 있는 지시어에 적합한 값으로 설정하라. 어떻게 동작하는지에 + 대한 자세한 졍보는 <a href="htaccess.html">.htaccess + 투토리얼</a>을 참고하라.</p> + + </div></div> +<div class="bottomlang"> +<p><span>가능한 언어: </span><a href="../en/howto/public_html.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../ja/howto/public_html.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/public_html.html" title="Korean"> ko </a></p> +</div><div id="footer"> +<p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/howto/public_html.xml.ko b/docs/manual/howto/public_html.xml.ko new file mode 100644 index 0000000000..4c2e6ffee7 --- /dev/null +++ b/docs/manual/howto/public_html.xml.ko @@ -0,0 +1,160 @@ +<?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.12 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed 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. +--> + +<manualpage metafile="public_html.xml.meta"> +<parentdocument href="./">How-To / Tutorials</parentdocument> + + <title>사용자별 웹디렉토리</title> + +<summary> +<p>여러 사용자가 있는 시스템에서 <directive + module="mod_userdir">UserDir</directive> 지시어를 사용하면 + 각 사용자는 자신의 홈디렉토리 안에 웹사이트를 만들 수 있다. + URL <code>http://example.com/~username/</code>에 접근하면 + 사용자 "<code>username</code>"의 홈디렉토리에서 <directive + module="mod_userdir">UserDir</directive> 지시어로 지정한 + 하위디렉토리에 있는 페이지를 가져오게 된다.</p> + +</summary> + +<seealso><a href="../urlmapping.html">URL을 파일시스템에 대응</a></seealso> + + <section id="related"> + <title>사용자별 웹디렉토리</title> + <related> + <modulelist> + <module>mod_userdir</module> + </modulelist> + <directivelist> + <directive module="mod_userdir">UserDir</directive> + <directive module="core">DirectoryMatch</directive> + <directive module="core">AllowOverride</directive> + </directivelist> + </related> + </section> + + <section id="userdir"> + <title>UserDir로 파일경로 지정하기</title> + + <p><directive module="mod_userdir">UserDir</directive> + 지시어는 사용자별 페이지를 가져올 디렉토리를 지정한다. 이 + 지시어의 사용법은 여러가지다.</p> + + <p>슬래쉬로 시작하지않는 경로를 지정하면 각 사용자의 + 홈디렉토리에 상대적인 디렉토리 경로로 처리한다. 예를 들어, + 아래 설정의 경우:</p> + + <example> + UserDir public_html + </example> + + <p>URL <code>http://example.com/~rbowen/file.html</code>은 + 파일 경로 <code>/home/rbowen/public_html/file.html</code>을 + 뜻한다.</p> + + <p>슬래쉬로 시작하는 경로를 지정하면 지정한 디렉토리에 + 사용자명을 더한 디렉토리 경로를 사용한다. 예를 들어, 아래 + 설정의 경우:</p> + + <example> + UserDir /var/html + </example> + + <p>URL <code>http://example.com/~rbowen/file.html</code>은 + 파일 경로 <code>/var/html/rbowen/file.html</code>을 뜻한다.</p> + + <p>별표 (*)를 포함한 경로를 지정하면 별표를 사용자명으로 + 대체한 경로를 사용한다. 예를 들어, 아래 설정의 경우:</p> + + <example> + UserDir /var/www/*/docs + </example> + + <p>URL <code>http://example.com/~rbowen/file.html</code>은 + 파일 경로 <code>/var/www/rbowen/docs/file.html</code>을 + 뜻한다.</p> + + </section> + + <section id="enable"> + <title>기능을 이용할 사용자 제한하기</title> + + <p>UserDir 문서에 있는 문법을 사용하여 사용자별 웹디렉토리 + 기능을 이용할 수 있는 사용자를 제한할 수 있다:</p> + + <example> + UserDir enabled<br /> + UserDir disabled root jro fish + </example> + + <p>위 설정은 <code>disabled</code> 문장에 열거한 사람을 + 제외하고 모든 사용자에게 웹디렉토리 기능을 허락한다. 또, + 다음과 같이 몇몇 사용자를 제외하고 기능을 허락하지 않을 + 수도 있다:</p> + + <example> + UserDir disabled<br /> + UserDir enabled rbowen krietz + </example> + + <p><directive module="mod_userdir">UserDir</directive> + 문서에 있는 다른 예들도 참고하라.</p> + + </section> + + <section id="cgi"> + <title>각 사용자별 cgi 디렉토리 지정하기</title> + + <p>사용자마다 cgi-bin 디렉토리를 부여하려면 <directive + module="core" type="section">Directory</directive> 지시어를 + 사용하여 사용자 홈디렉토리의 특정 하위디렉토리를 cgi 가능하게 + 만든다.</p> + + <example> + <Directory /home/*/public_html/cgi-bin/><br /> + Options ExecCGI<br /> + SetHandler cgi-script<br /> + </Directory> + </example> + + <p><code>UserDir</code>이 <code>public_html</code>이라고 + 가정하면, 다음과 같이 그 안에 있는 cgi 프로그램 + <code>example.cgi</code>를 실행할 수 있다.</p> + + <example> + http://example.com/~rbowen/cgi-bin/example.cgi + </example> + + </section> + + <section id="htaccess"> + <title>사용자가 설정을 변경할 수 있도록 만들기</title> + + <p>사용자가 자신의 웹공간에 대한 웹서버 설정을 수정하려면, + <code>.htaccess</code> 파일을 사용할 수 있어야 한다. <directive + module="core">AllowOverride</directive>를 사용자가 수정할 + 수 있는 지시어에 적합한 값으로 설정하라. 어떻게 동작하는지에 + 대한 자세한 졍보는 <a href="htaccess.html">.htaccess + 투토리얼</a>을 참고하라.</p> + + </section> + +</manualpage> diff --git a/docs/manual/howto/public_html.xml.meta b/docs/manual/howto/public_html.xml.meta index b2a8d12cb9..96559002a1 100644 --- a/docs/manual/howto/public_html.xml.meta +++ b/docs/manual/howto/public_html.xml.meta @@ -8,5 +8,6 @@ <variants> <variant>en</variant> <variant>ja</variant> + <variant>ko</variant> </variants> </metafile> diff --git a/docs/manual/howto/ssi.html b/docs/manual/howto/ssi.html index d74be2de88..fab7885793 100644 --- a/docs/manual/howto/ssi.html +++ b/docs/manual/howto/ssi.html @@ -5,3 +5,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: ssi.html.ja.jis Content-Language: ja Content-type: text/html; charset=ISO-2022-JP + +URI: ssi.html.ko.euc-kr +Content-Language: ko +Content-type: text/html; charset=EUC-KR diff --git a/docs/manual/howto/ssi.html.en b/docs/manual/howto/ssi.html.en index 40f07bd612..096f601ffa 100644 --- a/docs/manual/howto/ssi.html.en +++ b/docs/manual/howto/ssi.html.en @@ -19,7 +19,8 @@ <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.1</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>Apache Tutorial: Introduction to Server Side Includes</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/howto/ssi.html" title="English"> en </a> | -<a href="../ja/howto/ssi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> +<a href="../ja/howto/ssi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/ssi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> <p>Server-side includes provide a means to add dynamic content to @@ -477,7 +478,8 @@ modified?</a></h3> </div></div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/howto/ssi.html" title="English"> en </a> | -<a href="../ja/howto/ssi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> +<a href="../ja/howto/ssi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/ssi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> <p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> diff --git a/docs/manual/howto/ssi.html.ja.jis b/docs/manual/howto/ssi.html.ja.jis index 00ea036265..626ca45eae 100644 --- a/docs/manual/howto/ssi.html.ja.jis +++ b/docs/manual/howto/ssi.html.ja.jis @@ -19,7 +19,8 @@ <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP $B%5!<%P(B</a> > <a href="http://httpd.apache.org/docs-project/">$B%I%-%e%a%s%F!<%7%g%s(B</a> > <a href="../">$B%P!<%8%g%s(B 2.1</a> > <a href="./">How-To / $B%A%e!<%H%j%"%k(B</a></div><div id="page-content"><div id="preamble"><h1>Apache $B%A%e!<%H%j%"%k(B: Server Side Includes $BF~Lg(B</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/howto/ssi.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../ja/howto/ssi.html" title="Japanese"> ja </a></p> +<a href="../ja/howto/ssi.html" title="Japanese"> ja </a> | +<a href="../ko/howto/ssi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> <p>$B%5!<%P%5%$%I%$%s%/%k!<%I$K$h$C$F!"4{B8$N(B HTML @@ -472,7 +473,8 @@ </div></div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/howto/ssi.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../ja/howto/ssi.html" title="Japanese"> ja </a></p> +<a href="../ja/howto/ssi.html" title="Japanese"> ja </a> | +<a href="../ko/howto/ssi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> <p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">$B%b%8%e!<%k(B</a> | <a href="../mod/directives.html">$B%G%#%l%/%F%#%V(B</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">$BMQ(B$B8l(B</a> | <a href="../sitemap.html">$B%5%$%H%^%C%W(B</a></p></div> diff --git a/docs/manual/howto/ssi.html.ko.euc-kr b/docs/manual/howto/ssi.html.ko.euc-kr new file mode 100644 index 0000000000..201cd10084 --- /dev/null +++ b/docs/manual/howto/ssi.html.ko.euc-kr @@ -0,0 +1,426 @@ +<?xml version="1.0" encoding="EUC-KR"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="ko" xml:lang="ko"><head><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>아파치 투토리얼: Server Side Includes 소개 - Apache HTTP Server</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /> +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p> +<p class="apache">Apache HTTP Server Version 2.1</p> +<img alt="" src="../images/feather.gif" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.1</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>아파치 투토리얼: Server Side Includes 소개</h1> +<div class="toplang"> +<p><span>가능한 언어: </span><a href="../en/howto/ssi.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../ja/howto/ssi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/ssi.html" title="Korean"> ko </a></p> +</div> + +<p>Server-side includes를 사용하여 HTML 문서에 동적인 내용을 +추가할 수 있다.</p> +</div> +<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">소개</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#what">SSI가 무엇인가?</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#configuring">SSI가 가능하도록 서버 설정하기</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#basic">기본 SSI 지시어</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#additionalexamples">추가 예제</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#config">이외에 설정할 수 있는 것은?</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#exec">명령어 실행하기</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#advanced">고급 SSI 기법</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#conclusion">결론</a></li> +</ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="related" id="related">소개</a></h2> + <table class="related"><tr><th>관련된 모듈</th><th>관련된 지시어</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="../mod/mod_expires.html">mod_expires</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code></li><li><code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code></li><li><code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code></li><li><code class="directive"><a href="../mod/mod_setenvif.html#browsermatchnocase">BrowserMatchNoCase</a></code></li></ul></td></tr></table> + + <p>이 글은 보통 SSI라고 부르는 Server Side Includes를 설명한다. + SSI가 가능하도록 서버를 설정하는 방법과 HTML 페이지에 동적인 + 내용을 추가하는 기본적인 SSI 사용법을 소개한다.</p> + + <p>이 글의 뒷부분은 SSI 지시어 조건문과 같은 고급기법을 + 설명한다.</p> + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="what" id="what">SSI가 무엇인가?</a></h2> + + <p>SSI (Server Side Includes)는 HTML 페이지에 사용하는 지시어로, + 페이지를 서비스할때 서버가 처리한다. SSI를 사용하면 CGI + 프로그램이나 다른 동적인 기술로 페이지 전체를 만들어서 + 서비스하지 않고도 HTML 페이지에 동적으로 생성한 내용을 추가할 + 수 있다.</p> + + <p>SSI를 사용할지 아니면 프로그램으로 페이지 전체를 생성할지 + 결정은 페이지에서 정적인 부분이 많은지와 페이지를 서비스할 + 때마다 어느정도를 다시 계산해야할지에 달렸다. SSI는 현재 + 시간과 같이 적은 정보를 추가하는데 좋다. 그러나 페이지를 + 서비스할때 페이지의 대부분을 생성해야 한다면 다른 방법을 + 찾아봐야 한다.</p> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="configuring" id="configuring">SSI가 가능하도록 서버 설정하기</a></h2> + + + <p>서버가 SSI를 처리하려면 <code>httpd.conf</code> 파일이나 + <code>.htaccess</code> 파일에서 다음 지시어를 사용해야 한다.</p> +<div class="example"><p><code> + Options +Includes +</code></p></div> + + <p>그러면 아파치는 파일에서 SSI 지시어를 처리한다. 설정에는 + 보통 여러 <code class="directive"><a href="../mod/core.html#options">Options</a></code> 지시어가 + 있고, 이 지시어들은 서로 덮어써서 무효로 만들다. 그래서 + 지시어를 맨마지막에 처리하기위해 보통 SSI를 원하는 특정 + 디렉토리에서 <code>Options</code>를 사용한다.</p> + + <p>모든 파일에서 SSI 지시어를 처리하는 것은 아니다. 아파치에게 + 어떤 파일을 처리할지 알려줘야 한다. 두가지 방법이 있다. + 하나는 다음과 같은 지시어로 <code>.shtml</code>과 같은 특정 + 파일 확장자를 가진 파일을 처리하는 방법이다.</p> +<div class="example"><p><code> + AddType text/html .shtml<br /> + AddOutputFilter INCLUDES .shtml +</code></p></div> + + <p>이 방법의 단점은 이미 있는 페이지에 SSI 지시어를 추가하는 + 경우 SSI 지시어를 처리하기위해 <code>.shtml</code> 확장자를 + 부여하기때문에 파일명과 이 페이지의 모든 링크를 변경해야 + 하는 점이다.</p> + + <p>다른 방법은 <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code> + 지시어를 사용하는 방법이다.</p> +<div class="example"><p><code> + XBitHack on +</code></p></div> + + <p><code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>는 + 실행권한이 있는 파일에서 SSI 지시어를 처리한다. 그래서 이미 + 있는 페이지에 SSI 지시어를 추가한다면 파일명을 변경하지 + 않고 <code>chmod</code>로 파일에 실행권한을 주면 된다.</p> +<div class="example"><p><code> + chmod +x pagename.html +</code></p></div> + + <p>하지 말아야 할 것 하나. 가끔 <code>.shtml</code> 파일명에 + 골치를 앓지말고 모든 <code>.html</code> 파일을 SSI 처리하라고 + 충고하는 사람이 있다. 이 사람들은 아마도 <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>에 대해 모르는 + 것 같다. 명심할 점은 이렇게 하면 아파치는 파일에 SSI 지시어가 + 없더라도 클라이언트로 보내는 모든 파일을 살펴봐야 한다는 + 것이다. 성능이 매우 느려질 수 있으며, 좋은 생각이 아니다.</p> + + <p>물론 윈도우즈에서는 실행권한이란 것이 없기때문에 후자를 + 사용할 수 없다.</p> + + <p>내용이 동적이여서 계산하기 어렵기때문에 아파치 기본 설정은 + SSI 페이지의 최근수정일과 content length HTTP 헤더를 보내지 + 않는다. 그래서 문서를 캐쉬하지 못하고 클라이언트가 느끼는 + 성능이 떨어진다. 두가지 해결방법이 있다.</p> + + <ol> + <li><code>XBitHack Full</code> 설정은 사용한다. 그러면 + 아파치는 포함하는(include) 파일들의 수정일은 무시한체 + 원래 요청한 파일의 날짜만 보고 최근수정일을 알아낸다.</li> + + <li><code class="module"><a href="../mod/mod_expires.html">mod_expires</a></code>에 있는 지시어를 사용하여 + 파일에 직접 만기일을 설정하면 브라우저와 프록시가 문서를 + 캐쉬할 수 있다.</li> + </ol> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="basic" id="basic">기본 SSI 지시어</a></h2> + + <p>SSI 지시어의 사용법은 다음과 같다.</p> +<div class="example"><p><code> + <!--#element attribute=value attribute=value ... --> +</code></p></div> + + <p>HTML 주석같이 생겼기때문에 SSI 기능을 가동하지 않아도 + HTML 소스에는 나오지만 브라우저는 무시한다. SSI를 올바로 + 설정하면 지시어를 결과값으로 바꾼다.</p> + + <p>element는 다음중 하나다. 다음 회에 더 자세히 설명할 것이다. + 지금은 SSI로 할 수 있는 몇가지 예를 보인다</p> + +<h3><a name="todaysdate" id="todaysdate">오늘 날짜</a></h3> + +<div class="example"><p><code> + <!--#echo var="DATE_LOCAL" --> +</code></p></div> + + <p><code>echo</code> element는 변수값을 그대로 출력한다. + CGI 프로그램에 제공하는 환경변수들 외에도 여러 표준 변수가 + 있다. 또, <code>set</code> element를 사용하여 직접 변수를 + 정의할 수도 있다.</p> + + <p>날짜 출력 형식이 마음에 들지 않는다면, 다음과 같이 + <code>config</code> element의 <code>timefmt</code> attribute를 + 사용한다.</p> + +<div class="example"><p><code> + <!--#config timefmt="%A %B %d, %Y" --><br /> + Today is <!--#echo var="DATE_LOCAL" --> +</code></p></div> + + +<h3><a name="lastmodified" id="lastmodified">파일의 수정일</a></h3> + +<div class="example"><p><code> + 이 문서는 <!--#flastmod file="index.html" -->에 마지막으로 수정되었다 +</code></p></div> + + <p>이 element도 <code>timefmt</code> 형식 설정에 달렸다.</p> + + +<h3><a name="cgi" id="cgi">CGI 프로그램 결과를 포함하기</a></h3> + + <p>일반적인 SSI 사용법중 하나로, 많이들 애용하는 ``방문수 + 카운터'' 같은 CGI 프로그램 결과를 출력한다.</p> + +<div class="example"><p><code> + <!--#include virtual="/cgi-bin/counter.pl" --> +</code></p></div> + + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="additionalexamples" id="additionalexamples">추가 예제</a></h2> + + + <p>다음은 HTML 문서에 사용할 수 있는 몇가지 SSI 예제다.</p> + +<h3><a name="docmodified" id="docmodified">이 문서가 언제 마지막으로 +수정되었나?</a></h3> + + <p>앞에서 SSI를 사용하여 사용자에게 문서의 최근수정일을 + 알릴 수 있다고 말했다. 그러나 실제 방법은 알려주지 않았다. + 다음 코드를 HTML 문서에 사용하면 페이지에 시간 기록을 남긴다. + 물론 위에서 설명한대로 SSI가 올바로 작동해야 한다.</p> +<div class="example"><p><code> + <!--#config timefmt="%A %B %d, %Y" --><br /> + 이 문서는 <!--#flastmod file="ssi.shtml" -->에 마지막으로 수정되었다; +</code></p></div> + + <p>물론 <code>ssi.shtml</code>대신 원하는 실제 파일명을 + 사용한다. 아무 페이지에라도 붙여넣을 수 있는 범용코드를 + 원한다면, 파일명 대신 <code>LAST_MODIFIED</code> 변수를 + 사용한다.</p> +<div class="example"><p><code> + <!--#config timefmt="%D" --><br /> + This file last modified <!--#echo var="LAST_MODIFIED" --> +</code></p></div> + + <p><code>timefmt</code> 형식에 대한 자세한 정보는 검색엔진에서 + <code>strftime</code>을 찾아봐라. 문법은 같다.</p> + + +<h3><a name="standard-footer" id="standard-footer">표준 페이지 하단을 포함하기</a></h3> + + + <p>여러 페이지가 있는 사이트를 관리한다면 페이지 전체를 + 수정하는 것은, 특히 페이지들이 표준 외관을 가지도록 수정하는 + 것은 정말로 괴롭다.</p> + + <p>페이지 상단(header)과 하단(footer)을 파일로 포함하여 + 이런 수정의 부담을 덜 수 있다. 모든 페이지에서 + <code>include</code> SSI 명령어를 사용하여 페이지 하단 파일 + 하나를 포함하면 된다. <code>include</code> element의 + <code>file</code> attribute나 <code>virtual</code> attribute로 + 포함할 파일을 지정한다. <code>file</code> attribute는 <em>현재 + 디렉토리에 상대적인</em> 파일경로다. 즉, (/로 시작하는) + 절대파일경로나 경로 안에 ../를 사용할 수 없다. 아마도 서비스하는 + 문서의 상대 URL을 지정할 수 있는 <code>virtual</code> attribute가 + 더 유용할 것이다. 경로를 /로 시작할 수 있지만, 포함하려는 + 파일이 서비스하는 파일과 같은 서버에 있어야 한다.</p> +<div class="example"><p><code> + <!--#include virtual="/footer.html" --> +</code></p></div> + + <p>나는 보통 이 두가지를 합쳐서 포함할 페이지 하단 파일에 + <code>LAST_MODIFIED</code> 지시어를 넣는다. 포함하려는 파일에도 + SSI 지시어가 나올 수 있으며, 이렇게 포함한 파일이 다른 파일을 + 포함하는 식으로 여러번 계속 포함할 수도 있다.</p> + + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="config" id="config">이외에 설정할 수 있는 것은?</a></h2> + + + <p>시간 형식 <code>config</code>(설정) 외에 두가지를 더 + <code>config</code>(설정)할 수 있다.</p> + + <p>보통 SSI 지시어가 잘못되면 다음과 같은 문구가 나온다</p> +<div class="example"><p><code> + [an error occurred while processing this directive] +</code></p></div> + + <p>이 문구를 변경하고 싶다면 <code>config</code> element의 + <code>errmsg</code> attribute를 사용하여 변경한다.</p> +<div class="example"><p><code> + <!--#config errmsg="[It appears that you don't know how to use SSI]" --> +</code></p></div> + + <p>사이트를 서비스하기 전에 모든 SSI 지시어 문제를 해결하여 + 사용자가 이런 문구를 보지 않길 바란다. (그렇지?)</p> + + <p>그리고 <code>sizefmt</code> attribute가 반환하는 파일크기 + 형식을 <code>config</code>(설정)할 수 있다. 바이트로 크기를 + 보여주려면 <code>bytes</code>, 적절히 Kb나 Mb로 크기를 + 보여주려면 <code>abbrev</code>를 사용한다.</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="exec" id="exec">명령어 실행하기</a></h2> + + + <p>나는 다음 달에 작은 CGI 프로그램과 SSI를 같이 사용하는 + 글을 쓸 예정이다. 지금은 <code>exec</code> element로 할 + 수 있는 다른 것들을 설명할 것이다. SSI는 실제 쉘을 (정확히는 + <code>/bin/sh</code>나 Win32를 사용한다면 DOS 쉘) 사용하여 + 명령어를 실행한다. 예를 들어, 다음은 디렉토리 목록을 보여준다.</p> +<div class="example"><p><code> + <pre><br /> + <!--#exec cmd="ls" --><br /> + </pre> +</code></p></div> + + <p>or, on Windows</p> +<div class="example"><p><code> + <pre><br /> + <!--#exec cmd="dir" --><br /> + </pre> +</code></p></div> + + <p><code>dir</code> 출력에 브라우저가 혼동할 + ``<<code>dir</code>>'' 문자열이 포함되있기때문에, + 윈도우즈에서 이 지시어를 사용하면 결과가 조금 이상할 것이다.</p> + + <p>이 기능은 <code>exec</code> 태그에 사용한 어떤 명령어라도 + 실행할 수 있기때문에 매우 위험하다. ``방명록''과 같이 사용자가 + 웹페이지 내용을 수정할 수 있는 환경이라면, 이 기능을 절대로 + 사용해선 안된다. <code>Options</code> 지시어에 + <code>IncludesNOEXEC</code> 아규먼트를 사용하여 SSI를 허용하지만 + <code>exec</code> 기능을 막을 수 있다.</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="advanced" id="advanced">고급 SSI 기법</a></h2> + + + <p>내용을 출력하는 기능 외에 아파치 SSI는 변수 설정이 가능하고, + 비교문과 조건문에 이 변수를 사용할 수 있다.</p> + +<h3><a name="caveat" id="caveat">경고</a></h3> + + <p>이 글에서 설명하는 대부분의 기능은 아파치 1.2 이후부터 + 사용할 수 있다. 물론, 아파치 1.2 이상을 사용하지 않는다면 + 아마도 빨리 업그레이드해야 한다. 해라. 지금 해라. 기다릴 + 것이다.</p> + + +<h3><a name="variables" id="variables">변수 설정</a></h3> + + <p><code>set</code> 지시어를 사용하여 나중에 사용할 변수를 + 설정할 수 있다. 앞으로 변수가 필요하기때문에 먼저 설명한다. + 문법은 다음과 같다.</p> +<div class="example"><p><code> + <!--#set var="name" value="Rich" --> +</code></p></div> + + <p>다음과 같이 값을 문자그대로 설정하지 않고 <a href="../env.html">환경변수</a>나 위에서 설명한 변수(예를 + 들어, <code>LAST_MODIFIED</code>)와 같이 다른 변수를 사용하여 + 변수값을 설정할 수도 있다. 이때 변수명 앞에 달러 표시($)를 + 붙여서 문자열이 아닌 변수임을 표시한다.</p> + + <div class="example"><p><code> <!--#set var="modified" value="$LAST_MODIFIED" --> + </code></p></div> + + <p>변수값에 달러 문자를 그대로 입력하려면 달러 표시 앞에 + 백슬래쉬를 사용한다.</p> +<div class="example"><p><code> + <!--#set var="cost" value="\$100" --> +</code></p></div> + + <p>마지막으로 긴 문자열 중간에 변수를 사용하는데 뒤에 있는 + 문자도 변수명으로 오인하여 혼동되는 경우, 변수명을 대괄호로 + 묶어서 확실히 한다. (좋은 예를 찾기 힘들지만, 무슨 말인지 + 이해하길 바란다.)</p> +<div class="example"><p><code> + <!--#set var="date" value="${DATE_LOCAL}_${DATE_GMT}" --> +</code></p></div> + + +<h3><a name="conditional" id="conditional">조건 표현식</a></h3> + + + <p>변수를 설정하고 비교할 수 있으니 조건문이 가능하다. 이제 + SSI가 일종의 간단한 프로그래밍언어가 된다. + <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>는 조건문을 만드는 <code>if</code>, + <code>elif</code>, <code>else</code>, <code>endif</code> + 구조를 제공한다. 실제 한 페이지로 여러 논리적인 페이지를 + 만들 수 있다.</p> + + <p>조건문 구조는 다음과 같다.</p> +<div class="example"><p><code> + <!--#if expr="test_condition" --><br /> + <!--#elif expr="test_condition" --><br /> + <!--#else --><br /> + <!--#endif --> +</code></p></div> + + <p><em>test_condition</em>에는 어떤 논리비교라도 사용할 + 수 있다. 값을 다른 값과 비교하거나, 특정 값이 ``참''인지 + 검사한다. (문자열이 비어있지 않으면 참이다.) 사용가능한 + 비교 연산자를 모두 보려면, <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> + 문서를 참고하라. 다음은 조건문을 사용한 몇가지 예제다.</p> + + <p>설정파일에 다음 줄을 추가한다.</p> +<div class="example"><p><code> + BrowserMatchNoCase macintosh Mac<br /> + BrowserMatchNoCase MSIE InternetExplorer +</code></p></div> + + <p>클라이언트가 맥킨토시에서 실행하는 Internet Explorer라면 + 환경변수 ``Mac''과 ``InternetExplorer'' 모두 참으로 설정한다.</p> + + <p>그리고 SSI 문서에 다음과 같이 적는다.</p> +<div class="example"><p><code> + <!--#if expr="${Mac} && ${InternetExplorer}" --><br /> + 여기에 사과문가 나온다<br /> + <!--#else --><br /> + 여기에 멋진 JavaScript 코드가 나온다<br /> + <!--#endif --> +</code></p></div> + + <p>내가 매킨토시 IE에 반감이 있는 것은 아니다. 나는 단지 + 저번주에 다른 곳에서는 문제가 없는 JavaScript 코드가 매킨토시 + IE에서는 동작하지 않아서 몇시간을 고생했다. 위는 임시 + 해결책이다.</p> + + <p>(직접 정의하였건 일반 환경변수이건) 어떤 변수라도 조건문에 + 사용할 수 있다. 아라치는 <code>SetEnvIf</code>나 다른 관련 + 지시어로 환경변수를 설정할 수 있기때문에 CGI 없이도 멋지게 + 동적인 내용을 만들 수 있다.</p> + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="conclusion" id="conclusion">결론</a></h2> + + <p>SSI는 확실히 CGI나 동적인 웹페이지를 생성하는 다른 기술을 + 대체할 수 없다. 그러나 많은 추가 작업없이 페이지에 동적인 + 내용을 조금 추가하기에는 훌륭한 방법이다.</p> +</div></div> +<div class="bottomlang"> +<p><span>가능한 언어: </span><a href="../en/howto/ssi.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../ja/howto/ssi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/ssi.html" title="Korean"> ko </a></p> +</div><div id="footer"> +<p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/howto/ssi.xml.ko b/docs/manual/howto/ssi.xml.ko new file mode 100644 index 0000000000..d32998f545 --- /dev/null +++ b/docs/manual/howto/ssi.xml.ko @@ -0,0 +1,427 @@ +<?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.12 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed 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. +--> + +<manualpage metafile="ssi.xml.meta"> +<parentdocument href="./">How-To / Tutorials</parentdocument> + +<title>아파치 투토리얼: Server Side Includes 소개</title> + +<summary> +<p>Server-side includes를 사용하여 HTML 문서에 동적인 내용을 +추가할 수 있다.</p> +</summary> + +<section id="related"><title>소개</title> + <related> + <modulelist> + <module>mod_include</module> + <module>mod_cgi</module> + <module>mod_expires</module> + </modulelist> + + <directivelist> + <directive module="core">Options</directive> + <directive module="mod_include">XBitHack</directive> + <directive module="mod_mime">AddType</directive> + <directive module="core">SetOutputFilter</directive> + <directive module="mod_setenvif">BrowserMatchNoCase</directive> + </directivelist> +</related> + + <p>이 글은 보통 SSI라고 부르는 Server Side Includes를 설명한다. + SSI가 가능하도록 서버를 설정하는 방법과 HTML 페이지에 동적인 + 내용을 추가하는 기본적인 SSI 사용법을 소개한다.</p> + + <p>이 글의 뒷부분은 SSI 지시어 조건문과 같은 고급기법을 + 설명한다.</p> + +</section> + +<section id="what"><title>SSI가 무엇인가?</title> + + <p>SSI (Server Side Includes)는 HTML 페이지에 사용하는 지시어로, + 페이지를 서비스할때 서버가 처리한다. SSI를 사용하면 CGI + 프로그램이나 다른 동적인 기술로 페이지 전체를 만들어서 + 서비스하지 않고도 HTML 페이지에 동적으로 생성한 내용을 추가할 + 수 있다.</p> + + <p>SSI를 사용할지 아니면 프로그램으로 페이지 전체를 생성할지 + 결정은 페이지에서 정적인 부분이 많은지와 페이지를 서비스할 + 때마다 어느정도를 다시 계산해야할지에 달렸다. SSI는 현재 + 시간과 같이 적은 정보를 추가하는데 좋다. 그러나 페이지를 + 서비스할때 페이지의 대부분을 생성해야 한다면 다른 방법을 + 찾아봐야 한다.</p> +</section> + +<section id="configuring"> +<title>SSI가 가능하도록 서버 설정하기</title> + + <p>서버가 SSI를 처리하려면 <code>httpd.conf</code> 파일이나 + <code>.htaccess</code> 파일에서 다음 지시어를 사용해야 한다.</p> +<example> + Options +Includes +</example> + + <p>그러면 아파치는 파일에서 SSI 지시어를 처리한다. 설정에는 + 보통 여러 <directive module="core">Options</directive> 지시어가 + 있고, 이 지시어들은 서로 덮어써서 무효로 만들다. 그래서 + 지시어를 맨마지막에 처리하기위해 보통 SSI를 원하는 특정 + 디렉토리에서 <code>Options</code>를 사용한다.</p> + + <p>모든 파일에서 SSI 지시어를 처리하는 것은 아니다. 아파치에게 + 어떤 파일을 처리할지 알려줘야 한다. 두가지 방법이 있다. + 하나는 다음과 같은 지시어로 <code>.shtml</code>과 같은 특정 + 파일 확장자를 가진 파일을 처리하는 방법이다.</p> +<example> + AddType text/html .shtml<br /> + AddOutputFilter INCLUDES .shtml +</example> + + <p>이 방법의 단점은 이미 있는 페이지에 SSI 지시어를 추가하는 + 경우 SSI 지시어를 처리하기위해 <code>.shtml</code> 확장자를 + 부여하기때문에 파일명과 이 페이지의 모든 링크를 변경해야 + 하는 점이다.</p> + + <p>다른 방법은 <directive module="mod_include">XBitHack</directive> + 지시어를 사용하는 방법이다.</p> +<example> + XBitHack on +</example> + + <p><directive module="mod_include">XBitHack</directive>는 + 실행권한이 있는 파일에서 SSI 지시어를 처리한다. 그래서 이미 + 있는 페이지에 SSI 지시어를 추가한다면 파일명을 변경하지 + 않고 <code>chmod</code>로 파일에 실행권한을 주면 된다.</p> +<example> + chmod +x pagename.html +</example> + + <p>하지 말아야 할 것 하나. 가끔 <code>.shtml</code> 파일명에 + 골치를 앓지말고 모든 <code>.html</code> 파일을 SSI 처리하라고 + 충고하는 사람이 있다. 이 사람들은 아마도 <directive + module="mod_include">XBitHack</directive>에 대해 모르는 + 것 같다. 명심할 점은 이렇게 하면 아파치는 파일에 SSI 지시어가 + 없더라도 클라이언트로 보내는 모든 파일을 살펴봐야 한다는 + 것이다. 성능이 매우 느려질 수 있으며, 좋은 생각이 아니다.</p> + + <p>물론 윈도우즈에서는 실행권한이란 것이 없기때문에 후자를 + 사용할 수 없다.</p> + + <p>내용이 동적이여서 계산하기 어렵기때문에 아파치 기본 설정은 + SSI 페이지의 최근수정일과 content length HTTP 헤더를 보내지 + 않는다. 그래서 문서를 캐쉬하지 못하고 클라이언트가 느끼는 + 성능이 떨어진다. 두가지 해결방법이 있다.</p> + + <ol> + <li><code>XBitHack Full</code> 설정은 사용한다. 그러면 + 아파치는 포함하는(include) 파일들의 수정일은 무시한체 + 원래 요청한 파일의 날짜만 보고 최근수정일을 알아낸다.</li> + + <li><module>mod_expires</module>에 있는 지시어를 사용하여 + 파일에 직접 만기일을 설정하면 브라우저와 프록시가 문서를 + 캐쉬할 수 있다.</li> + </ol> +</section> + +<section id="basic"><title>기본 SSI 지시어</title> + + <p>SSI 지시어의 사용법은 다음과 같다.</p> +<example> + <!--#element attribute=value attribute=value ... --> +</example> + + <p>HTML 주석같이 생겼기때문에 SSI 기능을 가동하지 않아도 + HTML 소스에는 나오지만 브라우저는 무시한다. SSI를 올바로 + 설정하면 지시어를 결과값으로 바꾼다.</p> + + <p>element는 다음중 하나다. 다음 회에 더 자세히 설명할 것이다. + 지금은 SSI로 할 수 있는 몇가지 예를 보인다</p> + +<section id="todaysdate"><title>오늘 날짜</title> + +<example> + <!--#echo var="DATE_LOCAL" --> +</example> + + <p><code>echo</code> element는 변수값을 그대로 출력한다. + CGI 프로그램에 제공하는 환경변수들 외에도 여러 표준 변수가 + 있다. 또, <code>set</code> element를 사용하여 직접 변수를 + 정의할 수도 있다.</p> + + <p>날짜 출력 형식이 마음에 들지 않는다면, 다음과 같이 + <code>config</code> element의 <code>timefmt</code> attribute를 + 사용한다.</p> + +<example> + <!--#config timefmt="%A %B %d, %Y" --><br /> + Today is <!--#echo var="DATE_LOCAL" --> +</example> +</section> + +<section id="lastmodified"><title>파일의 수정일</title> + +<example> + 이 문서는 <!--#flastmod file="index.html" -->에 마지막으로 수정되었다 +</example> + + <p>이 element도 <code>timefmt</code> 형식 설정에 달렸다.</p> +</section> + +<section id="cgi"><title>CGI 프로그램 결과를 포함하기</title> + + <p>일반적인 SSI 사용법중 하나로, 많이들 애용하는 ``방문수 + 카운터'' 같은 CGI 프로그램 결과를 출력한다.</p> + +<example> + <!--#include virtual="/cgi-bin/counter.pl" --> +</example> + +</section> +</section> + +<section id="additionalexamples"> +<title>추가 예제</title> + + <p>다음은 HTML 문서에 사용할 수 있는 몇가지 SSI 예제다.</p> + +<section id="docmodified"><title>이 문서가 언제 마지막으로 +수정되었나?</title> + + <p>앞에서 SSI를 사용하여 사용자에게 문서의 최근수정일을 + 알릴 수 있다고 말했다. 그러나 실제 방법은 알려주지 않았다. + 다음 코드를 HTML 문서에 사용하면 페이지에 시간 기록을 남긴다. + 물론 위에서 설명한대로 SSI가 올바로 작동해야 한다.</p> +<example> + <!--#config timefmt="%A %B %d, %Y" --><br /> + 이 문서는 <!--#flastmod file="ssi.shtml" -->에 마지막으로 수정되었다; +</example> + + <p>물론 <code>ssi.shtml</code>대신 원하는 실제 파일명을 + 사용한다. 아무 페이지에라도 붙여넣을 수 있는 범용코드를 + 원한다면, 파일명 대신 <code>LAST_MODIFIED</code> 변수를 + 사용한다.</p> +<example> + <!--#config timefmt="%D" --><br /> + This file last modified <!--#echo var="LAST_MODIFIED" --> +</example> + + <p><code>timefmt</code> 형식에 대한 자세한 정보는 검색엔진에서 + <code>strftime</code>을 찾아봐라. 문법은 같다.</p> +</section> + +<section id="standard-footer"> +<title>표준 페이지 하단을 포함하기</title> + + <p>여러 페이지가 있는 사이트를 관리한다면 페이지 전체를 + 수정하는 것은, 특히 페이지들이 표준 외관을 가지도록 수정하는 + 것은 정말로 괴롭다.</p> + + <p>페이지 상단(header)과 하단(footer)을 파일로 포함하여 + 이런 수정의 부담을 덜 수 있다. 모든 페이지에서 + <code>include</code> SSI 명령어를 사용하여 페이지 하단 파일 + 하나를 포함하면 된다. <code>include</code> element의 + <code>file</code> attribute나 <code>virtual</code> attribute로 + 포함할 파일을 지정한다. <code>file</code> attribute는 <em>현재 + 디렉토리에 상대적인</em> 파일경로다. 즉, (/로 시작하는) + 절대파일경로나 경로 안에 ../를 사용할 수 없다. 아마도 서비스하는 + 문서의 상대 URL을 지정할 수 있는 <code>virtual</code> attribute가 + 더 유용할 것이다. 경로를 /로 시작할 수 있지만, 포함하려는 + 파일이 서비스하는 파일과 같은 서버에 있어야 한다.</p> +<example> + <!--#include virtual="/footer.html" --> +</example> + + <p>나는 보통 이 두가지를 합쳐서 포함할 페이지 하단 파일에 + <code>LAST_MODIFIED</code> 지시어를 넣는다. 포함하려는 파일에도 + SSI 지시어가 나올 수 있으며, 이렇게 포함한 파일이 다른 파일을 + 포함하는 식으로 여러번 계속 포함할 수도 있다.</p> +</section> + +</section> + +<section id="config"> +<title>이외에 설정할 수 있는 것은?</title> + + <p>시간 형식 <code>config</code>(설정) 외에 두가지를 더 + <code>config</code>(설정)할 수 있다.</p> + + <p>보통 SSI 지시어가 잘못되면 다음과 같은 문구가 나온다</p> +<example> + [an error occurred while processing this directive] +</example> + + <p>이 문구를 변경하고 싶다면 <code>config</code> element의 + <code>errmsg</code> attribute를 사용하여 변경한다.</p> +<example> + <!--#config errmsg="[It appears that you don't know how to use SSI]" --> +</example> + + <p>사이트를 서비스하기 전에 모든 SSI 지시어 문제를 해결하여 + 사용자가 이런 문구를 보지 않길 바란다. (그렇지?)</p> + + <p>그리고 <code>sizefmt</code> attribute가 반환하는 파일크기 + 형식을 <code>config</code>(설정)할 수 있다. 바이트로 크기를 + 보여주려면 <code>bytes</code>, 적절히 Kb나 Mb로 크기를 + 보여주려면 <code>abbrev</code>를 사용한다.</p> + </section> + +<section id="exec"> + <title>명령어 실행하기</title> + + <p>나는 다음 달에 작은 CGI 프로그램과 SSI를 같이 사용하는 + 글을 쓸 예정이다. 지금은 <code>exec</code> element로 할 + 수 있는 다른 것들을 설명할 것이다. SSI는 실제 쉘을 (정확히는 + <code>/bin/sh</code>나 Win32를 사용한다면 DOS 쉘) 사용하여 + 명령어를 실행한다. 예를 들어, 다음은 디렉토리 목록을 보여준다.</p> +<example> + <pre><br /> + <!--#exec cmd="ls" --><br /> + </pre> +</example> + + <p>or, on Windows</p> +<example> + <pre><br /> + <!--#exec cmd="dir" --><br /> + </pre> +</example> + + <p><code>dir</code> 출력에 브라우저가 혼동할 + ``<<code>dir</code>>'' 문자열이 포함되있기때문에, + 윈도우즈에서 이 지시어를 사용하면 결과가 조금 이상할 것이다.</p> + + <p>이 기능은 <code>exec</code> 태그에 사용한 어떤 명령어라도 + 실행할 수 있기때문에 매우 위험하다. ``방명록''과 같이 사용자가 + 웹페이지 내용을 수정할 수 있는 환경이라면, 이 기능을 절대로 + 사용해선 안된다. <code>Options</code> 지시어에 + <code>IncludesNOEXEC</code> 아규먼트를 사용하여 SSI를 허용하지만 + <code>exec</code> 기능을 막을 수 있다.</p> + </section> + +<section id="advanced"> +<title>고급 SSI 기법</title> + + <p>내용을 출력하는 기능 외에 아파치 SSI는 변수 설정이 가능하고, + 비교문과 조건문에 이 변수를 사용할 수 있다.</p> + +<section id="caveat"><title>경고</title> + + <p>이 글에서 설명하는 대부분의 기능은 아파치 1.2 이후부터 + 사용할 수 있다. 물론, 아파치 1.2 이상을 사용하지 않는다면 + 아마도 빨리 업그레이드해야 한다. 해라. 지금 해라. 기다릴 + 것이다.</p> +</section> + +<section id="variables"><title>변수 설정</title> + + <p><code>set</code> 지시어를 사용하여 나중에 사용할 변수를 + 설정할 수 있다. 앞으로 변수가 필요하기때문에 먼저 설명한다. + 문법은 다음과 같다.</p> +<example> + <!--#set var="name" value="Rich" --> +</example> + + <p>다음과 같이 값을 문자그대로 설정하지 않고 <a + href="../env.html">환경변수</a>나 위에서 설명한 변수(예를 + 들어, <code>LAST_MODIFIED</code>)와 같이 다른 변수를 사용하여 + 변수값을 설정할 수도 있다. 이때 변수명 앞에 달러 표시($)를 + 붙여서 문자열이 아닌 변수임을 표시한다.</p> + + <example> <!--#set var="modified" value="$LAST_MODIFIED" --> + </example> + + <p>변수값에 달러 문자를 그대로 입력하려면 달러 표시 앞에 + 백슬래쉬를 사용한다.</p> +<example> + <!--#set var="cost" value="\$100" --> +</example> + + <p>마지막으로 긴 문자열 중간에 변수를 사용하는데 뒤에 있는 + 문자도 변수명으로 오인하여 혼동되는 경우, 변수명을 대괄호로 + 묶어서 확실히 한다. (좋은 예를 찾기 힘들지만, 무슨 말인지 + 이해하길 바란다.)</p> +<example> + <!--#set var="date" value="${DATE_LOCAL}_${DATE_GMT}" --> +</example> +</section> + +<section id="conditional"> +<title>조건 표현식</title> + + <p>변수를 설정하고 비교할 수 있으니 조건문이 가능하다. 이제 + SSI가 일종의 간단한 프로그래밍언어가 된다. + <module>mod_include</module>는 조건문을 만드는 <code>if</code>, + <code>elif</code>, <code>else</code>, <code>endif</code> + 구조를 제공한다. 실제 한 페이지로 여러 논리적인 페이지를 + 만들 수 있다.</p> + + <p>조건문 구조는 다음과 같다.</p> +<example> + <!--#if expr="test_condition" --><br /> + <!--#elif expr="test_condition" --><br /> + <!--#else --><br /> + <!--#endif --> +</example> + + <p><em>test_condition</em>에는 어떤 논리비교라도 사용할 + 수 있다. 값을 다른 값과 비교하거나, 특정 값이 ``참''인지 + 검사한다. (문자열이 비어있지 않으면 참이다.) 사용가능한 + 비교 연산자를 모두 보려면, <module>mod_include</module> + 문서를 참고하라. 다음은 조건문을 사용한 몇가지 예제다.</p> + + <p>설정파일에 다음 줄을 추가한다.</p> +<example> + BrowserMatchNoCase macintosh Mac<br /> + BrowserMatchNoCase MSIE InternetExplorer +</example> + + <p>클라이언트가 맥킨토시에서 실행하는 Internet Explorer라면 + 환경변수 ``Mac''과 ``InternetExplorer'' 모두 참으로 설정한다.</p> + + <p>그리고 SSI 문서에 다음과 같이 적는다.</p> +<example> + <!--#if expr="${Mac} && ${InternetExplorer}" --><br /> + 여기에 사과문가 나온다<br /> + <!--#else --><br /> + 여기에 멋진 JavaScript 코드가 나온다<br /> + <!--#endif --> +</example> + + <p>내가 매킨토시 IE에 반감이 있는 것은 아니다. 나는 단지 + 저번주에 다른 곳에서는 문제가 없는 JavaScript 코드가 매킨토시 + IE에서는 동작하지 않아서 몇시간을 고생했다. 위는 임시 + 해결책이다.</p> + + <p>(직접 정의하였건 일반 환경변수이건) 어떤 변수라도 조건문에 + 사용할 수 있다. 아라치는 <code>SetEnvIf</code>나 다른 관련 + 지시어로 환경변수를 설정할 수 있기때문에 CGI 없이도 멋지게 + 동적인 내용을 만들 수 있다.</p> +</section> +</section> + +<section id="conclusion"><title>결론</title> + + <p>SSI는 확실히 CGI나 동적인 웹페이지를 생성하는 다른 기술을 + 대체할 수 없다. 그러나 많은 추가 작업없이 페이지에 동적인 + 내용을 조금 추가하기에는 훌륭한 방법이다.</p> +</section> + +</manualpage> diff --git a/docs/manual/howto/ssi.xml.meta b/docs/manual/howto/ssi.xml.meta index 647cb10813..0427d2dcd3 100644 --- a/docs/manual/howto/ssi.xml.meta +++ b/docs/manual/howto/ssi.xml.meta @@ -8,5 +8,6 @@ <variants> <variant>en</variant> <variant>ja</variant> + <variant>ko</variant> </variants> </metafile> diff --git a/docs/manual/index.html.ko.euc-kr b/docs/manual/index.html.ko.euc-kr index fb3513b606..565cfe4b20 100644 --- a/docs/manual/index.html.ko.euc-kr +++ b/docs/manual/index.html.ko.euc-kr @@ -66,7 +66,7 @@ </div></td><td class="col3"><div class="category"><h2><a name="howto" id="howto">How-To / 투토리얼</a></h2> <ul><li><a href="howto/auth.html">인증, 권한부여, 접근제어</a></li> -<li><a href="howto/cgi.html">CGI: 동적 내용 생성</a></li> +<li><a href="howto/cgi.html">CGI: 동적 페이지 생성</a></li> <li><a href="howto/htaccess.html">.htaccess 파일</a></li> <li><a href="howto/ssi.html">Server Side Includes (SSI)</a></li> <li><a href="howto/public_html.html">사용자별 웹디렉토리 diff --git a/docs/manual/index.xml.ko b/docs/manual/index.xml.ko index f385df2a64..78a9d45e09 100644 --- a/docs/manual/index.xml.ko +++ b/docs/manual/index.xml.ko @@ -65,7 +65,7 @@ <category id="howto"><title>How-To / 투토리얼</title> <page href="howto/auth.html">인증, 권한부여, 접근제어</page> - <page href="howto/cgi.html">CGI: 동적 내용 생성</page> + <page href="howto/cgi.html">CGI: 동적 페이지 생성</page> <page href="howto/htaccess.html">.htaccess 파일</page> <page href="howto/ssi.html">Server Side Includes (SSI)</page> <page href="howto/public_html.html">사용자별 웹디렉토리 diff --git a/docs/manual/logs.html.ko.euc-kr b/docs/manual/logs.html.ko.euc-kr index 5d13512a3c..7d2ef4feae 100644 --- a/docs/manual/logs.html.ko.euc-kr +++ b/docs/manual/logs.html.ko.euc-kr @@ -40,7 +40,7 @@ <div class="section"> <h2><a name="security" id="security">보안 경고</a></h2> - + <p>누군가에게 아파치의 로그파일이 있는 디렉토리에 쓰기권한이 있다면 (보통 root) 서버를 실행하는 uid를 거의 확실히 얻을 수 있다. 이를 고려하지않고 로그가 저장된 디렉토리에 쓰기권한을 @@ -53,9 +53,9 @@ <div class="section"> <h2><a name="errorlog" id="errorlog">오류 로그 (Error Log)</a></h2> - + <table class="related"><tr><th>관련된 모듈</th><th>관련된 지시어</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code></li><li><code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code></li></ul></td></tr></table> - + <p><code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> 지시어는 가장 중요한 로그파일인 서버 오류 로그의 이름과 위치를 지정한다. 아파치 웹서버는 이 파일에 진단정보와 요청을 처리하는 도중 @@ -68,17 +68,17 @@ <code>error.log</code>) 파일에 기록된다. 유닉스 시스템에서 서버는 오류를 <code>syslog</code>나 <a href="#piped">파이프를 사용하여 다른 프로그램</a>으로 보낼 수도 있다.</p> - + <p>오류 로그의 형식은 상대적으로 자유롭고 자세하다. 그러나 대부분의 오류 로그 항목에 공통적으로 나오는 정보가 있다. 예를 들어, 항목은 보통 다음과 같다.</p> - + <div class="example"><p><code> [Wed Oct 11 14:32:52 2000] [error] [client 127.0.0.1] client denied by server configuration: /export/home/live/ap/htdocs/test </code></p></div> - + <p>로그 항목에서 첫번째 항목은 날짜와 시간이다. 두번째 항목은 보고하는 오류의 심각성을 나타낸다. <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> 지시어로 오류 로그에 기록되는 오류의 심각성을 제한할 수 있다. 세번째 항목은 @@ -98,10 +98,10 @@ 상태코드가 403인 접근 로그 항목이 생긴다. 접근 로그는 사용자정의할 수 있으므로 이 파일을 참고하여 오류 상황에 대한 추가정보를 얻을 수 있다.</p> - + <p>검사할때 어떤 문제가 생기는지 오류 로그를 계속 살펴보는 것이 좋다. 유닉스 시스템에서 다음과 같이 한다:</p> - + <div class="example"><p><code> tail -f error_log </code></p></div> @@ -109,9 +109,9 @@ <div class="section"> <h2><a name="accesslog" id="accesslog">접근 로그 (Access Log)</a></h2> - + <table class="related"><tr><th>관련된 모듈</th><th>관련된 지시어</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li></ul></td></tr></table> - + <p>서버 접근 로그는 서버가 처리하는 모든 요청을 기록한다. <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> 지시어는 접근 로그의 위치와 내용을 지정한다. <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code> 지시어를 @@ -125,7 +125,7 @@ 정보와 로그를 분석하는 소프트웨어에 대해서는 <a href="http://dmoz.org/Computers/Software/Internet/Site_Management/Log_analysis/">Open Directory</a>나 <a href="http://dir.yahoo.com/Computers_and_Internet/Software/Internet/World_Wide_Web/Servers/Log_Analysis_Tools/">Yahoo</a>를 참고하라.</p> - + <p>아파치 웹서버는 이전부터 mod_log_referer, mod_log_agent, <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> 같은 모듈과 지시어를 사용하여 접근 로그를 다루었다. 지금은 @@ -137,17 +137,17 @@ 지정한다. 다음 절에 예를 들었다. 형식문자열에 사용가능한 모든 내용을 알려면 <code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code> <a href="mod/mod_log_config.html#formats">형식문자열</a>을 참고하라.</p> - + <h3><a name="common" id="common">Common 로그 형식</a></h3> - + <p>접근 로그의 전형적인 설정은 다음과 같다.</p> <div class="example"><p><code> LogFormat "%h %l %u %t \"%r\" %>s %b" common<br /> CustomLog logs/access_log common </code></p></div> - + <p>그러면 지정한 로그 형식문자열을 <em>별명</em> <code>common</code>으로 정의한다. 형식문자열은 퍼센트 지시어들로 구성되며, 각각은 어떤 정보를 기록할지 알린다. @@ -161,7 +161,7 @@ 지시어는 정의한 <em>별명</em>을 사용하는 새로운 로그파일을 만든다. 접근 로그의 파일명이 슬래쉬로 시작하지않으면 <code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code>의 상대경로이다.</p> - + <p>앞의 설정은 공통로그형식(Common Log Format, CLF)이라는 형식으로 로그 항목을 기록한다. 여러 다른 웹서버들도 이런 표준 형식으로 로그를 만들며, 여러 로그 분석 프로그램에서 @@ -171,9 +171,9 @@ 127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET /apache_pb.gif HTTP/1.0" 200 2326 </code></p></div> - + <p>이제 로그 항목의 각 부분을 설명한다.</p> - + <dl> <dt><code>127.0.0.1</code> (<code>%h</code>)</dt> @@ -261,10 +261,10 @@ <code>%B</code>를 사용한다.</dd> </dl> - + <h3><a name="combined" id="combined">Combined 로그 형식</a></h3> - + <p>자주 사용되는 다른 형식문자열은 결합된로그형식(Combined Log Format)이다. 다음과 같이 사용한다.</p> @@ -279,7 +279,7 @@ <code>%{<em>header</em>}i</code>를 사용한다. 여기서 <em>header</em> 자리에 HTTP 요청 헤더 이름이 나올 수 있다. 이 형식의 접근 로그는 다음과 같다:</p> - + <div class="example"><p><code> 127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET /apache_pb.gif HTTP/1.0" 200 2326 @@ -288,7 +288,7 @@ </code></p></div> <p>추가된 항목은:</p> - + <dl> <dt><code>"http://www.example.com/start.html"</code> (<code>\"%{Referer}i\"</code>)</dt> @@ -305,10 +305,10 @@ 자신에 대해 알리는 식별정보이다.</dd> </dl> - + <h3><a name="multiple" id="multiple">여러 접근 로그</a></h3> - + <p>설정파일에 여러 <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> 지시어를 사용하면 접근 로그가 여러개 만들어진다. 예를 들어, 다음 설정은 세가지 접근 로그를 만든다. 첫번째는 기본 CLF 정보를 @@ -328,10 +328,10 @@ 별명을 정의할 필요는 없음을 보여준다. 대신 <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> 지시어에 직접 로그 형식을 지정할 수 있다.</p> - + <h3><a name="conditional" id="conditional">조건부 로그</a></h3> - + <p>클라이언트 요청의 성격에 따라 해당 항목을 접근 로그에 기록하지않고 싶을 때가 있다. <a href="env.html">환경변수</a>를 사용하면 쉽게 해결된다. 먼저, 클라이언트가 특정 조건을 @@ -368,7 +368,7 @@ <div class="section"> <h2><a name="rotation" id="rotation">로그 순환 (Log Rotation)</a></h2> - + <p>조금 바쁜 서버조차도 로그파일에 저장되는 정보량은 매우 많다. 접속 로그는 보통 만번 요청당 1MB 이상 증가한다. 결과적으로 기존의 로그를 옮기거나 지우는 방법으로 로그를 주기적으로 @@ -398,7 +398,7 @@ <div class="section"> <h2><a name="piped" id="piped">로그를 파이프로 보내기</a></h2> - + <p>아파치 웹서버는 오류 로그와 접근 로그를 파일에 직접 쓰지않고 파이프를 통해 다른 프로세스로 보낼 수 있다. 이 기능을 사용하면 서버에 코드를 추가하지않고도 매우 유연하게 @@ -427,7 +427,7 @@ CustomLog "|/usr/local/apache/bin/rotatelogs /var/log/access_log 86400" common </code></p></div> - + <p>다른 사이트에 <a href="http://www.cronolog.org/">cronolog</a>라는 비슷하지만 훨씬 더 유연한 로그 순환 프로그램이 있다.</p> @@ -438,7 +438,7 @@ <div class="section"> <h2><a name="virtualhost" id="virtualhost">가상호스트</a></h2> - + <p>많은 <a href="vhosts/">가상호스트</a>가 있는 서버를 운영할때 여러가지 방법으로 로그파일을 다룰 수 있다. 먼저, 호스트가 한개인 서버와 같이 로그를 사용할 수 있다. <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> 섹션이 @@ -474,12 +474,12 @@ <div class="section"> <h2><a name="other" id="other">다른 로그파일</a></h2> - + <table class="related"><tr><th>관련된 모듈</th><th>관련된 지시어</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritelog">RewriteLog</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriteloglevel">RewriteLogLevel</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptlog">ScriptLog</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptlogbuffer">ScriptLogBuffer</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptloglength">ScriptLogLength</a></code></li></ul></td></tr></table> - + <h3><a name="pidfile" id="pidfile">PID 파일</a></h3> - + <p>아파치 웹서버는 시작할때 <code>logs/httpd.pid</code> 파일에 부모 httpd 프로세스의 process id를 저장한다. 이 파일명은 <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> @@ -489,19 +489,19 @@ 정보는 <a href="stopping.html">중단과 재시작</a> 페이지를 참고하라.</p> - + <h3><a name="scriptlog" id="scriptlog">스크립트 로그</a></h3> - + <p>디버깅을 돕기위해 <code class="directive"><a href="./mod/mod_cgi.html#scriptlog">ScriptLog</a></code> 지시어를 사용하여 CGI 스크립트의 입력과 출력을 기록할 수 있다. 이 지시어는 오직 테스트용으로만 사용해야 한다. 실제 사용하는 서버에서 사용하면 안된다. 더 자세한 정보는 <a href="mod/mod_cgi.html">mod_cgi</a> 문서를 참고하라.</p> - + <h3><a name="rewritelog" id="rewritelog">재작성 로그</a></h3> - + <p><a href="mod/mod_rewrite.html">mod_rewrite</a>의 강력하고 복잡한 기능을 사용한다면 디버깅을 위해 거의 항상 <code class="directive"><a href="./mod/mod_rewrite.html#rewritelog">RewriteLog</a></code>를 사용할 필요가 있다. 이 로그파일은 재작성 엔진이 어떻게 요청을 변환하는지에 diff --git a/docs/manual/logs.xml.ko b/docs/manual/logs.xml.ko index 21f1cb6fa5..ae4146fea9 100644 --- a/docs/manual/logs.xml.ko +++ b/docs/manual/logs.xml.ko @@ -32,7 +32,7 @@ <section id="security"> <title>보안 경고</title> - + <p>누군가에게 아파치의 로그파일이 있는 디렉토리에 쓰기권한이 있다면 (보통 root) 서버를 실행하는 uid를 거의 확실히 얻을 수 있다. 이를 고려하지않고 로그가 저장된 디렉토리에 쓰기권한을 @@ -43,17 +43,17 @@ 기록된다. 그래서 악의가 있는 클라이언트가 로그파일에 제어문자를 넣을 수 있으므로, 로그를 다룰때는 주의해야 한다.</p> </section> - + <section id="errorlog"> <title>오류 로그 (Error Log)</title> - + <related> <directivelist> <directive module="core">ErrorLog</directive> <directive module="core">LogLevel</directive> </directivelist> </related> - + <p><directive module="core">ErrorLog</directive> 지시어는 가장 중요한 로그파일인 서버 오류 로그의 이름과 위치를 지정한다. 아파치 웹서버는 이 파일에 진단정보와 요청을 처리하는 도중 @@ -66,17 +66,17 @@ <code>error.log</code>) 파일에 기록된다. 유닉스 시스템에서 서버는 오류를 <code>syslog</code>나 <a href="#piped">파이프를 사용하여 다른 프로그램</a>으로 보낼 수도 있다.</p> - + <p>오류 로그의 형식은 상대적으로 자유롭고 자세하다. 그러나 대부분의 오류 로그 항목에 공통적으로 나오는 정보가 있다. 예를 들어, 항목은 보통 다음과 같다.</p> - + <example> [Wed Oct 11 14:32:52 2000] [error] [client 127.0.0.1] client denied by server configuration: /export/home/live/ap/htdocs/test </example> - + <p>로그 항목에서 첫번째 항목은 날짜와 시간이다. 두번째 항목은 보고하는 오류의 심각성을 나타낸다. <directive module="core">LogLevel</directive> 지시어로 오류 로그에 @@ -97,18 +97,18 @@ 상태코드가 403인 접근 로그 항목이 생긴다. 접근 로그는 사용자정의할 수 있으므로 이 파일을 참고하여 오류 상황에 대한 추가정보를 얻을 수 있다.</p> - + <p>검사할때 어떤 문제가 생기는지 오류 로그를 계속 살펴보는 것이 좋다. 유닉스 시스템에서 다음과 같이 한다:</p> - + <example> tail -f error_log </example> </section> - + <section id="accesslog"> <title>접근 로그 (Access Log)</title> - + <related> <modulelist> <module>mod_log_config</module> @@ -120,7 +120,7 @@ <directive module="mod_setenvif">SetEnvIf</directive> </directivelist> </related> - + <p>서버 접근 로그는 서버가 처리하는 모든 요청을 기록한다. <directive module="mod_log_config">CustomLog</directive> 지시어는 접근 로그의 위치와 내용을 지정한다. <directive @@ -136,7 +136,7 @@ href="http://dmoz.org/Computers/Software/Internet/Site_Management/Log_analysis/">Open Directory</a>나 <a href="http://dir.yahoo.com/Computers_and_Internet/Software/Internet/World_Wide_Web/Servers/Log_Analysis_Tools/">Yahoo</a>를 참고하라.</p> - + <p>아파치 웹서버는 이전부터 mod_log_referer, mod_log_agent, <directive module="mod_log_config">CustomLog</directive> 같은 모듈과 지시어를 사용하여 접근 로그를 다루었다. 지금은 @@ -149,17 +149,17 @@ 모든 내용을 알려면 <module>mod_log_config</module> <a href="mod/mod_log_config.html#formats">형식문자열</a>을 참고하라.</p> - + <section id="common"> <title>Common 로그 형식</title> - + <p>접근 로그의 전형적인 설정은 다음과 같다.</p> <example> LogFormat "%h %l %u %t \"%r\" %>s %b" common<br /> CustomLog logs/access_log common </example> - + <p>그러면 지정한 로그 형식문자열을 <em>별명</em> <code>common</code>으로 정의한다. 형식문자열은 퍼센트 지시어들로 구성되며, 각각은 어떤 정보를 기록할지 알린다. @@ -173,7 +173,7 @@ 지시어는 정의한 <em>별명</em>을 사용하는 새로운 로그파일을 만든다. 접근 로그의 파일명이 슬래쉬로 시작하지않으면 <directive module="core">ServerRoot</directive>의 상대경로이다.</p> - + <p>앞의 설정은 공통로그형식(Common Log Format, CLF)이라는 형식으로 로그 항목을 기록한다. 여러 다른 웹서버들도 이런 표준 형식으로 로그를 만들며, 여러 로그 분석 프로그램에서 @@ -183,9 +183,9 @@ 127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET /apache_pb.gif HTTP/1.0" 200 2326 </example> - + <p>이제 로그 항목의 각 부분을 설명한다.</p> - + <dl> <dt><code>127.0.0.1</code> (<code>%h</code>)</dt> @@ -275,10 +275,10 @@ <code>%B</code>를 사용한다.</dd> </dl> </section> - + <section id="combined"> <title>Combined 로그 형식</title> - + <p>자주 사용되는 다른 형식문자열은 결합된로그형식(Combined Log Format)이다. 다음과 같이 사용한다.</p> @@ -293,7 +293,7 @@ <code>%{<em>header</em>}i</code>를 사용한다. 여기서 <em>header</em> 자리에 HTTP 요청 헤더 이름이 나올 수 있다. 이 형식의 접근 로그는 다음과 같다:</p> - + <example> 127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET /apache_pb.gif HTTP/1.0" 200 2326 @@ -302,7 +302,7 @@ </example> <p>추가된 항목은:</p> - + <dl> <dt><code>"http://www.example.com/start.html"</code> (<code>\"%{Referer}i\"</code>)</dt> @@ -319,10 +319,10 @@ 자신에 대해 알리는 식별정보이다.</dd> </dl> </section> - + <section id="multiple"> <title>여러 접근 로그</title> - + <p>설정파일에 여러 <directive module="mod_log_config">CustomLog</directive> 지시어를 사용하면 접근 로그가 여러개 만들어진다. 예를 들어, 다음 @@ -346,10 +346,10 @@ module="mod_log_config">CustomLog</directive> 지시어에 직접 로그 형식을 지정할 수 있다.</p> </section> - + <section id="conditional"> <title>조건부 로그</title> - + <p>클라이언트 요청의 성격에 따라 해당 항목을 접근 로그에 기록하지않고 싶을 때가 있다. <a href="env.html">환경변수</a>를 사용하면 쉽게 해결된다. 먼저, 클라이언트가 특정 조건을 @@ -384,10 +384,10 @@ 제외하고 로그파일을 분석하는 것이 더 쉽다.</p> </section> </section> - + <section id="rotation"> <title>로그 순환 (Log Rotation)</title> - + <p>조금 바쁜 서버조차도 로그파일에 저장되는 정보량은 매우 많다. 접속 로그는 보통 만번 요청당 1MB 이상 증가한다. 결과적으로 기존의 로그를 옮기거나 지우는 방법으로 로그를 주기적으로 @@ -416,10 +416,10 @@ <p>로그를 순환하는 다른 방법은 다음 절에서 설명할 <a href="#piped">파이프 로그</a>를 사용하는 것이다.</p> </section> - + <section id="piped"> <title>로그를 파이프로 보내기</title> - + <p>아파치 웹서버는 오류 로그와 접근 로그를 파일에 직접 쓰지않고 파이프를 통해 다른 프로세스로 보낼 수 있다. 이 기능을 사용하면 서버에 코드를 추가하지않고도 매우 유연하게 @@ -448,7 +448,7 @@ CustomLog "|/usr/local/apache/bin/rotatelogs /var/log/access_log 86400" common </example> - + <p>다른 사이트에 <a href="http://www.cronolog.org/">cronolog</a>라는 비슷하지만 훨씬 더 유연한 로그 순환 프로그램이 있다.</p> @@ -457,10 +457,10 @@ 나중에 처리하는 등의 더 간단한 방법이 가능한 경우 사용해서는 안된다.</p> </section> - + <section id="virtualhost"> <title>가상호스트</title> - + <p>많은 <a href="vhosts/">가상호스트</a>가 있는 서버를 운영할때 여러가지 방법으로 로그파일을 다룰 수 있다. 먼저, 호스트가 한개인 서버와 같이 로그를 사용할 수 있다. <directive @@ -494,10 +494,10 @@ 기록한다. 나중에 <a href="programs/other.html">split-logfile</a> 같은 프로그램으로 접근 로그를 가상호스별로 나눌 수 있다.</p> </section> - + <section id="other"> <title>다른 로그파일</title> - + <related> <modulelist> <module>mod_cgi</module> @@ -512,10 +512,10 @@ <directive module="mod_cgi">ScriptLogLength</directive> </directivelist> </related> - + <section id="pidfile"> <title>PID 파일</title> - + <p>아파치 웹서버는 시작할때 <code>logs/httpd.pid</code> 파일에 부모 httpd 프로세스의 process id를 저장한다. 이 파일명은 <directive module="mpm_common">PidFile</directive> @@ -525,10 +525,10 @@ 정보는 <a href="stopping.html">중단과 재시작</a> 페이지를 참고하라.</p> </section> - + <section id="scriptlog"> <title>스크립트 로그</title> - + <p>디버깅을 돕기위해 <directive module="mod_cgi">ScriptLog</directive> 지시어를 사용하여 CGI 스크립트의 입력과 출력을 기록할 수 있다. 이 지시어는 @@ -536,10 +536,10 @@ 사용하면 안된다. 더 자세한 정보는 <a href="mod/mod_cgi.html">mod_cgi</a> 문서를 참고하라.</p> </section> - + <section id="rewritelog"> <title>재작성 로그</title> - + <p><a href="mod/mod_rewrite.html">mod_rewrite</a>의 강력하고 복잡한 기능을 사용한다면 디버깅을 위해 거의 항상 <directive module="mod_rewrite">RewriteLog</directive>를 사용할 필요가 diff --git a/docs/manual/misc/index.html b/docs/manual/misc/index.html index 5f97bff8c6..5b7bb86fb2 100644 --- a/docs/manual/misc/index.html +++ b/docs/manual/misc/index.html @@ -1,3 +1,7 @@ URI: index.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: index.html.ko.euc-kr +Content-Language: ko +Content-type: text/html; charset=EUC-KR diff --git a/docs/manual/misc/index.html.en b/docs/manual/misc/index.html.en index 3dcb788275..3ef158b807 100644 --- a/docs/manual/misc/index.html.en +++ b/docs/manual/misc/index.html.en @@ -18,7 +18,8 @@ <div id="path"> <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.1</a></div><div id="page-content"><div id="preamble"><h1>Apache Miscellaneous Documentation</h1> <div class="toplang"> -<p><span>Available Languages: </span><a href="../en/misc/" title="English"> en </a></p> +<p><span>Available Languages: </span><a href="../en/misc/" title="English"> en </a> | +<a href="../ko/misc/" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> @@ -71,7 +72,8 @@ </div> </div> <div class="bottomlang"> -<p><span>Available Languages: </span><a href="../en/misc/" title="English"> en </a></p> +<p><span>Available Languages: </span><a href="../en/misc/" title="English"> en </a> | +<a href="../ko/misc/" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> <p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> diff --git a/docs/manual/misc/index.html.ko.euc-kr b/docs/manual/misc/index.html.ko.euc-kr new file mode 100644 index 0000000000..88d2a97ab7 --- /dev/null +++ b/docs/manual/misc/index.html.ko.euc-kr @@ -0,0 +1,76 @@ +<?xml version="1.0" encoding="EUC-KR"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="ko" xml:lang="ko"><head><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>기타 아파치 문서 - Apache HTTP Server</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /> +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page" class="no-sidebar"><div id="page-header"> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p> +<p class="apache">Apache HTTP Server Version 2.1</p> +<img alt="" src="../images/feather.gif" /></div> +<div class="up"><a href="../"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.1</a></div><div id="page-content"><div id="preamble"><h1>기타 아파치 문서</h1> +<div class="toplang"> +<p><span>가능한 언어: </span><a href="../en/misc/" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../ko/misc/" title="Korean"> ko </a></p> +</div> + + + <p>아래는 아파치 웹서버 개발 프로젝트에 대한 추가 문서 + 목록이다.</p> + + <div class="warning"><h3>주의</h3> + <p> 아래 문서는 아파치 웹서버 2.1 버전에서 변경된 내용을 + 담고 있지 않다. 아직도 유효한 정보가 있지만, 주의해서 + 사용하길 바란다.</p> + </div> + + <dl> + <dt><a href="perf-tuning.html">아파치 성능향상</a></dt> + + <dd> + <p>최고의 성능을 내기위해 아파치를 (실행시, 컴파일시) + 설정하는 방법을 다룬다. 아파치가 왜 어떤 작업을 하고 + (아파치를 느리거나 빠르게 만드는) 어떤 작업을 하지 않는지 + 설명한다.</p> + </dd> + + <dt><a href="security_tips.html">보안 팁</a></dt> + + <dd> + <p>아파치 웹서버를 안전하게 유지하기위해 "할 일"과 "하지 + 말아야 할 일".</p> + </dd> + + <dt><a href="rewriteguide.html">URL 재작성 지침서</a></dt> + + <dd> + <p>이 문서는 <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> <a href="../mod/mod_rewrite.html">참조 문서</a>를 보충한다. + 이 문서는 웹관리자가 실제 작업에서 부딪치게되는 전형적인 + URL관련 문제를 해결하기위해서 어떻게 아파치 + <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>를 사용하는지 설명한다.</p> + </dd> + + <dt><a href="relevant_standards.html">관련 표준</a></dt> + + <dd> + <p>이 문서는 아파치가 따르는 관련 표준들을 열거한다.</p> + </dd> + </dl> + + </div> +</div> +<div class="bottomlang"> +<p><span>가능한 언어: </span><a href="../en/misc/" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../ko/misc/" title="Korean"> ko </a></p> +</div><div id="footer"> +<p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/misc/index.xml.ko b/docs/manual/misc/index.xml.ko new file mode 100644 index 0000000000..c7c95cd639 --- /dev/null +++ b/docs/manual/misc/index.xml.ko @@ -0,0 +1,74 @@ +<?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.10 --> + +<!-- + Copyright 2002-2004 The Apache Software Foundation + + Licensed 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. +--> + +<manualpage metafile="index.xml.meta"> + <parentdocument href="../"/> + + <title>기타 아파치 문서</title> + + <summary> + + <p>아래는 아파치 웹서버 개발 프로젝트에 대한 추가 문서 + 목록이다.</p> + + <note type="warning"><title>주의</title> + <p> 아래 문서는 아파치 웹서버 2.1 버전에서 변경된 내용을 + 담고 있지 않다. 아직도 유효한 정보가 있지만, 주의해서 + 사용하길 바란다.</p> + </note> + + <dl> + <dt><a href="perf-tuning.html">아파치 성능향상</a></dt> + + <dd> + <p>최고의 성능을 내기위해 아파치를 (실행시, 컴파일시) + 설정하는 방법을 다룬다. 아파치가 왜 어떤 작업을 하고 + (아파치를 느리거나 빠르게 만드는) 어떤 작업을 하지 않는지 + 설명한다.</p> + </dd> + + <dt><a href="security_tips.html">보안 팁</a></dt> + + <dd> + <p>아파치 웹서버를 안전하게 유지하기위해 "할 일"과 "하지 + 말아야 할 일".</p> + </dd> + + <dt><a href="rewriteguide.html">URL 재작성 지침서</a></dt> + + <dd> + <p>이 문서는 <module>mod_rewrite</module> <a + href="../mod/mod_rewrite.html">참조 문서</a>를 보충한다. + 이 문서는 웹관리자가 실제 작업에서 부딪치게되는 전형적인 + URL관련 문제를 해결하기위해서 어떻게 아파치 + <module>mod_rewrite</module>를 사용하는지 설명한다.</p> + </dd> + + <dt><a href="relevant_standards.html">관련 표준</a></dt> + + <dd> + <p>이 문서는 아파치가 따르는 관련 표준들을 열거한다.</p> + </dd> + </dl> + + </summary> + +</manualpage> diff --git a/docs/manual/misc/index.xml.meta b/docs/manual/misc/index.xml.meta index 4c70c29df7..47616bdf61 100644 --- a/docs/manual/misc/index.xml.meta +++ b/docs/manual/misc/index.xml.meta @@ -7,5 +7,6 @@ <variants> <variant>en</variant> + <variant>ko</variant> </variants> </metafile> diff --git a/docs/manual/misc/relevant_standards.html.ko.euc-kr b/docs/manual/misc/relevant_standards.html.ko.euc-kr index 037ec4f22f..cf06d559b9 100644 --- a/docs/manual/misc/relevant_standards.html.ko.euc-kr +++ b/docs/manual/misc/relevant_standards.html.ko.euc-kr @@ -21,8 +21,6 @@ <p><span>가능한 언어: </span><a href="../en/misc/relevant_standards.html" hreflang="en" rel="alternate" title="English"> en </a> | <a href="../ko/misc/relevant_standards.html" title="Korean"> ko </a></p> </div> -<div class="outofdate">이 문서는 최신판 번역이 아닙니다. - 최근에 변경된 내용은 영어 문서를 참고하세요.</div> <p>이 문서에는 간단한 설명과 함께 아파치 웹서버가 따르는 모든 관련 표준을 열거한다.</p> @@ -114,7 +112,7 @@ HTML)는 플래폼과 무관한 하이퍼텍스트 문서를 위한 간단한 마크업 언어이다. HTML 문서는 SGML 문서이기도 하다.</dd> - <dt><a href="http://www.w3.org/TR/xhtml11/">XHTML™ 1.1 - + <dt><a href="http://www.w3.org/TR/xhtml11/">XHTML 1.1 - 모듈기반 XHTML</a> (<a href="http://www.w3.org/2001/04/REC-xhtml-modularization-20010410-errata">정오표</a>) </dt> @@ -123,7 +121,7 @@ 플레임워크와 모듈들을 기반으로 새로운 XHTML document type을 정의한다.</dd> - <dt><a href="http://www.w3.org/TR/xhtml1">XHTML™ 1.0 + <dt><a href="http://www.w3.org/TR/xhtml1">XHTML 1.0 확장 하이퍼텍스트 마크업 언어 (Extensible HyperText Markup Language) (Second Edition)</a> (<a href="http://www.w3.org/2002/08/REC-xhtml1-20020801-errata">정오표</a>) diff --git a/docs/manual/misc/relevant_standards.xml.ko b/docs/manual/misc/relevant_standards.xml.ko index 0db4946a2a..d76f912434 100644 --- a/docs/manual/misc/relevant_standards.xml.ko +++ b/docs/manual/misc/relevant_standards.xml.ko @@ -1,7 +1,7 @@ <?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.8 (outdated: 1.9) --> +<!-- English Revision: 1.9 --> <!-- Copyright 2004 The Apache Software Foundation @@ -109,7 +109,7 @@ HTML)는 플래폼과 무관한 하이퍼텍스트 문서를 위한 간단한 마크업 언어이다. HTML 문서는 SGML 문서이기도 하다.</dd> - <dt><a href="http://www.w3.org/TR/xhtml11/">XHTML™ 1.1 - + <dt><a href="http://www.w3.org/TR/xhtml11/">XHTML 1.1 - 모듈기반 XHTML</a> (<a href="http://www.w3.org/2001/04/REC-xhtml-modularization-20010410-errata">정오표</a>) </dt> @@ -118,7 +118,7 @@ 플레임워크와 모듈들을 기반으로 새로운 XHTML document type을 정의한다.</dd> - <dt><a href="http://www.w3.org/TR/xhtml1">XHTML™ 1.0 + <dt><a href="http://www.w3.org/TR/xhtml1">XHTML 1.0 확장 하이퍼텍스트 마크업 언어 (Extensible HyperText Markup Language) (Second Edition)</a> (<a href="http://www.w3.org/2002/08/REC-xhtml1-20020801-errata">정오표</a>) diff --git a/docs/manual/misc/relevant_standards.xml.meta b/docs/manual/misc/relevant_standards.xml.meta index ebea594403..063e5b05bc 100644 --- a/docs/manual/misc/relevant_standards.xml.meta +++ b/docs/manual/misc/relevant_standards.xml.meta @@ -7,6 +7,6 @@ <variants> <variant>en</variant> - <variant outdated="yes">ko</variant> + <variant>ko</variant> </variants> </metafile> diff --git a/docs/manual/mod/directives.html.ko.euc-kr b/docs/manual/mod/directives.html.ko.euc-kr index e53b634d22..53221a4324 100644 --- a/docs/manual/mod/directives.html.ko.euc-kr +++ b/docs/manual/mod/directives.html.ko.euc-kr @@ -164,6 +164,7 @@ <li><a href="core.html#directory"><Directory></a></li> <li><a href="mod_dir.html#directoryindex">DirectoryIndex</a></li> <li><a href="core.html#directorymatch"><DirectoryMatch></a></li> +<li><a href="mod_dir.html#directoryslash">DirectorySlash</a></li> <li><a href="core.html#documentroot">DocumentRoot</a></li> <li><a href="mpm_common.html#enableexceptionhook" id="E" name="E">EnableExceptionHook</a></li> <li><a href="core.html#enablemmap">EnableMMAP</a></li> diff --git a/docs/manual/mod/mod_actions.html.ko.euc-kr b/docs/manual/mod/mod_actions.html.ko.euc-kr index 21cc7e212c..bcfc4ca6e3 100644 --- a/docs/manual/mod/mod_actions.html.ko.euc-kr +++ b/docs/manual/mod/mod_actions.html.ko.euc-kr @@ -47,7 +47,7 @@ <h3>참고</h3> <ul class="seealso"> <li><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code></li> -<li><a href="../howto/cgi.html">CGI로 동적 내용</a></li> +<li><a href="../howto/cgi.html">CGI로 동적 페이지 생성</a></li> <li><a href="../handler.html">아파치에서 핸들러 사용</a></li> </ul></div> diff --git a/docs/manual/mod/mod_actions.xml.ko b/docs/manual/mod/mod_actions.xml.ko index 28bdb0ee71..dc1ea05473 100644 --- a/docs/manual/mod/mod_actions.xml.ko +++ b/docs/manual/mod/mod_actions.xml.ko @@ -40,7 +40,7 @@ </summary> <seealso><module>mod_cgi</module></seealso> -<seealso><a href="../howto/cgi.html">CGI로 동적 내용</a></seealso> +<seealso><a href="../howto/cgi.html">CGI로 동적 페이지 생성</a></seealso> <seealso><a href="../handler.html">아파치에서 핸들러 사용</a></seealso> <directivesynopsis> diff --git a/docs/manual/mod/mod_cgi.html.ko.euc-kr b/docs/manual/mod/mod_cgi.html.ko.euc-kr index 9846fdd886..2efd4537ea 100644 --- a/docs/manual/mod/mod_cgi.html.ko.euc-kr +++ b/docs/manual/mod/mod_cgi.html.ko.euc-kr @@ -44,7 +44,7 @@ 환경변수를 추가한다. 이 변수는 <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> 설정값을 가진다.</p> <p>아파치에서 CGI 스크립트를 사용하는 방법에 대한 소개는 - <a href="../howto/cgi.html">CGI로 동적내용</a> 투토리얼을 + <a href="../howto/cgi.html">CGI로 동적 페이지 생성</a> 투토리얼을 참고하라.</p> <p>유닉스에서 다중쓰레드 MPM을 사용한다면 이 모듈대신 diff --git a/docs/manual/mod/mod_cgi.xml.ko b/docs/manual/mod/mod_cgi.xml.ko index f944863b64..44e59d4213 100644 --- a/docs/manual/mod/mod_cgi.xml.ko +++ b/docs/manual/mod/mod_cgi.xml.ko @@ -45,7 +45,7 @@ module="core">DocumentRoot</directive> 설정값을 가진다.</p> <p>아파치에서 CGI 스크립트를 사용하는 방법에 대한 소개는 - <a href="../howto/cgi.html">CGI로 동적내용</a> 투토리얼을 + <a href="../howto/cgi.html">CGI로 동적 페이지 생성</a> 투토리얼을 참고하라.</p> <p>유닉스에서 다중쓰레드 MPM을 사용한다면 이 모듈대신 diff --git a/docs/manual/mod/mod_deflate.html.ko.euc-kr b/docs/manual/mod/mod_deflate.html.ko.euc-kr index 1afa2e42d0..0cc9f58803 100644 --- a/docs/manual/mod/mod_deflate.html.ko.euc-kr +++ b/docs/manual/mod/mod_deflate.html.ko.euc-kr @@ -25,8 +25,6 @@ <a href="../ja/mod/mod_deflate.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_deflate.html" title="Korean"> ko </a></p> </div> -<div class="outofdate">이 문서는 최신판 번역이 아닙니다. - 최근에 변경된 내용은 영어 문서를 참고하세요.</div> <table class="module"><tr><th><a href="module-dict.html#Description">설명:</a></th><td>내용을 클라이언트로 보내기 전에 압축한다</td></tr> <tr><th><a href="module-dict.html#Status">상태:</a></th><td>Extension</td></tr> <tr><th><a href="module-dict.html#ModuleIdentifier">모듈명:</a></th><td>deflate_module</td></tr> @@ -158,15 +156,40 @@ 필터 뒤에 들어간다. 또, 내부 하위요청(subrequest)에 영향을 주지 않는다. </div> + <div class="note"><h3>주의</h3> + <code class="directive"><a href="../mod/core.html#setenv">SetEnv</a></code>로 + <code>force-gzip</code> 환경변수를 설정하면 브라우저의 + accept-encoding 설정을 무시하고 압축된 결과를 보낸다. + </div> + + <h3><a name="inflate" id="inflate">출력 압축풀기</a></h3> + <p><code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> 모듈은 gzip으로 압축된 + 응답 내용을 푸는 필터도 제공한다. 이 기능을 사용하려면 + 다음과 같이 <code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code>나 <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>를 사용하여 + 출력필터순서에 <code>INFLATE</code> 필터를 추가한다.</p> + + <div class="example"><p><code> + <Location /dav-area><br /> + <span class="indent"> + ProxyPass http://example.com/<br /> + SetOutputFilter INFLATE<br /> + </span> + </Location> + </code></p></div> + + <p>이 예제는 example.com이 보낸 gzip으로 압축된 결과의 + 압축을 풀어서, 다른 필터가 더 처리할 수 있도록 한다. + </p> + <h3><a name="input" id="input">입력 압축풀기</a></h3> - <p><code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> 모듈은 요청의 gzip 압축된 + <p><code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> 모듈은 gzip으로 압축된 요청 내용을 푸는 필터도 제공한다. 이 기능을 사용하려면 다음과 같이 <code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code>나 <code class="directive"><a href="../mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>를 사용하여 입력필터순서에 <code>DEFLATE</code> 필터를 - 추가해야한다:</p> + 추가한다.</p> <div class="example"><p><code> <Location /dav-area><br /> diff --git a/docs/manual/mod/mod_deflate.xml.ko b/docs/manual/mod/mod_deflate.xml.ko index c12921a25e..69837e1c37 100644 --- a/docs/manual/mod/mod_deflate.xml.ko +++ b/docs/manual/mod/mod_deflate.xml.ko @@ -1,7 +1,7 @@ <?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: 1.22 (outdated: 1.24) --> +<!-- English Revision: 1.24 --> <!-- Copyright 2003-2004 The Apache Software Foundation @@ -139,15 +139,42 @@ 필터 뒤에 들어간다. 또, 내부 하위요청(subrequest)에 영향을 주지 않는다. </note> + <note><title>주의</title> + <directive module="core">SetEnv</directive>로 + <code>force-gzip</code> 환경변수를 설정하면 브라우저의 + accept-encoding 설정을 무시하고 압축된 결과를 보낸다. + </note> + </section> + <section id="inflate"><title>출력 압축풀기</title> + <p><module>mod_deflate</module> 모듈은 gzip으로 압축된 + 응답 내용을 푸는 필터도 제공한다. 이 기능을 사용하려면 + 다음과 같이 <directive + module="core">SetOutputFilter</directive>나 <directive + module="mod_mime">AddOutputFilter</directive>를 사용하여 + 출력필터순서에 <code>INFLATE</code> 필터를 추가한다.</p> + + <example> + <Location /dav-area><br /> + <indent> + ProxyPass http://example.com/<br /> + SetOutputFilter INFLATE<br /> + </indent> + </Location> + </example> + + <p>이 예제는 example.com이 보낸 gzip으로 압축된 결과의 + 압축을 풀어서, 다른 필터가 더 처리할 수 있도록 한다. + </p> + </section> <section id="input"><title>입력 압축풀기</title> - <p><module>mod_deflate</module> 모듈은 요청의 gzip 압축된 + <p><module>mod_deflate</module> 모듈은 gzip으로 압축된 요청 내용을 푸는 필터도 제공한다. 이 기능을 사용하려면 다음과 같이 <directive module="core">SetInputFilter</directive>나 <directive module="mod_mime">AddInputFilter</directive>를 사용하여 입력필터순서에 <code>DEFLATE</code> 필터를 - 추가해야한다:</p> + 추가한다.</p> <example> <Location /dav-area><br /> diff --git a/docs/manual/mod/mod_deflate.xml.meta b/docs/manual/mod/mod_deflate.xml.meta index d59424513e..c1063d5a1d 100644 --- a/docs/manual/mod/mod_deflate.xml.meta +++ b/docs/manual/mod/mod_deflate.xml.meta @@ -8,6 +8,6 @@ <variants> <variant>en</variant> <variant outdated="yes">ja</variant> - <variant outdated="yes">ko</variant> + <variant>ko</variant> </variants> </metafile> diff --git a/docs/manual/mod/mod_dir.html.ko.euc-kr b/docs/manual/mod/mod_dir.html.ko.euc-kr index d7de3c6532..790c817f1c 100644 --- a/docs/manual/mod/mod_dir.html.ko.euc-kr +++ b/docs/manual/mod/mod_dir.html.ko.euc-kr @@ -25,8 +25,6 @@ <a href="../ja/mod/mod_dir.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_dir.html" title="Korean"> ko </a></p> </div> -<div class="outofdate">이 문서는 최신판 번역이 아닙니다. - 최근에 변경된 내용은 영어 문서를 참고하세요.</div> <table class="module"><tr><th><a href="module-dict.html#Description">설명:</a></th><td>"마지막 슬래쉬" 리다이렉션을 제공하고 디렉토리 index 파일을 서비스한다</td></tr> <tr><th><a href="module-dict.html#Status">상태:</a></th><td>Base</td></tr> @@ -58,6 +56,7 @@ index 파일을 서비스한다</td></tr> <div id="quickview"><h3 class="directives">지시어들</h3> <ul id="toc"> <li><img alt="" src="../images/down.gif" /> <a href="#directoryindex">DirectoryIndex</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#directoryslash">DirectorySlash</a></li> </ul> </div> @@ -101,6 +100,62 @@ index 파일을 서비스한다</td></tr> <code>/cgi-bin/index.pl</code>을 실행한다.</p> </div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="DirectorySlash" id="DirectorySlash">DirectorySlash</a> <a name="directoryslash" id="directoryslash">지시어</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">설명:</a></th><td>마지막 슬래쉬 리다이렉션을 키고 끈다</td></tr> +<tr><th><a href="directive-dict.html#Syntax">문법:</a></th><td><code>DirectorySlash On|Off</code></td></tr> +<tr><th><a href="directive-dict.html#Default">기본값:</a></th><td><code>DirectorySlash On</code></td></tr> +<tr><th><a href="directive-dict.html#Context">사용장소:</a></th><td>주서버설정, 가상호스트, directory, .htaccess</td></tr> +<tr><th><a href="directive-dict.html#Override">Override 옵션:</a></th><td>Indexes</td></tr> +<tr><th><a href="directive-dict.html#Status">상태:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">모듈:</a></th><td>mod_dir</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">지원:</a></th><td>아파치 2.1 이후부터</td></tr> +</table> + <p><code class="directive">DirectorySlash</code> 지시어는 + <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code>가 디렉토리를 가리키는 URL을 수정할지 + 여부를 결정한다.</p> + + <p>사용자가 마지막 슬래쉬없이 디렉토리에 해당하는 자원을 + 요청하면, <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code>는 보통 다음과 같은 이유로 + 사용자를 마지막 슬래쉬를 <em>붙인</em> 동일한 자원으로 + 리다이렉션한다.</p> + + <ul> + <li>사용자는 결국 자원의 정규 URL을 요청하게 된다</li> + <li><code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code>가 올바로 동작한다. 이 + 기능이 없다면 이 모듈은 링크에 잘못된 경로를 쓰게 된다.</li> + <li><code class="directive"><a href="#directoryindex">DirectoryIndex</a></code>는 + 마지막 슬래쉬가 있는 디렉토리 요청<em>만을</em> 처리한다.</li> + <li>html 페이지에 있는 상대적인 URL 참조가 올바로 동작한다.</li> + </ul> + + <p>그런데 이 기능을 원하지 않거<em>나</em> 위에 든 이유가 + 당신에게 알맞지 않다면 다음과 같이 리다이렉션을 하지 않을 + 수 있다.</p> + + <div class="example"><p><code> + # 아래 보안 경고 참고!<br /> + <Location /some/path><br /> + <span class="indent"> + DirectorySlash Off<br /> + SetHandler some-handler<br /> + </span> + </Location> + </code></p></div> + + <div class="warning"><h3>보안 경고</h3> + <p>마지막 슬래쉬 리다이렉션을 끄면 정보가 유출될 수 있다. + (<code>Options +Indexes</code>) <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code>를 + 사용하고 <code class="directive"><a href="#directoryindex">DirectoryIndex</a></code>를 + (<code>index.html</code> 같은) 유효한 자원으로 설정하였지만 + 해당 URL에 다른 특별한 핸들러가 없는 상황을 상상해보라. + 이 경우 마지막 슬래쉬가 있는 요청은 <code>index.html</code> + 파일을 보여준다. <strong>그러나 마지막 슬래쉬가 없는 요청은 + 디렉토리 내용을 보여준다</strong>.</p> + </div> + +</div> </div> <div class="bottomlang"> <p><span>가능한 언어: </span><a href="../en/mod/mod_dir.html" hreflang="en" rel="alternate" title="English"> en </a> | diff --git a/docs/manual/mod/mod_dir.xml.ko b/docs/manual/mod/mod_dir.xml.ko index 762284b941..fe3b057331 100644 --- a/docs/manual/mod/mod_dir.xml.ko +++ b/docs/manual/mod/mod_dir.xml.ko @@ -1,7 +1,7 @@ <?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: 1.9 (outdated: 1.11) --> +<!-- English Revision: 1.11 --> <!-- Copyright 2003-2004 The Apache Software Foundation @@ -90,4 +90,60 @@ index 파일을 서비스한다</description> </usage> </directivesynopsis> +<directivesynopsis> +<name>DirectorySlash</name> +<description>마지막 슬래쉬 리다이렉션을 키고 끈다</description> +<syntax>DirectorySlash On|Off</syntax> +<default>DirectorySlash On</default> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>Indexes</override> +<compatibility>아파치 2.1 이후부터</compatibility> + +<usage> + <p><directive>DirectorySlash</directive> 지시어는 + <module>mod_dir</module>가 디렉토리를 가리키는 URL을 수정할지 + 여부를 결정한다.</p> + + <p>사용자가 마지막 슬래쉬없이 디렉토리에 해당하는 자원을 + 요청하면, <module>mod_dir</module>는 보통 다음과 같은 이유로 + 사용자를 마지막 슬래쉬를 <em>붙인</em> 동일한 자원으로 + 리다이렉션한다.</p> + + <ul> + <li>사용자는 결국 자원의 정규 URL을 요청하게 된다</li> + <li><module>mod_autoindex</module>가 올바로 동작한다. 이 + 기능이 없다면 이 모듈은 링크에 잘못된 경로를 쓰게 된다.</li> + <li><directive module="mod_dir">DirectoryIndex</directive>는 + 마지막 슬래쉬가 있는 디렉토리 요청<em>만을</em> 처리한다.</li> + <li>html 페이지에 있는 상대적인 URL 참조가 올바로 동작한다.</li> + </ul> + + <p>그런데 이 기능을 원하지 않거<em>나</em> 위에 든 이유가 + 당신에게 알맞지 않다면 다음과 같이 리다이렉션을 하지 않을 + 수 있다.</p> + + <example> + # 아래 보안 경고 참고!<br /> + <Location /some/path><br /> + <indent> + DirectorySlash Off<br /> + SetHandler some-handler<br /> + </indent> + </Location> + </example> + + <note type="warning"><title>보안 경고</title> + <p>마지막 슬래쉬 리다이렉션을 끄면 정보가 유출될 수 있다. + (<code>Options +Indexes</code>) <module>mod_autoindex</module>를 + 사용하고 <directive module="mod_dir">DirectoryIndex</directive>를 + (<code>index.html</code> 같은) 유효한 자원으로 설정하였지만 + 해당 URL에 다른 특별한 핸들러가 없는 상황을 상상해보라. + 이 경우 마지막 슬래쉬가 있는 요청은 <code>index.html</code> + 파일을 보여준다. <strong>그러나 마지막 슬래쉬가 없는 요청은 + 디렉토리 내용을 보여준다</strong>.</p> + </note> +</usage> +</directivesynopsis> + </modulesynopsis> diff --git a/docs/manual/mod/mod_dir.xml.meta b/docs/manual/mod/mod_dir.xml.meta index a733ff2d18..a43aa061f6 100644 --- a/docs/manual/mod/mod_dir.xml.meta +++ b/docs/manual/mod/mod_dir.xml.meta @@ -8,6 +8,6 @@ <variants> <variant>en</variant> <variant outdated="yes">ja</variant> - <variant outdated="yes">ko</variant> + <variant>ko</variant> </variants> </metafile> diff --git a/docs/manual/mod/mod_file_cache.html.ko.euc-kr b/docs/manual/mod/mod_file_cache.html.ko.euc-kr index 4bb6dbdeb3..7f21e60691 100644 --- a/docs/manual/mod/mod_file_cache.html.ko.euc-kr +++ b/docs/manual/mod/mod_file_cache.html.ko.euc-kr @@ -33,24 +33,27 @@ <div class="warning"> 이 모듈은 조심해서 사용해야 한다. <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code>를 -사용하여 사이트를 망치기 쉬우므로 이 문제를 꼼꼼히 읽어라. + 사용하여 사이트를 엉망으로 만들기 쉽기때문에 이 문서를 + 꼼꼼히 읽길 바란다. </div> - <p>거의 변하지 않고 자주 요청되는 파일을 <em>캐쉬</em>에 저장하여 -서버 부하를 줄일 수 있다. <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code>는 -두가지 방식으로 자주 요청되는 <em>정적</em> 파일을 캐쉬에 저장한다. -설정 지시어를 통해 <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code>가 파일을 -열고(open) <code>mmap()</code>할지 파일을 미리 열고 -<em>파일 핸들러</em>를 저장할지 결정한다. 두 방식 모두 -파일을 서비스하기위한 작업의 일부를 ((특히 파일 입출력) 파일 요청때마다 -하는 대신 서버가 시작할때 하여 서버 부하를 감소한다.</p> - - <p>주의: 이 방법은 CGI 프로그램이나 특별한 내용핸들러를 통해 서비스하는 -파일의 속도를 향상할 수 없다. 이 방법은 보통 아파치 core 내용핸들러가 -서비스하는 일반파일에만 적용된다.</p> - - <p>이 모듈은 아파치 1.3의 <code>mod_mmap_static</code> 모듈의 -영향을 많이 받은 확장이다.</p> + <p>거의 변하지 않고 자주 요청되는 파일을 <em>캐쉬</em>에 + 저장하여 서버 부하를 줄일 수 있다. <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code>는 + 자주 요청되는 <em>정적</em> 파일을 두가지 방식으로 캐쉬에 + 저장한다. 설정 지시어를 사용하여 <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code>가 + 파일을 열고(open) <code>mmap()</code>할지 아니면 파일을 + 열고 <em>파일 핸들</em>을 저장할지 결정한다. 두 방식 모두 + 파일을 서비스하기위해 필요한 작업의 일부를 (특히 파일 입출력 + 작업) 파일을 요청할 때마다 매번 하는 대신 서버가 시작할때 + 한번만 하여 서버 부하가 감소한다.</p> + + <p>주의: 이 방법은 CGI 프로그램이나 특별한 내용핸들러를 + 통해 서비스하는 파일의 서비스 속도를 높일 수 없다. 이 방법은 + 보통 아파치 core 내용핸들러가 서비스하는 일반파일에만 + 적용된다.</p> + + <p>이 모듈은 아파치 1.3에 있는 <code>mod_mmap_static</code> + 모듈의 기능을 확장한 결과다.</p> </div> <div id="quickview"><h3 class="directives">지시어들</h3> <ul id="toc"> @@ -65,71 +68,64 @@ <div class="section"> <h2><a name="using" id="using">mod_file_cache 사용하기</a></h2> - <p><code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code>는 주서버 설정에서 -<code class="directive"><a href="#mmapfile">MMapFile</a></code>과 <code class="directive"><a href="#cachefile">CacheFile</a></code> 지시어를 통해 설정한 정적 파일들을 -캐쉬에 저장한다.</p> + <p><code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code>는 주서버 설정에서 <code class="directive"><a href="#mmapfile">MMapFile</a></code>과 <code class="directive"><a href="#cachefile">CacheFile</a></code> 지시어를 사용하여 + 설정한 정적 파일들을 캐쉬에 저장한다.</p> <p>모든 플래폼이 두 지시어를 모두 지원하는 것은 아니다. -예를 들어, 윈도우즈용 아파치는 현재 <code class="directive"><a href="#mmapstatic">MMapStatic</a></code> 지시어를 -지원하지 않지만, AIX 같은 다른 플래폼은 둘 모두 지원한다. -지원하지않는 지시어를 사용할 경우 서버 오류 로그에 오류문을 -남긴다. 지원하지않는 지시어를 사용해도 서버는 시작하지만 -파일을 캐쉬에 저장하지 않는다. 두 지시어를 모두 지원하는 플래폼을 -사용한다면 어떤 방식이 더 좋은지 실험해볼 수 있다.</p> + 예를 들어, 윈도우즈용 아파치는 현재 <code class="directive"><a href="#mmapstatic">MMapStatic</a></code> 지시어를 + 지원하지 않지만, AIX 같은 다른 플래폼은 둘 모두를 지원한다. + 지원하지않는 지시어를 사용할 경우 서버 오류 로그에 오류문을 + 남긴다. 지원하지않는 지시어를 사용해도 서버는 동작하지만 + 파일을 캐쉬에 저장하지 않는다. 두 지시어를 모두 지원하는 + 플래폼을 사용한다면 어떤 방식이 더 좋은지 실험해보라.</p> <h3>MMapFile 지시어</h3> - <p><code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code>의 -<code class="directive"><a href="#mmapfile">MMapFile</a></code> 지시어는 -설정한 정적인 파일들을 <code>mmap()</code> 시스템호출을 사용하여 -메모리에 대응한다. 많은 최근 유닉스류 운영체제에 이 시스템호출이 -있지만, 없는 운영체제도 있다. 또, <code>mmap()</code>할 수 있는 -파일 크기와 개수를 시스템이 제한할 수 있으므로 실험해보는 것이 -좋다.</p> - - <p>서버가 시작할때와 재시작할때만 <code>mmap()</code>을 -한다. 그래서 파일시스템에서 해당 파일중 하나라도 변경된 경우 -서버를 재시작<em>해야</em> 한다 (<a href="../stopping.html">Stopping and Restarting</a> 문서 참고). -다시 강조하면: 서버를 재시작하지않고 파일을 수정하면 -요청 서비스가 완전히 이상할 수 있다. 이전 파일을 지우고(unlink) -새로 파일을 만들어서 파일을 수정해야 한다. <code>rdist</code>나 -<code>mv</code>와 같이 많은 도구가 이런 식으로 동작한다. -매번 추가로 불필요한 <code>stat()</code> 검사가 필요하고 -입출력 감소의 의도에 반하므로 이 모듈은 파일 변화를 신경쓰지않는다.</p> + <p><code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code>의 <code class="directive"><a href="#mmapfile">MMapFile</a></code> 지시어는 + 설정한 정적 파일들을 <code>mmap()</code> 시스템호출을 + 사용하여 메모리에 대응한다. 최신 유닉스류 운영체제라면 + 보통 이 시스템호출이 있지만, 없는 운영체제도 있다. 또, + <code>mmap()</code>할 수 있는 파일 크기와 개수를 시스템이 + 제한할 수 있으므로 미리 실험해보는 것이 좋다.</p> + + <p>서버는 시작할때와 재시작할때만 <code>mmap()</code>한다. + 그래서 파일시스템에서 해당 파일중 하나라도 변경되면 서버를 + 재시작<em>해야</em> 한다 (<a href="../stopping.html">중단과 + 재시작</a> 문서 참고). 다시 말해서 파일이 변경되었는데 + 서버를 재시작하지 않으면 완전히 이상하게 요청을 서비스할지도 + 모른다. 이전 파일을 지우고(unlink) 그 자리에 새로운 파일을 + 만들는 방식으로 파일을 수정해야 한다. <code>rdist</code>나 + <code>mv</code>와 같은 대다수의 도구가 이런 방식으로 동작한다. + 매번 추가로 불필요한 <code>stat()</code> 검사가 필요하고 + 입출력 감소라는 원래 의도에 반하기때문에 이 모듈은 파일의 + 변화를 무시한다.</p> <h3>CacheFile 지시어</h3> - <p><code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code>의 -<code class="directive"><a href="#cachefile">CacheFile</a></code> 지시어는 -설정 지시어에 열거한 -파일(과 파일들)의 <em>핸들(handle)</em> 혹은 -<em>파일 기술자(file descriptor)</em>를 열고(open) 캐쉬에 저장한다. -파일을 요청하면 서버는 캐쉬에서 핸들을 찾아서 소켓 API -<code>sendfile()</code>에 (윈도우즈에서는 <code>TransmitFile()</code>) -넘긴다.</p> + <p><code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code>의 <code class="directive"><a href="#cachefile">CacheFile</a></code> 지시어는 + 설정 지시어에 열거한 파일(과 파일들)을 열어서 파일의 + <em>핸들(handle)</em> 혹은 <em>파일 기술자(file descriptor)</em>를 + 캐쉬에 저장한다. 파일을 요청하면 서버는 캐쉬에서 핸들을 + 찾아서 소켓 API <code>sendfile()</code>에 (윈도우즈에서는 + <code>TransmitFile()</code>) 넘긴다.</p> - <p>서버가 시작할때와 재시작할때만 이런 파일핸들 캐쉬를 -만든다. ... -This file handle caching is done once at server start or - restart, only. So whenever one of the cached files changes on - the filesystem you <em>have</em> to restart the server (see the - <a href="../stopping.html">Stopping and Restarting</a> - documentation). To reiterate that point: if the files are - modified <em>in place</em> without restarting the server you - may end up serving requests that are completely bogus. You - should update files by unlinking the old copy and putting a new - copy in place. Most tools such as <code>rdist</code> and - <code>mv</code> do this.</p> + <p>서버는 시작할때와 재시작할때만 파일 핸들을 캐쉬한다. + 그래서 파일시스템에서 캐쉬한 파일중 하나라도 변경되면 + 서버를 재시작<em>해야</em> 한다 (<a href="../stopping.html">중단과 재시작</a> 문서 참고). + 다시 말해서 파일이 변경되었는데 서버를 재시작하지 않으면 + 완전히 이상하게 요청을 서비스할지도 모른다. 이전 파일을 + 지우고(unlink) 그 자리에 새로운 파일을 만드는 방식으로 + 파일을 수정해야 한다. <code>rdist</code>나 <code>mv</code>와 + 같은 대다수의 도구가 이런 방식으로 동작한다.</p> <div class="note"><h3>주의</h3> - <p>디렉토리의 모든 파일을 재귀적으로 캐쉬에 저장하는 -지시어를 요구하지 마라. 대신 이렇게 해봐라... -<code class="directive"><a href="../mod/core.html#include">Include</a></code> 지시어를 참고하고 -다음과 같은 명령을 실행하라:</p> + <p>디렉토리의 모든 파일을 재귀적으로 캐쉬에 저장하는 지시어는 + 없다. 대신 다음과 같이 해보라... <code class="directive"><a href="../mod/core.html#include">Include</a></code> 지시어를 참고하여 다음과 + 같은 명령어를 실행한다:</p> <div class="example"><p><code> find /www/htdocs -type f -print \<br /> @@ -140,29 +136,27 @@ This file handle caching is done once at server start or <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="CacheFile" id="CacheFile">CacheFile</a> <a name="cachefile" id="cachefile">지시어</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">설명:</a></th><td>Cache a list of file handles at startup time</td></tr> +<tr><th><a href="directive-dict.html#Description">설명:</a></th><td>시작시 여러 파일 핸들을 캐쉬한다</td></tr> <tr><th><a href="directive-dict.html#Syntax">문법:</a></th><td><code>CacheFile <var>file-path</var> [<var>file-path</var>] ...</code></td></tr> <tr><th><a href="directive-dict.html#Context">사용장소:</a></th><td>주서버설정</td></tr> <tr><th><a href="directive-dict.html#Status">상태:</a></th><td>Experimental</td></tr> <tr><th><a href="directive-dict.html#Module">모듈:</a></th><td>mod_file_cache</td></tr> </table> - <p>The <code class="directive">CacheFile</code> directive opens handles to - one or more files (given as whitespace separated arguments) and - places these handles into the cache at server startup - time. Handles to cached files are automatically closed on a server - shutdown. When the files have changed on the filesystem, the - server should be restarted to to re-cache them.</p> - - <p>Be careful with the <var>file-path</var> arguments: They have - to literally match the filesystem path Apache's URL-to-filename - translation handlers create. We cannot compare inodes or other - stuff to match paths through symbolic links <em>etc.</em> - because that again would cost extra <code>stat()</code> system - calls which is not acceptable. This module may or may not work - with filenames rewritten by <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> or - <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>.</p> - - <div class="example"><h3>Example</h3><p><code> + <p><code class="directive">CacheFile</code> 지시어는 서버가 시작할때 + 여러 파일을 열고(open) 파일들의 핸들을 캐쉬에 저장한다. + 서버 종료시 자동으로 캐쉬한 파일의 핸들을 닫는다(close). + 파일시스템에서 파일이 변경되면 파일을 다시 캐쉬하기위해 + 서버를 재시작해야 한다.</p> + + <p><var>file-path</var> 아규먼트를 조심해라. 아규먼트는 + 아파치의 URL-파일명 변환 핸들러가 만든 파일시스템 경로와 + 정확히 일치해야 한다. 한번 더 불필요한 <code>stat()</code> + 시스템호출이 필요하기때문에 inode나 심볼링크 <em>등</em>을 + 경로를 지정할 수 없다. 이 모듈은 <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code>나 + <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>로 재작성한 파일명을 다룰 수 + 있기도 없기도 하다.</p> + + <div class="example"><h3>예제</h3><p><code> CacheFile /usr/local/apache/htdocs/index.html </code></p></div> @@ -170,29 +164,28 @@ This file handle caching is done once at server start or <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="MMapFile" id="MMapFile">MMapFile</a> <a name="mmapfile" id="mmapfile">지시어</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">설명:</a></th><td>Map a list of files into memory at startup time</td></tr> +<tr><th><a href="directive-dict.html#Description">설명:</a></th><td>시작시 여러 파일을 메모리에 대응한다</td></tr> <tr><th><a href="directive-dict.html#Syntax">문법:</a></th><td><code>MMapFile <var>file-path</var> [<var>file-path</var>] ...</code></td></tr> <tr><th><a href="directive-dict.html#Context">사용장소:</a></th><td>주서버설정</td></tr> <tr><th><a href="directive-dict.html#Status">상태:</a></th><td>Experimental</td></tr> <tr><th><a href="directive-dict.html#Module">모듈:</a></th><td>mod_file_cache</td></tr> </table> - <p>The <code class="directive">MMapFile</code> directive maps one or more files - (given as whitespace separated arguments) into memory at server - startup time. They are automatically unmapped on a server - shutdown. When the files have changed on the filesystem at - least a <code>HUP</code> or <code>USR1</code> signal should be send to - the server to re-<code>mmap()</code> them.</p> - - <p>Be careful with the <var>file-path</var> arguments: They have - to literally match the filesystem path Apache's URL-to-filename - translation handlers create. We cannot compare inodes or other - stuff to match paths through symbolic links <em>etc.</em> - because that again would cost extra <code>stat()</code> system - calls which is not acceptable. This module may or may not work - with filenames rewritten by <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> or - <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>.</p> - - <div class="example"><h3>Example</h3><p><code> + <p><code class="directive">MMapFile</code> 지시어는 서버가 시작할때 + (공백으로 구분한 아규먼트로 지정한) 여러 파일을 메모리에 + 대응한다(map). 서버 종료시 자동으로 대응을 푼다(unmap). + 파일시스템에서 파일이 변경되면 파일들을 다시 + <code>mmap()</code>하기위해 최소한 서버에 <code>HUP</code>이나 + <code>USR1</code> 시그널을 보내야 한다.</p> + + <p><var>file-path</var> 아규먼트를 조심해라. 아규먼트는 + 아파치의 URL-파일명 변환 핸들러가 만든 파일시스템 경로와 + 정확히 일치해야 한다. 한번 더 불필요한 <code>stat()</code> + 시스템호출이 필요하기때문에 inode나 심볼링크 <em>등</em>을 + 경로를 지정할 수 없다. 이 모듈은 <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code>나 + <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>로 재작성한 파일명을 다룰 수 + 있기도 없기도 하다.</p> + + <div class="example"><h3>예제</h3><p><code> MMapFile /usr/local/apache/htdocs/index.html </code></p></div> diff --git a/docs/manual/mod/mod_file_cache.xml.ko b/docs/manual/mod/mod_file_cache.xml.ko index dd792eca84..6c23d797d4 100644 --- a/docs/manual/mod/mod_file_cache.xml.ko +++ b/docs/manual/mod/mod_file_cache.xml.ko @@ -31,99 +31,98 @@ <note type="warning"> 이 모듈은 조심해서 사용해야 한다. <module>mod_file_cache</module>를 -사용하여 사이트를 망치기 쉬우므로 이 문제를 꼼꼼히 읽어라. + 사용하여 사이트를 엉망으로 만들기 쉽기때문에 이 문서를 + 꼼꼼히 읽길 바란다. </note> - <p>거의 변하지 않고 자주 요청되는 파일을 <em>캐쉬</em>에 저장하여 -서버 부하를 줄일 수 있다. <module>mod_file_cache</module>는 -두가지 방식으로 자주 요청되는 <em>정적</em> 파일을 캐쉬에 저장한다. -설정 지시어를 통해 <module>mod_file_cache</module>가 파일을 -열고(open) <code>mmap()</code>할지 파일을 미리 열고 -<em>파일 핸들러</em>를 저장할지 결정한다. 두 방식 모두 -파일을 서비스하기위한 작업의 일부를 ((특히 파일 입출력) 파일 요청때마다 -하는 대신 서버가 시작할때 하여 서버 부하를 감소한다.</p> - - <p>주의: 이 방법은 CGI 프로그램이나 특별한 내용핸들러를 통해 서비스하는 -파일의 속도를 향상할 수 없다. 이 방법은 보통 아파치 core 내용핸들러가 -서비스하는 일반파일에만 적용된다.</p> - - <p>이 모듈은 아파치 1.3의 <code>mod_mmap_static</code> 모듈의 -영향을 많이 받은 확장이다.</p> + <p>거의 변하지 않고 자주 요청되는 파일을 <em>캐쉬</em>에 + 저장하여 서버 부하를 줄일 수 있다. <module>mod_file_cache</module>는 + 자주 요청되는 <em>정적</em> 파일을 두가지 방식으로 캐쉬에 + 저장한다. 설정 지시어를 사용하여 <module>mod_file_cache</module>가 + 파일을 열고(open) <code>mmap()</code>할지 아니면 파일을 + 열고 <em>파일 핸들</em>을 저장할지 결정한다. 두 방식 모두 + 파일을 서비스하기위해 필요한 작업의 일부를 (특히 파일 입출력 + 작업) 파일을 요청할 때마다 매번 하는 대신 서버가 시작할때 + 한번만 하여 서버 부하가 감소한다.</p> + + <p>주의: 이 방법은 CGI 프로그램이나 특별한 내용핸들러를 + 통해 서비스하는 파일의 서비스 속도를 높일 수 없다. 이 방법은 + 보통 아파치 core 내용핸들러가 서비스하는 일반파일에만 + 적용된다.</p> + + <p>이 모듈은 아파치 1.3에 있는 <code>mod_mmap_static</code> + 모듈의 기능을 확장한 결과다.</p> </summary> <section id="using"><title>mod_file_cache 사용하기</title> - <p><module>mod_file_cache</module>는 주서버 설정에서 -<directive module="mod_file_cache" - >MMapFile</directive>과 <directive module="mod_file_cache" - >CacheFile</directive> 지시어를 통해 설정한 정적 파일들을 -캐쉬에 저장한다.</p> + <p><module>mod_file_cache</module>는 주서버 설정에서 <directive + module="mod_file_cache">MMapFile</directive>과 <directive + module="mod_file_cache">CacheFile</directive> 지시어를 사용하여 + 설정한 정적 파일들을 캐쉬에 저장한다.</p> <p>모든 플래폼이 두 지시어를 모두 지원하는 것은 아니다. -예를 들어, 윈도우즈용 아파치는 현재 <directive + 예를 들어, 윈도우즈용 아파치는 현재 <directive module="mod_file_cache">MMapStatic</directive> 지시어를 -지원하지 않지만, AIX 같은 다른 플래폼은 둘 모두 지원한다. -지원하지않는 지시어를 사용할 경우 서버 오류 로그에 오류문을 -남긴다. 지원하지않는 지시어를 사용해도 서버는 시작하지만 -파일을 캐쉬에 저장하지 않는다. 두 지시어를 모두 지원하는 플래폼을 -사용한다면 어떤 방식이 더 좋은지 실험해볼 수 있다.</p> + 지원하지 않지만, AIX 같은 다른 플래폼은 둘 모두를 지원한다. + 지원하지않는 지시어를 사용할 경우 서버 오류 로그에 오류문을 + 남긴다. 지원하지않는 지시어를 사용해도 서버는 동작하지만 + 파일을 캐쉬에 저장하지 않는다. 두 지시어를 모두 지원하는 + 플래폼을 사용한다면 어떤 방식이 더 좋은지 실험해보라.</p> <section><title>MMapFile 지시어</title> - <p><module>mod_file_cache</module>의 -<directive module="mod_file_cache">MMapFile</directive> 지시어는 -설정한 정적인 파일들을 <code>mmap()</code> 시스템호출을 사용하여 -메모리에 대응한다. 많은 최근 유닉스류 운영체제에 이 시스템호출이 -있지만, 없는 운영체제도 있다. 또, <code>mmap()</code>할 수 있는 -파일 크기와 개수를 시스템이 제한할 수 있으므로 실험해보는 것이 -좋다.</p> - - <p>서버가 시작할때와 재시작할때만 <code>mmap()</code>을 -한다. 그래서 파일시스템에서 해당 파일중 하나라도 변경된 경우 -서버를 재시작<em>해야</em> 한다 (<a - href="../stopping.html">Stopping and Restarting</a> 문서 참고). -다시 강조하면: 서버를 재시작하지않고 파일을 수정하면 -요청 서비스가 완전히 이상할 수 있다. 이전 파일을 지우고(unlink) -새로 파일을 만들어서 파일을 수정해야 한다. <code>rdist</code>나 -<code>mv</code>와 같이 많은 도구가 이런 식으로 동작한다. -매번 추가로 불필요한 <code>stat()</code> 검사가 필요하고 -입출력 감소의 의도에 반하므로 이 모듈은 파일 변화를 신경쓰지않는다.</p> + <p><module>mod_file_cache</module>의 <directive + module="mod_file_cache">MMapFile</directive> 지시어는 + 설정한 정적 파일들을 <code>mmap()</code> 시스템호출을 + 사용하여 메모리에 대응한다. 최신 유닉스류 운영체제라면 + 보통 이 시스템호출이 있지만, 없는 운영체제도 있다. 또, + <code>mmap()</code>할 수 있는 파일 크기와 개수를 시스템이 + 제한할 수 있으므로 미리 실험해보는 것이 좋다.</p> + + <p>서버는 시작할때와 재시작할때만 <code>mmap()</code>한다. + 그래서 파일시스템에서 해당 파일중 하나라도 변경되면 서버를 + 재시작<em>해야</em> 한다 (<a href="../stopping.html">중단과 + 재시작</a> 문서 참고). 다시 말해서 파일이 변경되었는데 + 서버를 재시작하지 않으면 완전히 이상하게 요청을 서비스할지도 + 모른다. 이전 파일을 지우고(unlink) 그 자리에 새로운 파일을 + 만들는 방식으로 파일을 수정해야 한다. <code>rdist</code>나 + <code>mv</code>와 같은 대다수의 도구가 이런 방식으로 동작한다. + 매번 추가로 불필요한 <code>stat()</code> 검사가 필요하고 + 입출력 감소라는 원래 의도에 반하기때문에 이 모듈은 파일의 + 변화를 무시한다.</p> </section> <section><title>CacheFile 지시어</title> - <p><module>mod_file_cache</module>의 -<directive module="mod_file_cache">CacheFile</directive> 지시어는 -설정 지시어에 열거한 -파일(과 파일들)의 <em>핸들(handle)</em> 혹은 -<em>파일 기술자(file descriptor)</em>를 열고(open) 캐쉬에 저장한다. -파일을 요청하면 서버는 캐쉬에서 핸들을 찾아서 소켓 API -<code>sendfile()</code>에 (윈도우즈에서는 <code>TransmitFile()</code>) -넘긴다.</p> + <p><module>mod_file_cache</module>의 <directive + module="mod_file_cache">CacheFile</directive> 지시어는 + 설정 지시어에 열거한 파일(과 파일들)을 열어서 파일의 + <em>핸들(handle)</em> 혹은 <em>파일 기술자(file descriptor)</em>를 + 캐쉬에 저장한다. 파일을 요청하면 서버는 캐쉬에서 핸들을 + 찾아서 소켓 API <code>sendfile()</code>에 (윈도우즈에서는 + <code>TransmitFile()</code>) 넘긴다.</p> <!-- XXX <p>Insert more details about sendfile API...</p> --> - <p>서버가 시작할때와 재시작할때만 이런 파일핸들 캐쉬를 -만든다. ... -This file handle caching is done once at server start or - restart, only. So whenever one of the cached files changes on - the filesystem you <em>have</em> to restart the server (see the - <a href="../stopping.html">Stopping and Restarting</a> - documentation). To reiterate that point: if the files are - modified <em>in place</em> without restarting the server you - may end up serving requests that are completely bogus. You - should update files by unlinking the old copy and putting a new - copy in place. Most tools such as <code>rdist</code> and - <code>mv</code> do this.</p> + <p>서버는 시작할때와 재시작할때만 파일 핸들을 캐쉬한다. + 그래서 파일시스템에서 캐쉬한 파일중 하나라도 변경되면 + 서버를 재시작<em>해야</em> 한다 (<a + href="../stopping.html">중단과 재시작</a> 문서 참고). + 다시 말해서 파일이 변경되었는데 서버를 재시작하지 않으면 + 완전히 이상하게 요청을 서비스할지도 모른다. 이전 파일을 + 지우고(unlink) 그 자리에 새로운 파일을 만드는 방식으로 + 파일을 수정해야 한다. <code>rdist</code>나 <code>mv</code>와 + 같은 대다수의 도구가 이런 방식으로 동작한다.</p> </section> <note><title>주의</title> - <p>디렉토리의 모든 파일을 재귀적으로 캐쉬에 저장하는 -지시어를 요구하지 마라. 대신 이렇게 해봐라... -<directive module="core">Include</directive> 지시어를 참고하고 -다음과 같은 명령을 실행하라:</p> + <p>디렉토리의 모든 파일을 재귀적으로 캐쉬에 저장하는 지시어는 + 없다. 대신 다음과 같이 해보라... <directive + module="core">Include</directive> 지시어를 참고하여 다음과 + 같은 명령어를 실행한다:</p> <example> find /www/htdocs -type f -print \<br /> @@ -134,28 +133,27 @@ This file handle caching is done once at server start or <directivesynopsis> <name>MMapFile</name> -<description>Map a list of files into memory at startup time</description> +<description>시작시 여러 파일을 메모리에 대응한다</description> <syntax>MMapFile <var>file-path</var> [<var>file-path</var>] ...</syntax> <contextlist><context>server config</context></contextlist> <usage> - <p>The <directive>MMapFile</directive> directive maps one or more files - (given as whitespace separated arguments) into memory at server - startup time. They are automatically unmapped on a server - shutdown. When the files have changed on the filesystem at - least a <code>HUP</code> or <code>USR1</code> signal should be send to - the server to re-<code>mmap()</code> them.</p> - - <p>Be careful with the <var>file-path</var> arguments: They have - to literally match the filesystem path Apache's URL-to-filename - translation handlers create. We cannot compare inodes or other - stuff to match paths through symbolic links <em>etc.</em> - because that again would cost extra <code>stat()</code> system - calls which is not acceptable. This module may or may not work - with filenames rewritten by <module>mod_alias</module> or - <module>mod_rewrite</module>.</p> - - <example><title>Example</title> + <p><directive>MMapFile</directive> 지시어는 서버가 시작할때 + (공백으로 구분한 아규먼트로 지정한) 여러 파일을 메모리에 + 대응한다(map). 서버 종료시 자동으로 대응을 푼다(unmap). + 파일시스템에서 파일이 변경되면 파일들을 다시 + <code>mmap()</code>하기위해 최소한 서버에 <code>HUP</code>이나 + <code>USR1</code> 시그널을 보내야 한다.</p> + + <p><var>file-path</var> 아규먼트를 조심해라. 아규먼트는 + 아파치의 URL-파일명 변환 핸들러가 만든 파일시스템 경로와 + 정확히 일치해야 한다. 한번 더 불필요한 <code>stat()</code> + 시스템호출이 필요하기때문에 inode나 심볼링크 <em>등</em>을 + 경로를 지정할 수 없다. 이 모듈은 <module>mod_alias</module>나 + <module>mod_rewrite</module>로 재작성한 파일명을 다룰 수 + 있기도 없기도 하다.</p> + + <example><title>예제</title> MMapFile /usr/local/apache/htdocs/index.html </example> </usage> @@ -163,28 +161,26 @@ This file handle caching is done once at server start or <directivesynopsis> <name>CacheFile</name> -<description>Cache a list of file handles at startup time</description> +<description>시작시 여러 파일 핸들을 캐쉬한다</description> <syntax>CacheFile <var>file-path</var> [<var>file-path</var>] ...</syntax> <contextlist><context>server config</context></contextlist> <usage> - <p>The <directive>CacheFile</directive> directive opens handles to - one or more files (given as whitespace separated arguments) and - places these handles into the cache at server startup - time. Handles to cached files are automatically closed on a server - shutdown. When the files have changed on the filesystem, the - server should be restarted to to re-cache them.</p> - - <p>Be careful with the <var>file-path</var> arguments: They have - to literally match the filesystem path Apache's URL-to-filename - translation handlers create. We cannot compare inodes or other - stuff to match paths through symbolic links <em>etc.</em> - because that again would cost extra <code>stat()</code> system - calls which is not acceptable. This module may or may not work - with filenames rewritten by <module>mod_alias</module> or - <module>mod_rewrite</module>.</p> - - <example><title>Example</title> + <p><directive>CacheFile</directive> 지시어는 서버가 시작할때 + 여러 파일을 열고(open) 파일들의 핸들을 캐쉬에 저장한다. + 서버 종료시 자동으로 캐쉬한 파일의 핸들을 닫는다(close). + 파일시스템에서 파일이 변경되면 파일을 다시 캐쉬하기위해 + 서버를 재시작해야 한다.</p> + + <p><var>file-path</var> 아규먼트를 조심해라. 아규먼트는 + 아파치의 URL-파일명 변환 핸들러가 만든 파일시스템 경로와 + 정확히 일치해야 한다. 한번 더 불필요한 <code>stat()</code> + 시스템호출이 필요하기때문에 inode나 심볼링크 <em>등</em>을 + 경로를 지정할 수 없다. 이 모듈은 <module>mod_alias</module>나 + <module>mod_rewrite</module>로 재작성한 파일명을 다룰 수 + 있기도 없기도 하다.</p> + + <example><title>예제</title> CacheFile /usr/local/apache/htdocs/index.html </example> </usage> diff --git a/docs/manual/mod/mod_status.html.ko.euc-kr b/docs/manual/mod/mod_status.html.ko.euc-kr index 6281b46976..10c2fc8e71 100644 --- a/docs/manual/mod/mod_status.html.ko.euc-kr +++ b/docs/manual/mod/mod_status.html.ko.euc-kr @@ -39,12 +39,12 @@ <p>알려주는 정보는:</p> <ul> - <li>################################ 요청을 서비스하는 worker의 개수</li> + <li>요청을 서비스하는 worker의 개수</li> - <li>쉬고 있는(idle) ####################### worker의 개수</li> + <li>쉬고 있는(idle) worker의 개수</li> - <li>각 ## worker들의 상태, ## worker이 처리한 요청의 개수와 ## worker이 - 서비스한 전체 바이트수 (*)</li> + <li>각 worker들의 상태, worker가 처리한 요청의 개수와 + worker가 서비스한 전체 바이트수 (*)</li> <li>총 접근 횟수와 서비스한 바이트수 (*)</li> @@ -53,7 +53,7 @@ <li>초당 요청수 평균, 초당 서비스한 바이트수와 요청당 바이트수 평균 (*)</li> - <li>현재 아파치 전체와 각 ### worker들의 CPU 비율 (*)</li> + <li>현재 아파치 전체와 각 worker들의 CPU 비율 (*)</li> <li>현재 처리하고 있는 호스트와 요청 (*)</li> </ul> diff --git a/docs/manual/mod/mod_status.xml.ko b/docs/manual/mod/mod_status.xml.ko index 2a79c02f83..eb9edb0c62 100644 --- a/docs/manual/mod/mod_status.xml.ko +++ b/docs/manual/mod/mod_status.xml.ko @@ -38,12 +38,12 @@ <p>알려주는 정보는:</p> <ul> - <li>################################ 요청을 서비스하는 worker의 개수</li> + <li>요청을 서비스하는 worker의 개수</li> - <li>쉬고 있는(idle) ####################### worker의 개수</li> + <li>쉬고 있는(idle) worker의 개수</li> - <li>각 ## worker들의 상태, ## worker이 처리한 요청의 개수와 ## worker이 - 서비스한 전체 바이트수 (*)</li> + <li>각 worker들의 상태, worker가 처리한 요청의 개수와 + worker가 서비스한 전체 바이트수 (*)</li> <li>총 접근 횟수와 서비스한 바이트수 (*)</li> @@ -52,7 +52,7 @@ <li>초당 요청수 평균, 초당 서비스한 바이트수와 요청당 바이트수 평균 (*)</li> - <li>현재 아파치 전체와 각 ### worker들의 CPU 비율 (*)</li> + <li>현재 아파치 전체와 각 worker들의 CPU 비율 (*)</li> <li>현재 처리하고 있는 호스트와 요청 (*)</li> </ul> diff --git a/docs/manual/mod/module-dict.xml.ko b/docs/manual/mod/module-dict.xml.ko index f099e11e71..ff9526fd24 100644 --- a/docs/manual/mod/module-dict.xml.ko +++ b/docs/manual/mod/module-dict.xml.ko @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="EUC-KR" ?> <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> -<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> <!-- English Revision: 1.6 --> <!-- diff --git a/docs/manual/mod/quickreference.html.ko.euc-kr b/docs/manual/mod/quickreference.html.ko.euc-kr index 7aac8f013b..41d68769d4 100644 --- a/docs/manual/mod/quickreference.html.ko.euc-kr +++ b/docs/manual/mod/quickreference.html.ko.euc-kr @@ -186,7 +186,7 @@ authentication</td></tr> <tr><td><a href="mod_cache.html#cachedisable">CacheDisable <var> url-string</var></a></td><td></td><td>sv</td><td>X</td></tr><tr><td class="descr" colspan="4">특정 URL을 캐쉬하지 않는다</td></tr> <tr class="odd"><td><a href="mod_cache.html#cacheenable">CacheEnable <var>cache_type</var> <var>url-string</var></a></td><td></td><td>sv</td><td>X</td></tr><tr class="odd"><td class="descr" colspan="4">지정한 저장관리자를 사용하여 지정한 URL을 캐쉬한다</td></tr> <tr><td><a href="mod_disk_cache.html#cacheexpirycheck">CacheExpiryCheck On|Off</a></td><td> On </td><td>sv</td><td>X</td></tr><tr><td class="descr" colspan="4">캐쉬에서 파일을 찾을때 만기시간을 고려할지 여부</td></tr> -<tr class="odd"><td><a href="mod_file_cache.html#cachefile">CacheFile <var>file-path</var> [<var>file-path</var>] ...</a></td><td></td><td>s</td><td>X</td></tr><tr class="odd"><td class="descr" colspan="4">Cache a list of file handles at startup time</td></tr> +<tr class="odd"><td><a href="mod_file_cache.html#cachefile">CacheFile <var>file-path</var> [<var>file-path</var>] ...</a></td><td></td><td>s</td><td>X</td></tr><tr class="odd"><td class="descr" colspan="4">시작시 여러 파일 핸들을 캐쉬한다</td></tr> <tr><td><a href="mod_cache.html#cacheforcecompletion">CacheForceCompletion <var>Percentage</var></a></td><td> 60 </td><td>sv</td><td>X</td></tr><tr><td class="descr" colspan="4">요청이 취소되더라도 서버가 파일을 계속 캐쉬하기위해 필요한 문서의 서비스률.</td></tr> <tr class="odd"><td><a href="mod_disk_cache.html#cachegcclean">CacheGcClean <var>hours</var> <var>url-string</var></a></td><td> ? </td><td>sv</td><td>X</td></tr><tr class="odd"><td class="descr" colspan="4">URL에 해당하는 변하지않은 캐쉬파일을 유지할 시간</td></tr> @@ -255,411 +255,412 @@ named file-system directory and sub-directories</td></tr> ... </DirectoryMatch></a></td><td></td><td>sv</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Enclose directives that apply to file-system directories matching a regular expression and their subdirectories</td></tr> -<tr><td><a href="core.html#documentroot">DocumentRoot <var>directory-path</var></a></td><td> /usr/local/apache/h +</td><td>sv</td><td>C</td></tr><tr><td class="descr" colspan="4">Directory that forms the main document tree visible +<tr><td><a href="mod_dir.html#directoryslash">DirectorySlash On|Off</a></td><td> On </td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">마지막 슬래쉬 리다이렉션을 키고 끈다</td></tr> +<tr class="odd"><td><a href="core.html#documentroot">DocumentRoot <var>directory-path</var></a></td><td> /usr/local/apache/h +</td><td>sv</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Directory that forms the main document tree visible from the web</td></tr> -<tr class="odd"><td><a href="mpm_common.html#enableexceptionhook" id="E" name="E">EnableExceptionHook On|Off</a></td><td> Off </td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Enables a hook that runs exception handlers +<tr><td><a href="mpm_common.html#enableexceptionhook" id="E" name="E">EnableExceptionHook On|Off</a></td><td> Off </td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Enables a hook that runs exception handlers after a crash</td></tr> -<tr><td><a href="core.html#enablemmap">EnableMMAP On|Off</a></td><td> On </td><td>svdh</td><td>C</td></tr><tr><td class="descr" colspan="4">Use memory-mapping to read files during delivery</td></tr> -<tr class="odd"><td><a href="core.html#enablesendfile">EnableSendfile On|Off</a></td><td> On </td><td>svdh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Use the kernel sendfile support to deliver files to the client</td></tr> -<tr><td><a href="core.html#errordocument">ErrorDocument <var>error-code</var> <var>document</var></a></td><td></td><td>svdh</td><td>C</td></tr><tr><td class="descr" colspan="4">What the server will return to the client +<tr class="odd"><td><a href="core.html#enablemmap">EnableMMAP On|Off</a></td><td> On </td><td>svdh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Use memory-mapping to read files during delivery</td></tr> +<tr><td><a href="core.html#enablesendfile">EnableSendfile On|Off</a></td><td> On </td><td>svdh</td><td>C</td></tr><tr><td class="descr" colspan="4">Use the kernel sendfile support to deliver files to the client</td></tr> +<tr class="odd"><td><a href="core.html#errordocument">ErrorDocument <var>error-code</var> <var>document</var></a></td><td></td><td>svdh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">What the server will return to the client in case of an error</td></tr> -<tr class="odd"><td><a href="core.html#errorlog"> ErrorLog <var>file-path</var>|syslog[:<var>facility</var>]</a></td><td> logs/error_log (Uni +</td><td>sv</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Location where the server will log errors</td></tr> -<tr><td><a href="mod_example.html#example">Example</a></td><td></td><td>svdh</td><td>X</td></tr><tr><td class="descr" colspan="4">아파치 모듈 API를 설명하기위한 예제 지시어</td></tr> -<tr class="odd"><td><a href="mod_expires.html#expiresactive">ExpiresActive On|Off</a></td><td></td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4"><code>Expires</code> 헤더를 생성한다</td></tr> -<tr><td><a href="mod_expires.html#expiresbytype">ExpiresByType <var>MIME-type</var> -<var><code>seconds</var></a></td><td></td><td>svdh</td><td>E</td></tr><tr><td class="descr" colspan="4">MIME type으로 <code>Expires</code> 헤더값을 설정한다</td></tr> -<tr class="odd"><td><a href="mod_expires.html#expiresdefault">ExpiresDefault <var><code>seconds</var></a></td><td></td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">만기시간을 계산하는 기본 알고리즘</td></tr> -<tr><td><a href="mod_status.html#extendedstatus">ExtendedStatus On|Off</a></td><td> Off </td><td>s</td><td>B</td></tr><tr><td class="descr" colspan="4">각 요청에 대한 자세한 상태 정보를 기록한다</td></tr> -<tr class="odd"><td><a href="mod_ext_filter.html#extfilterdefine">ExtFilterDefine <var>filtername</var> <var>parameters</var></a></td><td></td><td>s</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">외부 필터를 정의한다</td></tr> -<tr><td><a href="mod_ext_filter.html#extfilteroptions">ExtFilterOptions <var>option</var> [<var>option</var>] ...</a></td><td> DebugLevel=0 NoLogS +</td><td>d</td><td>E</td></tr><tr><td class="descr" colspan="4"><code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code> 옵션을 설정한다</td></tr> -<tr class="odd"><td><a href="core.html#fileetag" id="F" name="F">FileETag <var>component</var> ...</a></td><td> INode MTime Size </td><td>svdh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">File attributes used to create the ETag +<tr><td><a href="core.html#errorlog"> ErrorLog <var>file-path</var>|syslog[:<var>facility</var>]</a></td><td> logs/error_log (Uni +</td><td>sv</td><td>C</td></tr><tr><td class="descr" colspan="4">Location where the server will log errors</td></tr> +<tr class="odd"><td><a href="mod_example.html#example">Example</a></td><td></td><td>svdh</td><td>X</td></tr><tr class="odd"><td class="descr" colspan="4">아파치 모듈 API를 설명하기위한 예제 지시어</td></tr> +<tr><td><a href="mod_expires.html#expiresactive">ExpiresActive On|Off</a></td><td></td><td>svdh</td><td>E</td></tr><tr><td class="descr" colspan="4"><code>Expires</code> 헤더를 생성한다</td></tr> +<tr class="odd"><td><a href="mod_expires.html#expiresbytype">ExpiresByType <var>MIME-type</var> +<var><code>seconds</var></a></td><td></td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">MIME type으로 <code>Expires</code> 헤더값을 설정한다</td></tr> +<tr><td><a href="mod_expires.html#expiresdefault">ExpiresDefault <var><code>seconds</var></a></td><td></td><td>svdh</td><td>E</td></tr><tr><td class="descr" colspan="4">만기시간을 계산하는 기본 알고리즘</td></tr> +<tr class="odd"><td><a href="mod_status.html#extendedstatus">ExtendedStatus On|Off</a></td><td> Off </td><td>s</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">각 요청에 대한 자세한 상태 정보를 기록한다</td></tr> +<tr><td><a href="mod_ext_filter.html#extfilterdefine">ExtFilterDefine <var>filtername</var> <var>parameters</var></a></td><td></td><td>s</td><td>E</td></tr><tr><td class="descr" colspan="4">외부 필터를 정의한다</td></tr> +<tr class="odd"><td><a href="mod_ext_filter.html#extfilteroptions">ExtFilterOptions <var>option</var> [<var>option</var>] ...</a></td><td> DebugLevel=0 NoLogS +</td><td>d</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4"><code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code> 옵션을 설정한다</td></tr> +<tr><td><a href="core.html#fileetag" id="F" name="F">FileETag <var>component</var> ...</a></td><td> INode MTime Size </td><td>svdh</td><td>C</td></tr><tr><td class="descr" colspan="4">File attributes used to create the ETag HTTP response header</td></tr> -<tr><td><a href="core.html#files"><Files <var>filename</var>> ... </Files></a></td><td></td><td>svdh</td><td>C</td></tr><tr><td class="descr" colspan="4">Contains directives that apply to matched +<tr class="odd"><td><a href="core.html#files"><Files <var>filename</var>> ... </Files></a></td><td></td><td>svdh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Contains directives that apply to matched filenames</td></tr> -<tr class="odd"><td><a href="core.html#filesmatch"><FilesMatch <var>regex</var>> ... </FilesMatch></a></td><td></td><td>svdh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Contains directives that apply to regular-expression matched +<tr><td><a href="core.html#filesmatch"><FilesMatch <var>regex</var>> ... </FilesMatch></a></td><td></td><td>svdh</td><td>C</td></tr><tr><td class="descr" colspan="4">Contains directives that apply to regular-expression matched filenames</td></tr> -<tr><td><a href="mod_negotiation.html#forcelanguagepriority">ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback]</a></td><td> Prefer </td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">Action to take if a single acceptable document is not +<tr class="odd"><td><a href="mod_negotiation.html#forcelanguagepriority">ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback]</a></td><td> Prefer </td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Action to take if a single acceptable document is not found</td></tr> -<tr class="odd"><td><a href="core.html#forcetype">ForceType <var>MIME-type</var>|None</a></td><td></td><td>dh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Forces all matching files to be served with the specified +<tr><td><a href="core.html#forcetype">ForceType <var>MIME-type</var>|None</a></td><td></td><td>dh</td><td>C</td></tr><tr><td class="descr" colspan="4">Forces all matching files to be served with the specified MIME content-type</td></tr> -<tr><td><a href="mod_log_forensic.html#forensiclog">ForensicLog <var>filename</var>|<var>pipe</var></a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Sets filename of the forensic log</td></tr> -<tr class="odd"><td><a href="mpm_common.html#group" id="G" name="G">Group <var>unix-group</var></a></td><td> #-1 </td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Group under which the server will answer +<tr class="odd"><td><a href="mod_log_forensic.html#forensiclog">ForensicLog <var>filename</var>|<var>pipe</var></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Sets filename of the forensic log</td></tr> +<tr><td><a href="mpm_common.html#group" id="G" name="G">Group <var>unix-group</var></a></td><td> #-1 </td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Group under which the server will answer requests</td></tr> -<tr><td><a href="mod_headers.html#header" id="H" name="H">Header [<var>condition</var>] set|append|add|unset|echo -<var>header</var> [<var>value</var>] [early|env=[!]<var>variable</var>]</a></td><td></td><td>svdh</td><td>E</td></tr><tr><td class="descr" colspan="4">Configure HTTP response headers</td></tr> -<tr class="odd"><td><a href="mod_autoindex.html#headername">HeaderName <var>filename</var></a></td><td></td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">파일목록 위에 삽입할 파일의 이름</td></tr> -<tr><td><a href="core.html#hostnamelookups">HostnameLookups On|Off|Double</a></td><td> Off </td><td>svd</td><td>C</td></tr><tr><td class="descr" colspan="4">Enables DNS lookups on client IP addresses</td></tr> -<tr class="odd"><td><a href="mod_ident.html#identitycheck" id="I" name="I">IdentityCheck On|Off</a></td><td> Off </td><td>svd</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Enables logging of the RFC 1413 identity of the remote +<tr class="odd"><td><a href="mod_headers.html#header" id="H" name="H">Header [<var>condition</var>] set|append|add|unset|echo +<var>header</var> [<var>value</var>] [early|env=[!]<var>variable</var>]</a></td><td></td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Configure HTTP response headers</td></tr> +<tr><td><a href="mod_autoindex.html#headername">HeaderName <var>filename</var></a></td><td></td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">파일목록 위에 삽입할 파일의 이름</td></tr> +<tr class="odd"><td><a href="core.html#hostnamelookups">HostnameLookups On|Off|Double</a></td><td> Off </td><td>svd</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Enables DNS lookups on client IP addresses</td></tr> +<tr><td><a href="mod_ident.html#identitycheck" id="I" name="I">IdentityCheck On|Off</a></td><td> Off </td><td>svd</td><td>E</td></tr><tr><td class="descr" colspan="4">Enables logging of the RFC 1413 identity of the remote user</td></tr> -<tr><td><a href="mod_ident.html#identitychecktimeout">IdentityCheckTimeout <var>seconds</var></a></td><td> 30 </td><td>svd</td><td>E</td></tr><tr><td class="descr" colspan="4">Determines the timeout duration for ident requests</td></tr> -<tr class="odd"><td><a href="core.html#ifdefine"><IfDefine [!]<var>parameter-name</var>> ... - </IfDefine></a></td><td></td><td>svdh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Encloses directives that will be processed only +<tr class="odd"><td><a href="mod_ident.html#identitychecktimeout">IdentityCheckTimeout <var>seconds</var></a></td><td> 30 </td><td>svd</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Determines the timeout duration for ident requests</td></tr> +<tr><td><a href="core.html#ifdefine"><IfDefine [!]<var>parameter-name</var>> ... + </IfDefine></a></td><td></td><td>svdh</td><td>C</td></tr><tr><td class="descr" colspan="4">Encloses directives that will be processed only if a test is true at startup</td></tr> -<tr><td><a href="core.html#ifmodule"><IfModule [!]<var>module-file</var>|<var>module-identifier</var>> ... - </IfModule></a></td><td></td><td>svdh</td><td>C</td></tr><tr><td class="descr" colspan="4">Encloses directives that are processed conditional on the +<tr class="odd"><td><a href="core.html#ifmodule"><IfModule [!]<var>module-file</var>|<var>module-identifier</var>> ... + </IfModule></a></td><td></td><td>svdh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Encloses directives that are processed conditional on the presence or absence of a specific module</td></tr> -<tr class="odd"><td><a href="mod_version.html#ifversion"><IfVersion [[!]<var>operator</var>] <var>version</var>> ... -</IfVersion></a></td><td></td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">contains version dependent configuration</td></tr> -<tr><td><a href="mod_imap.html#imapbase">ImapBase map|referer|<var>URL</var></a></td><td> http://servername/ </td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">Default <code>base</code> for imagemap files</td></tr> -<tr class="odd"><td><a href="mod_imap.html#imapdefault">ImapDefault error|nocontent|map|referer|<var>URL</var></a></td><td> nocontent </td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Default action when an imagemap is called with coordinates +<tr><td><a href="mod_version.html#ifversion"><IfVersion [[!]<var>operator</var>] <var>version</var>> ... +</IfVersion></a></td><td></td><td>svdh</td><td>E</td></tr><tr><td class="descr" colspan="4">contains version dependent configuration</td></tr> +<tr class="odd"><td><a href="mod_imap.html#imapbase">ImapBase map|referer|<var>URL</var></a></td><td> http://servername/ </td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Default <code>base</code> for imagemap files</td></tr> +<tr><td><a href="mod_imap.html#imapdefault">ImapDefault error|nocontent|map|referer|<var>URL</var></a></td><td> nocontent </td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">Default action when an imagemap is called with coordinates that are not explicitly mapped</td></tr> -<tr><td><a href="mod_imap.html#imapmenu">ImapMenu none|formatted|semiformatted|unformatted</a></td><td></td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">Action if no coordinates are given when calling +<tr class="odd"><td><a href="mod_imap.html#imapmenu">ImapMenu none|formatted|semiformatted|unformatted</a></td><td></td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Action if no coordinates are given when calling an imagemap</td></tr> -<tr class="odd"><td><a href="core.html#include">Include <var>file-path</var>|<var>directory-path</var></a></td><td></td><td>svd</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Includes other configuration files from within +<tr><td><a href="core.html#include">Include <var>file-path</var>|<var>directory-path</var></a></td><td></td><td>svd</td><td>C</td></tr><tr><td class="descr" colspan="4">Includes other configuration files from within the server configuration files</td></tr> -<tr><td><a href="mod_autoindex.html#indexignore">IndexIgnore <var>file</var> [<var>file</var>] ...</a></td><td></td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">디렉토리 목록에서 숨길 파일목록을 추가한다</td></tr> -<tr class="odd"><td><a href="mod_autoindex.html#indexoptions">IndexOptions [+|-]<var>option</var> [[+|-]<var>option</var>] -...</a></td><td></td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">디렉토리 목록의 여러 설정들</td></tr> -<tr><td><a href="mod_autoindex.html#indexorderdefault">IndexOrderDefault Ascending|Descending -Name|Date|Size|Description</a></td><td> Ascending Name </td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">디렉토리 목록의 기본 순서를 설정한다</td></tr> -<tr class="odd"><td><a href="mod_autoindex.html#indexstylesheet">IndexStyleSheet <var>url-path</var></a></td><td></td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">디렉토리 목록에 CSS 스타일쉬트를 추가한다</td></tr> -<tr><td><a href="mod_isapi.html#isapiappendlogtoerrors">ISAPIAppendLogToErrors on|off</a></td><td> off </td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">Record <code>HSE_APPEND_LOG_PARAMETER</code> requests from +<tr class="odd"><td><a href="mod_autoindex.html#indexignore">IndexIgnore <var>file</var> [<var>file</var>] ...</a></td><td></td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">디렉토리 목록에서 숨길 파일목록을 추가한다</td></tr> +<tr><td><a href="mod_autoindex.html#indexoptions">IndexOptions [+|-]<var>option</var> [[+|-]<var>option</var>] +...</a></td><td></td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">디렉토리 목록의 여러 설정들</td></tr> +<tr class="odd"><td><a href="mod_autoindex.html#indexorderdefault">IndexOrderDefault Ascending|Descending +Name|Date|Size|Description</a></td><td> Ascending Name </td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">디렉토리 목록의 기본 순서를 설정한다</td></tr> +<tr><td><a href="mod_autoindex.html#indexstylesheet">IndexStyleSheet <var>url-path</var></a></td><td></td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">디렉토리 목록에 CSS 스타일쉬트를 추가한다</td></tr> +<tr class="odd"><td><a href="mod_isapi.html#isapiappendlogtoerrors">ISAPIAppendLogToErrors on|off</a></td><td> off </td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Record <code>HSE_APPEND_LOG_PARAMETER</code> requests from ISAPI extensions to the error log</td></tr> -<tr class="odd"><td><a href="mod_isapi.html#isapiappendlogtoquery">ISAPIAppendLogToQuery on|off</a></td><td> on </td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Record <code>HSE_APPEND_LOG_PARAMETER</code> requests from +<tr><td><a href="mod_isapi.html#isapiappendlogtoquery">ISAPIAppendLogToQuery on|off</a></td><td> on </td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">Record <code>HSE_APPEND_LOG_PARAMETER</code> requests from ISAPI extensions to the query field</td></tr> -<tr><td><a href="mod_isapi.html#isapicachefile">ISAPICacheFile <var>file-path</var> [<var>file-path</var>] -...</a></td><td></td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">ISAPI .dll files to be loaded at startup</td></tr> -<tr class="odd"><td><a href="mod_isapi.html#isapifakeasync">ISAPIFakeAsync on|off</a></td><td> off </td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Fake asynchronous support for ISAPI callbacks</td></tr> -<tr><td><a href="mod_isapi.html#isapilognotsupported">ISAPILogNotSupported on|off</a></td><td> off </td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">Log unsupported feature requests from ISAPI +<tr class="odd"><td><a href="mod_isapi.html#isapicachefile">ISAPICacheFile <var>file-path</var> [<var>file-path</var>] +...</a></td><td></td><td>sv</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">ISAPI .dll files to be loaded at startup</td></tr> +<tr><td><a href="mod_isapi.html#isapifakeasync">ISAPIFakeAsync on|off</a></td><td> off </td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">Fake asynchronous support for ISAPI callbacks</td></tr> +<tr class="odd"><td><a href="mod_isapi.html#isapilognotsupported">ISAPILogNotSupported on|off</a></td><td> off </td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Log unsupported feature requests from ISAPI extensions</td></tr> -<tr class="odd"><td><a href="mod_isapi.html#isapireadaheadbuffer">ISAPIReadAheadBuffer <var>size</var></a></td><td> 49152 </td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Size of the Read Ahead Buffer sent to ISAPI +<tr><td><a href="mod_isapi.html#isapireadaheadbuffer">ISAPIReadAheadBuffer <var>size</var></a></td><td> 49152 </td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">Size of the Read Ahead Buffer sent to ISAPI extensions</td></tr> -<tr><td><a href="core.html#keepalive" id="K" name="K">KeepAlive On|Off</a></td><td> On </td><td>sv</td><td>C</td></tr><tr><td class="descr" colspan="4">Enables HTTP persistent connections</td></tr> -<tr class="odd"><td><a href="core.html#keepalivetimeout">KeepAliveTimeout <var>seconds</var></a></td><td> 15 </td><td>sv</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Amount of time the server will wait for subsequent +<tr class="odd"><td><a href="core.html#keepalive" id="K" name="K">KeepAlive On|Off</a></td><td> On </td><td>sv</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Enables HTTP persistent connections</td></tr> +<tr><td><a href="core.html#keepalivetimeout">KeepAliveTimeout <var>seconds</var></a></td><td> 15 </td><td>sv</td><td>C</td></tr><tr><td class="descr" colspan="4">Amount of time the server will wait for subsequent requests on a persistent connection</td></tr> -<tr><td><a href="mod_negotiation.html#languagepriority" id="L" name="L">LanguagePriority <var>MIME-lang</var> [<var>MIME-lang</var>] -...</a></td><td></td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">The precendence of language variants for cases where +<tr class="odd"><td><a href="mod_negotiation.html#languagepriority" id="L" name="L">LanguagePriority <var>MIME-lang</var> [<var>MIME-lang</var>] +...</a></td><td></td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">The precendence of language variants for cases where the client does not express a preference</td></tr> -<tr class="odd"><td><a href="mod_ldap.html#ldapcacheentries">LDAPCacheEntries <var>number</var></a></td><td> 1024 </td><td>s</td><td>X</td></tr><tr class="odd"><td class="descr" colspan="4">Maximum number of entries in the primary LDAP cache</td></tr> -<tr><td><a href="mod_ldap.html#ldapcachettl">LDAPCacheTTL <var>seconds</var></a></td><td> 600 </td><td>s</td><td>X</td></tr><tr><td class="descr" colspan="4">Time that cached items remain valid</td></tr> -<tr class="odd"><td><a href="mod_ldap.html#ldapopcacheentries">LDAPOpCacheEntries <var>number</var></a></td><td> 1024 </td><td>s</td><td>X</td></tr><tr class="odd"><td class="descr" colspan="4">Number of entries used to cache LDAP compare +<tr><td><a href="mod_ldap.html#ldapcacheentries">LDAPCacheEntries <var>number</var></a></td><td> 1024 </td><td>s</td><td>X</td></tr><tr><td class="descr" colspan="4">Maximum number of entries in the primary LDAP cache</td></tr> +<tr class="odd"><td><a href="mod_ldap.html#ldapcachettl">LDAPCacheTTL <var>seconds</var></a></td><td> 600 </td><td>s</td><td>X</td></tr><tr class="odd"><td class="descr" colspan="4">Time that cached items remain valid</td></tr> +<tr><td><a href="mod_ldap.html#ldapopcacheentries">LDAPOpCacheEntries <var>number</var></a></td><td> 1024 </td><td>s</td><td>X</td></tr><tr><td class="descr" colspan="4">Number of entries used to cache LDAP compare operations</td></tr> -<tr><td><a href="mod_ldap.html#ldapopcachettl">LDAPOpCacheTTL <var>seconds</var></a></td><td> 600 </td><td>s</td><td>X</td></tr><tr><td class="descr" colspan="4">Time that entries in the operation cache remain +<tr class="odd"><td><a href="mod_ldap.html#ldapopcachettl">LDAPOpCacheTTL <var>seconds</var></a></td><td> 600 </td><td>s</td><td>X</td></tr><tr class="odd"><td class="descr" colspan="4">Time that entries in the operation cache remain valid</td></tr> -<tr class="odd"><td><a href="mod_ldap.html#ldapsharedcachefile">LDAPSharedCacheFile <var>directory-path/filename</var></a></td><td></td><td>s</td><td>X</td></tr><tr class="odd"><td class="descr" colspan="4">Sets the shared memory chache file</td></tr> -<tr><td><a href="mod_ldap.html#ldapsharedcachesize">LDAPSharedCacheSize <var>bytes</var></a></td><td> 102400 </td><td>s</td><td>X</td></tr><tr><td class="descr" colspan="4">Size in bytes of the shared-memory cache</td></tr> -<tr class="odd"><td><a href="mod_ldap.html#ldaptrustedca">LDAPTrustedCA <var>directory-path/filename</var></a></td><td></td><td>s</td><td>X</td></tr><tr class="odd"><td class="descr" colspan="4">Sets the file containing the trusted Certificate Authority certificate or database</td></tr> -<tr><td><a href="mod_ldap.html#ldaptrustedcatype">LDAPTrustedCAType <var>type</var></a></td><td></td><td>s</td><td>X</td></tr><tr><td class="descr" colspan="4">Specifies the type of the Certificate Authority file</td></tr> -<tr class="odd"><td><a href="core.html#limit"><Limit <var>method</var> [<var>method</var>] ... > ... - </Limit></a></td><td></td><td>svdh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Restrict enclosed access controls to only certain HTTP +<tr><td><a href="mod_ldap.html#ldapsharedcachefile">LDAPSharedCacheFile <var>directory-path/filename</var></a></td><td></td><td>s</td><td>X</td></tr><tr><td class="descr" colspan="4">Sets the shared memory chache file</td></tr> +<tr class="odd"><td><a href="mod_ldap.html#ldapsharedcachesize">LDAPSharedCacheSize <var>bytes</var></a></td><td> 102400 </td><td>s</td><td>X</td></tr><tr class="odd"><td class="descr" colspan="4">Size in bytes of the shared-memory cache</td></tr> +<tr><td><a href="mod_ldap.html#ldaptrustedca">LDAPTrustedCA <var>directory-path/filename</var></a></td><td></td><td>s</td><td>X</td></tr><tr><td class="descr" colspan="4">Sets the file containing the trusted Certificate Authority certificate or database</td></tr> +<tr class="odd"><td><a href="mod_ldap.html#ldaptrustedcatype">LDAPTrustedCAType <var>type</var></a></td><td></td><td>s</td><td>X</td></tr><tr class="odd"><td class="descr" colspan="4">Specifies the type of the Certificate Authority file</td></tr> +<tr><td><a href="core.html#limit"><Limit <var>method</var> [<var>method</var>] ... > ... + </Limit></a></td><td></td><td>svdh</td><td>C</td></tr><tr><td class="descr" colspan="4">Restrict enclosed access controls to only certain HTTP methods</td></tr> -<tr><td><a href="core.html#limitexcept"><LimitExcept <var>method</var> [<var>method</var>] ... > ... - </LimitExcept></a></td><td></td><td>svdh</td><td>C</td></tr><tr><td class="descr" colspan="4">Restrict access controls to all HTTP methods +<tr class="odd"><td><a href="core.html#limitexcept"><LimitExcept <var>method</var> [<var>method</var>] ... > ... + </LimitExcept></a></td><td></td><td>svdh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Restrict access controls to all HTTP methods except the named ones</td></tr> -<tr class="odd"><td><a href="core.html#limitinternalrecursion">LimitInternalRecursion <var>number</var> [<var>number</var>]</a></td><td> 10 </td><td>sv</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Determine maximum number of internal redirects and nested +<tr><td><a href="core.html#limitinternalrecursion">LimitInternalRecursion <var>number</var> [<var>number</var>]</a></td><td> 10 </td><td>sv</td><td>C</td></tr><tr><td class="descr" colspan="4">Determine maximum number of internal redirects and nested subrequests</td></tr> -<tr><td><a href="core.html#limitrequestbody">LimitRequestBody <var>bytes</var></a></td><td> 0 </td><td>svdh</td><td>C</td></tr><tr><td class="descr" colspan="4">Restricts the total size of the HTTP request body sent +<tr class="odd"><td><a href="core.html#limitrequestbody">LimitRequestBody <var>bytes</var></a></td><td> 0 </td><td>svdh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Restricts the total size of the HTTP request body sent from the client</td></tr> -<tr class="odd"><td><a href="core.html#limitrequestfields">LimitRequestFields <var>number</var></a></td><td> 100 </td><td>s</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Limits the number of HTTP request header fields that +<tr><td><a href="core.html#limitrequestfields">LimitRequestFields <var>number</var></a></td><td> 100 </td><td>s</td><td>C</td></tr><tr><td class="descr" colspan="4">Limits the number of HTTP request header fields that will be accepted from the client</td></tr> -<tr><td><a href="core.html#limitrequestfieldsize">LimitRequestFieldsize <var>bytes</var></a></td><td></td><td>s</td><td>C</td></tr><tr><td class="descr" colspan="4">Limits the size of the HTTP request header allowed from the +<tr class="odd"><td><a href="core.html#limitrequestfieldsize">LimitRequestFieldsize <var>bytes</var></a></td><td></td><td>s</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Limits the size of the HTTP request header allowed from the client</td></tr> -<tr class="odd"><td><a href="core.html#limitrequestline">LimitRequestLine <var>bytes</var></a></td><td> 8190 </td><td>s</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Limit the size of the HTTP request line that will be accepted +<tr><td><a href="core.html#limitrequestline">LimitRequestLine <var>bytes</var></a></td><td> 8190 </td><td>s</td><td>C</td></tr><tr><td class="descr" colspan="4">Limit the size of the HTTP request line that will be accepted from the client</td></tr> -<tr><td><a href="core.html#limitxmlrequestbody">LimitXMLRequestBody <var>bytes</var></a></td><td> 1000000 </td><td>svdh</td><td>C</td></tr><tr><td class="descr" colspan="4">Limits the size of an XML-based request body</td></tr> -<tr class="odd"><td><a href="mpm_common.html#listen">Listen [<var>IP-address</var>:]<var>portnumber</var></a></td><td></td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">IP addresses and ports that the server +<tr class="odd"><td><a href="core.html#limitxmlrequestbody">LimitXMLRequestBody <var>bytes</var></a></td><td> 1000000 </td><td>svdh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Limits the size of an XML-based request body</td></tr> +<tr><td><a href="mpm_common.html#listen">Listen [<var>IP-address</var>:]<var>portnumber</var></a></td><td></td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">IP addresses and ports that the server listens to</td></tr> -<tr><td><a href="mpm_common.html#listenbacklog">ListenBacklog <var>backlog</var></a></td><td></td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Maximum length of the queue of pending connections</td></tr> -<tr class="odd"><td><a href="mod_so.html#loadfile">LoadFile <em>filename</em> [<em>filename</em>] ...</a></td><td></td><td>s</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">지정한 목적파일이나 라이브러리를 읽어들인다</td></tr> -<tr><td><a href="mod_so.html#loadmodule">LoadModule <em>module filename</em></a></td><td></td><td>s</td><td>E</td></tr><tr><td class="descr" colspan="4">목적파일이나 라이브러리를 읽어들이고, 사용가능한 +<tr class="odd"><td><a href="mpm_common.html#listenbacklog">ListenBacklog <var>backlog</var></a></td><td></td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Maximum length of the queue of pending connections</td></tr> +<tr><td><a href="mod_so.html#loadfile">LoadFile <em>filename</em> [<em>filename</em>] ...</a></td><td></td><td>s</td><td>E</td></tr><tr><td class="descr" colspan="4">지정한 목적파일이나 라이브러리를 읽어들인다</td></tr> +<tr class="odd"><td><a href="mod_so.html#loadmodule">LoadModule <em>module filename</em></a></td><td></td><td>s</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">목적파일이나 라이브러리를 읽어들이고, 사용가능한 모듈 목록에 추가한다</td></tr> -<tr class="odd"><td><a href="core.html#location"><Location - <var>URL-path</var>|<var>URL</var>> ... </Location></a></td><td></td><td>sv</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Applies the enclosed directives only to matching +<tr><td><a href="core.html#location"><Location + <var>URL-path</var>|<var>URL</var>> ... </Location></a></td><td></td><td>sv</td><td>C</td></tr><tr><td class="descr" colspan="4">Applies the enclosed directives only to matching URLs</td></tr> -<tr><td><a href="core.html#locationmatch"><LocationMatch - <var>regex</var>> ... </LocationMatch></a></td><td></td><td>sv</td><td>C</td></tr><tr><td class="descr" colspan="4">Applies the enclosed directives only to regular-expression +<tr class="odd"><td><a href="core.html#locationmatch"><LocationMatch + <var>regex</var>> ... </LocationMatch></a></td><td></td><td>sv</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Applies the enclosed directives only to regular-expression matching URLs</td></tr> -<tr class="odd"><td><a href="mpm_common.html#lockfile">LockFile <var>filename</var></a></td><td> logs/accept.lock </td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Location of the accept serialization lock file</td></tr> -<tr><td><a href="mod_log_config.html#logformat">LogFormat <var>format</var>|<var>nickname</var> -[<var>nickname</var>]</a></td><td> "%h %l %u %t \"%r\" +</td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">Describes a format for use in a log file</td></tr> -<tr class="odd"><td><a href="core.html#loglevel">LogLevel <var>level</var></a></td><td> warn </td><td>sv</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Controls the verbosity of the ErrorLog</td></tr> -<tr><td><a href="mpm_common.html#maxclients" id="M" name="M">MaxClients <var>number</var></a></td><td></td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Maximum number of child processes that will be created +<tr><td><a href="mpm_common.html#lockfile">LockFile <var>filename</var></a></td><td> logs/accept.lock </td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Location of the accept serialization lock file</td></tr> +<tr class="odd"><td><a href="mod_log_config.html#logformat">LogFormat <var>format</var>|<var>nickname</var> +[<var>nickname</var>]</a></td><td> "%h %l %u %t \"%r\" +</td><td>sv</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Describes a format for use in a log file</td></tr> +<tr><td><a href="core.html#loglevel">LogLevel <var>level</var></a></td><td> warn </td><td>sv</td><td>C</td></tr><tr><td class="descr" colspan="4">Controls the verbosity of the ErrorLog</td></tr> +<tr class="odd"><td><a href="mpm_common.html#maxclients" id="M" name="M">MaxClients <var>number</var></a></td><td></td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Maximum number of child processes that will be created to serve requests</td></tr> -<tr class="odd"><td><a href="core.html#maxkeepaliverequests">MaxKeepAliveRequests <var>number</var></a></td><td> 100 </td><td>sv</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Number of requests allowed on a persistent +<tr><td><a href="core.html#maxkeepaliverequests">MaxKeepAliveRequests <var>number</var></a></td><td> 100 </td><td>sv</td><td>C</td></tr><tr><td class="descr" colspan="4">Number of requests allowed on a persistent connection</td></tr> -<tr><td><a href="mpm_common.html#maxmemfree">MaxMemFree <var>KBytes</var></a></td><td> 0 </td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Maximum amount of memory that the main allocator is allowed +<tr class="odd"><td><a href="mpm_common.html#maxmemfree">MaxMemFree <var>KBytes</var></a></td><td> 0 </td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Maximum amount of memory that the main allocator is allowed to hold without calling <code>free()</code></td></tr> -<tr class="odd"><td><a href="mpm_common.html#maxrequestsperchild">MaxRequestsPerChild <var>number</var></a></td><td> 10000 </td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Limit on the number of requests that an individual child server +<tr><td><a href="mpm_common.html#maxrequestsperchild">MaxRequestsPerChild <var>number</var></a></td><td> 10000 </td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Limit on the number of requests that an individual child server will handle during its life</td></tr> -<tr><td><a href="beos.html#maxrequestsperthread">MaxRequestsPerThread <var>number</var></a></td><td> 0 </td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">한 쓰레드가 실행하는 동안 처리할 요청개수 한계</td></tr> -<tr class="odd"><td><a href="prefork.html#maxspareservers">MaxSpareServers <var>number</var></a></td><td> 10 </td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Maximum number of idle child server processes</td></tr> -<tr><td><a href="mpm_common.html#maxsparethreads">MaxSpareThreads <var>number</var></a></td><td></td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Maximum number of idle threads</td></tr> -<tr class="odd"><td><a href="mpm_netware.html#maxthreads">MaxThreads <var>number</var></a></td><td> 2048 </td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Set the maximum number of worker threads</td></tr> -<tr><td><a href="perchild.html#maxthreadsperchild">MaxThreadsPerChild <var>number</var></a></td><td> 64 </td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Maximum number of threads per child process</td></tr> -<tr class="odd"><td><a href="mod_mem_cache.html#mcachemaxobjectcount">MCacheMaxObjectCount <var>value</var></a></td><td> 1009 </td><td>s</td><td>X</td></tr><tr class="odd"><td class="descr" colspan="4">The maximum number of objects allowed to be placed in the +<tr class="odd"><td><a href="beos.html#maxrequestsperthread">MaxRequestsPerThread <var>number</var></a></td><td> 0 </td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">한 쓰레드가 실행하는 동안 처리할 요청개수 한계</td></tr> +<tr><td><a href="prefork.html#maxspareservers">MaxSpareServers <var>number</var></a></td><td> 10 </td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Maximum number of idle child server processes</td></tr> +<tr class="odd"><td><a href="mpm_common.html#maxsparethreads">MaxSpareThreads <var>number</var></a></td><td></td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Maximum number of idle threads</td></tr> +<tr><td><a href="mpm_netware.html#maxthreads">MaxThreads <var>number</var></a></td><td> 2048 </td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Set the maximum number of worker threads</td></tr> +<tr class="odd"><td><a href="perchild.html#maxthreadsperchild">MaxThreadsPerChild <var>number</var></a></td><td> 64 </td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Maximum number of threads per child process</td></tr> +<tr><td><a href="mod_mem_cache.html#mcachemaxobjectcount">MCacheMaxObjectCount <var>value</var></a></td><td> 1009 </td><td>s</td><td>X</td></tr><tr><td class="descr" colspan="4">The maximum number of objects allowed to be placed in the cache</td></tr> -<tr><td><a href="mod_mem_cache.html#mcachemaxobjectsize">MCacheMaxObjectSize <var>bytes</var></a></td><td> 10000 </td><td>s</td><td>X</td></tr><tr><td class="descr" colspan="4">The maximum size (in bytes) of a document allowed in the +<tr class="odd"><td><a href="mod_mem_cache.html#mcachemaxobjectsize">MCacheMaxObjectSize <var>bytes</var></a></td><td> 10000 </td><td>s</td><td>X</td></tr><tr class="odd"><td class="descr" colspan="4">The maximum size (in bytes) of a document allowed in the cache</td></tr> -<tr class="odd"><td><a href="mod_mem_cache.html#mcachemaxstreamingbuffer">MCacheMaxStreamingBuffer <var>size_in_bytes</var></a></td><td> the smaller of 1000 +</td><td>s</td><td>X</td></tr><tr class="odd"><td class="descr" colspan="4">Maximum amount of a streamed response to buffer in memory +<tr><td><a href="mod_mem_cache.html#mcachemaxstreamingbuffer">MCacheMaxStreamingBuffer <var>size_in_bytes</var></a></td><td> the smaller of 1000 +</td><td>s</td><td>X</td></tr><tr><td class="descr" colspan="4">Maximum amount of a streamed response to buffer in memory before declaring the response uncacheable</td></tr> -<tr><td><a href="mod_mem_cache.html#mcacheminobjectsize">MCacheMinObjectSize <var>bytes</var></a></td><td> 0 </td><td>s</td><td>X</td></tr><tr><td class="descr" colspan="4">The minimum size (in bytes) of a document to be allowed in the +<tr class="odd"><td><a href="mod_mem_cache.html#mcacheminobjectsize">MCacheMinObjectSize <var>bytes</var></a></td><td> 0 </td><td>s</td><td>X</td></tr><tr class="odd"><td class="descr" colspan="4">The minimum size (in bytes) of a document to be allowed in the cache</td></tr> -<tr class="odd"><td><a href="mod_mem_cache.html#mcacheremovalalgorithm">MCacheRemovalAlgorithm LRU|GDSF</a></td><td> GDSF </td><td>s</td><td>X</td></tr><tr class="odd"><td class="descr" colspan="4">The algorithm used to select documents for removal from the +<tr><td><a href="mod_mem_cache.html#mcacheremovalalgorithm">MCacheRemovalAlgorithm LRU|GDSF</a></td><td> GDSF </td><td>s</td><td>X</td></tr><tr><td class="descr" colspan="4">The algorithm used to select documents for removal from the cache</td></tr> -<tr><td><a href="mod_mem_cache.html#mcachesize">MCacheSize <var>KBytes</var></a></td><td> 100 </td><td>s</td><td>X</td></tr><tr><td class="descr" colspan="4">The maximum amount of memory used by the cache in +<tr class="odd"><td><a href="mod_mem_cache.html#mcachesize">MCacheSize <var>KBytes</var></a></td><td> 100 </td><td>s</td><td>X</td></tr><tr class="odd"><td class="descr" colspan="4">The maximum amount of memory used by the cache in KBytes</td></tr> -<tr class="odd"><td><a href="mod_cern_meta.html#metadir">MetaDir <var>directory</var></a></td><td> .web </td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">CERN 메타정보를 찾을 디렉토리 이름</td></tr> -<tr><td><a href="mod_cern_meta.html#metafiles">MetaFiles on|off</a></td><td> off </td><td>svdh</td><td>E</td></tr><tr><td class="descr" colspan="4">CERN 메타파일을 처리한다</td></tr> -<tr class="odd"><td><a href="mod_cern_meta.html#metasuffix">MetaSuffix <var>suffix</var></a></td><td> .meta </td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">CERN 메타정보를 저장하는 파일의 접미사</td></tr> -<tr><td><a href="mod_mime_magic.html#mimemagicfile">MimeMagicFile <var>file-path</var></a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Enable MIME-type determination based on file contents +<tr><td><a href="mod_cern_meta.html#metadir">MetaDir <var>directory</var></a></td><td> .web </td><td>svdh</td><td>E</td></tr><tr><td class="descr" colspan="4">CERN 메타정보를 찾을 디렉토리 이름</td></tr> +<tr class="odd"><td><a href="mod_cern_meta.html#metafiles">MetaFiles on|off</a></td><td> off </td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">CERN 메타파일을 처리한다</td></tr> +<tr><td><a href="mod_cern_meta.html#metasuffix">MetaSuffix <var>suffix</var></a></td><td> .meta </td><td>svdh</td><td>E</td></tr><tr><td class="descr" colspan="4">CERN 메타정보를 저장하는 파일의 접미사</td></tr> +<tr class="odd"><td><a href="mod_mime_magic.html#mimemagicfile">MimeMagicFile <var>file-path</var></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Enable MIME-type determination based on file contents using the specified magic file</td></tr> -<tr class="odd"><td><a href="prefork.html#minspareservers">MinSpareServers <var>number</var></a></td><td> 5 </td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Minimum number of idle child server processes</td></tr> -<tr><td><a href="mpm_common.html#minsparethreads">MinSpareThreads <var>number</var></a></td><td></td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Minimum number of idle threads available to handle request +<tr><td><a href="prefork.html#minspareservers">MinSpareServers <var>number</var></a></td><td> 5 </td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Minimum number of idle child server processes</td></tr> +<tr class="odd"><td><a href="mpm_common.html#minsparethreads">MinSpareThreads <var>number</var></a></td><td></td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Minimum number of idle threads available to handle request spikes</td></tr> -<tr class="odd"><td><a href="mod_file_cache.html#mmapfile">MMapFile <var>file-path</var> [<var>file-path</var>] ...</a></td><td></td><td>s</td><td>X</td></tr><tr class="odd"><td class="descr" colspan="4">Map a list of files into memory at startup time</td></tr> -<tr><td><a href="mod_mime.html#modmimeusepathinfo">ModMimeUsePathInfo On|Off</a></td><td> Off </td><td>d</td><td>B</td></tr><tr><td class="descr" colspan="4">Tells <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> to treat <code>path_info</code> +<tr><td><a href="mod_file_cache.html#mmapfile">MMapFile <var>file-path</var> [<var>file-path</var>] ...</a></td><td></td><td>s</td><td>X</td></tr><tr><td class="descr" colspan="4">시작시 여러 파일을 메모리에 대응한다</td></tr> +<tr class="odd"><td><a href="mod_mime.html#modmimeusepathinfo">ModMimeUsePathInfo On|Off</a></td><td> Off </td><td>d</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Tells <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> to treat <code>path_info</code> components as part of the filename</td></tr> -<tr class="odd"><td><a href="mod_mime.html#multiviewsmatch">MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers -[Handlers|Filters]</a></td><td> NegotiatedOnly </td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">The types of files that will be included when searching for +<tr><td><a href="mod_mime.html#multiviewsmatch">MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers +[Handlers|Filters]</a></td><td> NegotiatedOnly </td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">The types of files that will be included when searching for a matching file with MultiViews</td></tr> -<tr><td><a href="core.html#namevirtualhost" id="N" name="N">NameVirtualHost <var>addr</var>[:<var>port</var>]</a></td><td></td><td>s</td><td>C</td></tr><tr><td class="descr" colspan="4">Designates an IP address for name-virtual +<tr class="odd"><td><a href="core.html#namevirtualhost" id="N" name="N">NameVirtualHost <var>addr</var>[:<var>port</var>]</a></td><td></td><td>s</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Designates an IP address for name-virtual hosting</td></tr> -<tr class="odd"><td><a href="mod_proxy.html#noproxy">NoProxy <var>host</var> [<var>host</var>] ...</a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Hosts, domains, or networks that will be connected to +<tr><td><a href="mod_proxy.html#noproxy">NoProxy <var>host</var> [<var>host</var>] ...</a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Hosts, domains, or networks that will be connected to directly</td></tr> -<tr><td><a href="perchild.html#numservers">NumServers <var>number</var></a></td><td> 2 </td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Total number of children alive at the same time</td></tr> -<tr class="odd"><td><a href="mod_nw_ssl.html#nwssltrustedcerts">NWSSLTrustedCerts <var>filename</var> [<var>filename</var>] ...</a></td><td></td><td>s</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">List of additional client certificates</td></tr> -<tr><td><a href="core.html#options" id="O" name="O">Options - [+|-]<var>option</var> [[+|-]<var>option</var>] ...</a></td><td> All </td><td>svdh</td><td>C</td></tr><tr><td class="descr" colspan="4">Configures what features are available in a particular +<tr class="odd"><td><a href="perchild.html#numservers">NumServers <var>number</var></a></td><td> 2 </td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Total number of children alive at the same time</td></tr> +<tr><td><a href="mod_nw_ssl.html#nwssltrustedcerts">NWSSLTrustedCerts <var>filename</var> [<var>filename</var>] ...</a></td><td></td><td>s</td><td>B</td></tr><tr><td class="descr" colspan="4">List of additional client certificates</td></tr> +<tr class="odd"><td><a href="core.html#options" id="O" name="O">Options + [+|-]<var>option</var> [[+|-]<var>option</var>] ...</a></td><td> All </td><td>svdh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Configures what features are available in a particular directory</td></tr> -<tr class="odd"><td><a href="mod_authz_host.html#order"> Order <var>ordering</var></a></td><td> Deny,Allow </td><td>dh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">기본적으로 접근을 허용할지 거부할지 여부와 +<tr><td><a href="mod_authz_host.html#order"> Order <var>ordering</var></a></td><td> Deny,Allow </td><td>dh</td><td>B</td></tr><tr><td class="descr" colspan="4">기본적으로 접근을 허용할지 거부할지 여부와 <code class="directive">Allow</code>와 <code class="directive">Deny</code> 처리순서를 정한다.</td></tr> -<tr><td><a href="mod_env.html#passenv" id="P" name="P">PassEnv <var>env-variable</var> [<var>env-variable</var>] -...</a></td><td></td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">쉘에서 환경변수를 가져온다</td></tr> -<tr class="odd"><td><a href="mpm_common.html#pidfile">PidFile <var>filename</var></a></td><td> logs/httpd.pid </td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">File where the server records the process ID +<tr class="odd"><td><a href="mod_env.html#passenv" id="P" name="P">PassEnv <var>env-variable</var> [<var>env-variable</var>] +...</a></td><td></td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">쉘에서 환경변수를 가져온다</td></tr> +<tr><td><a href="mpm_common.html#pidfile">PidFile <var>filename</var></a></td><td> logs/httpd.pid </td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">File where the server records the process ID of the daemon</td></tr> -<tr><td><a href="mod_echo.html#protocolecho">ProtocolEcho On|Off</a></td><td></td><td>sv</td><td>X</td></tr><tr><td class="descr" colspan="4">echo 서버를 키고 끈다</td></tr> -<tr class="odd"><td><a href="mod_proxy.html#proxy"><Proxy <var>wildcard-url</var>> ...</Proxy></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Container for directives applied to proxied resources</td></tr> -<tr><td><a href="mod_proxy.html#proxybadheader">ProxyBadHeader IsError|Ignore|StartBody</a></td><td> IsError </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Determines how to handle bad header lines in a +<tr class="odd"><td><a href="mod_echo.html#protocolecho">ProtocolEcho On|Off</a></td><td></td><td>sv</td><td>X</td></tr><tr class="odd"><td class="descr" colspan="4">echo 서버를 키고 끈다</td></tr> +<tr><td><a href="mod_proxy.html#proxy"><Proxy <var>wildcard-url</var>> ...</Proxy></a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Container for directives applied to proxied resources</td></tr> +<tr class="odd"><td><a href="mod_proxy.html#proxybadheader">ProxyBadHeader IsError|Ignore|StartBody</a></td><td> IsError </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Determines how to handle bad header lines in a response</td></tr> -<tr class="odd"><td><a href="mod_proxy.html#proxyblock">ProxyBlock *|<var>word</var>|<var>host</var>|<var>domain</var> -[<var>word</var>|<var>host</var>|<var>domain</var>] ...</a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Words, hosts, or domains that are banned from being +<tr><td><a href="mod_proxy.html#proxyblock">ProxyBlock *|<var>word</var>|<var>host</var>|<var>domain</var> +[<var>word</var>|<var>host</var>|<var>domain</var>] ...</a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Words, hosts, or domains that are banned from being proxied</td></tr> -<tr><td><a href="mod_proxy.html#proxydomain">ProxyDomain <var>Domain</var></a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Default domain name for proxied requests</td></tr> -<tr class="odd"><td><a href="mod_proxy.html#proxyerroroverride">ProxyErrorOverride On|Off</a></td><td> Off </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Override error pages for proxied content</td></tr> -<tr><td><a href="mod_proxy.html#proxyiobuffersize">ProxyIOBufferSize <var>bytes</var></a></td><td> 8192 </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Determine size of internal data throughput buffer</td></tr> -<tr class="odd"><td><a href="mod_proxy.html#proxymatch"><ProxyMatch <var>regex</var>> ...</ProxyMatch></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Container for directives applied to regular-expression-matched +<tr class="odd"><td><a href="mod_proxy.html#proxydomain">ProxyDomain <var>Domain</var></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Default domain name for proxied requests</td></tr> +<tr><td><a href="mod_proxy.html#proxyerroroverride">ProxyErrorOverride On|Off</a></td><td> Off </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Override error pages for proxied content</td></tr> +<tr class="odd"><td><a href="mod_proxy.html#proxyiobuffersize">ProxyIOBufferSize <var>bytes</var></a></td><td> 8192 </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Determine size of internal data throughput buffer</td></tr> +<tr><td><a href="mod_proxy.html#proxymatch"><ProxyMatch <var>regex</var>> ...</ProxyMatch></a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Container for directives applied to regular-expression-matched proxied resources</td></tr> -<tr><td><a href="mod_proxy.html#proxymaxforwards">ProxyMaxForwards <var>number</var></a></td><td> 10 </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Maximium number of proxies that a request can be forwarded +<tr class="odd"><td><a href="mod_proxy.html#proxymaxforwards">ProxyMaxForwards <var>number</var></a></td><td> 10 </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Maximium number of proxies that a request can be forwarded through</td></tr> -<tr class="odd"><td><a href="mod_proxy.html#proxypass">ProxyPass [<var>path</var>] !|<var>url</var></a></td><td></td><td>svd</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Maps remote servers into the local server URL-space</td></tr> -<tr><td><a href="mod_proxy.html#proxypassreverse">ProxyPassReverse [<var>path</var>] <var>url</var></a></td><td></td><td>svd</td><td>E</td></tr><tr><td class="descr" colspan="4">Adjusts the URL in HTTP response headers sent from a reverse +<tr><td><a href="mod_proxy.html#proxypass">ProxyPass [<var>path</var>] !|<var>url</var></a></td><td></td><td>svd</td><td>E</td></tr><tr><td class="descr" colspan="4">Maps remote servers into the local server URL-space</td></tr> +<tr class="odd"><td><a href="mod_proxy.html#proxypassreverse">ProxyPassReverse [<var>path</var>] <var>url</var></a></td><td></td><td>svd</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Adjusts the URL in HTTP response headers sent from a reverse proxied server</td></tr> -<tr class="odd"><td><a href="mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain <var>internal-domain</var> <var>public-domain</var></a></td><td></td><td>svd</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Adjusts the Domain string in Set-Cookie headers from a reverse- +<tr><td><a href="mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain <var>internal-domain</var> <var>public-domain</var></a></td><td></td><td>svd</td><td>E</td></tr><tr><td class="descr" colspan="4">Adjusts the Domain string in Set-Cookie headers from a reverse- proxied server</td></tr> -<tr><td><a href="mod_proxy.html#proxypassreversecookiepath">ProxyPassReverseCookiePath <var>internal-path</var> <var>public-path</var></a></td><td></td><td>svd</td><td>E</td></tr><tr><td class="descr" colspan="4">Adjusts the Path string in Set-Cookie headers from a reverse- +<tr class="odd"><td><a href="mod_proxy.html#proxypassreversecookiepath">ProxyPassReverseCookiePath <var>internal-path</var> <var>public-path</var></a></td><td></td><td>svd</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Adjusts the Path string in Set-Cookie headers from a reverse- proxied server</td></tr> -<tr class="odd"><td><a href="mod_proxy.html#proxypreservehost">ProxyPreserveHost On|Off</a></td><td> Off </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Use incoming Host HTTP request header for proxy +<tr><td><a href="mod_proxy.html#proxypreservehost">ProxyPreserveHost On|Off</a></td><td> Off </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Use incoming Host HTTP request header for proxy request</td></tr> -<tr><td><a href="mod_proxy.html#proxyreceivebuffersize">ProxyReceiveBufferSize <var>bytes</var></a></td><td> 0 </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Network buffer size for proxied HTTP and FTP +<tr class="odd"><td><a href="mod_proxy.html#proxyreceivebuffersize">ProxyReceiveBufferSize <var>bytes</var></a></td><td> 0 </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Network buffer size for proxied HTTP and FTP connections</td></tr> -<tr class="odd"><td><a href="mod_proxy.html#proxyremote">ProxyRemote <var>match</var> <var>remote-server</var></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Remote proxy used to handle certain requests</td></tr> -<tr><td><a href="mod_proxy.html#proxyremotematch">ProxyRemoteMatch <var>regex</var> <var>remote-server</var></a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Remote proxy used to handle requests matched by regular +<tr><td><a href="mod_proxy.html#proxyremote">ProxyRemote <var>match</var> <var>remote-server</var></a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Remote proxy used to handle certain requests</td></tr> +<tr class="odd"><td><a href="mod_proxy.html#proxyremotematch">ProxyRemoteMatch <var>regex</var> <var>remote-server</var></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Remote proxy used to handle requests matched by regular expressions</td></tr> -<tr class="odd"><td><a href="mod_proxy.html#proxyrequests">ProxyRequests On|Off</a></td><td> Off </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Enables forward (standard) proxy requests</td></tr> -<tr><td><a href="mod_proxy.html#proxytimeout">ProxyTimeout <var>seconds</var></a></td><td> 300 </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Network timeout for proxied requests</td></tr> -<tr class="odd"><td><a href="mod_proxy.html#proxyvia">ProxyVia On|Off|Full|Block</a></td><td> Off </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Information provided in the <code>Via</code> HTTP response +<tr><td><a href="mod_proxy.html#proxyrequests">ProxyRequests On|Off</a></td><td> Off </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Enables forward (standard) proxy requests</td></tr> +<tr class="odd"><td><a href="mod_proxy.html#proxytimeout">ProxyTimeout <var>seconds</var></a></td><td> 300 </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Network timeout for proxied requests</td></tr> +<tr><td><a href="mod_proxy.html#proxyvia">ProxyVia On|Off|Full|Block</a></td><td> Off </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Information provided in the <code>Via</code> HTTP response header for proxied requests</td></tr> -<tr><td><a href="mod_autoindex.html#readmename" id="R" name="R">ReadmeName <var>filename</var></a></td><td></td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">파일목록 마지막에 삽입할 파일의 이름</td></tr> -<tr class="odd"><td><a href="mod_alias.html#redirect">Redirect [<var>status</var>] <var>URL-path</var> -<var>URL</var></a></td><td></td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">클라이언트가 다른 URL에 접속하도록 요청하는 외부 +<tr class="odd"><td><a href="mod_autoindex.html#readmename" id="R" name="R">ReadmeName <var>filename</var></a></td><td></td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">파일목록 마지막에 삽입할 파일의 이름</td></tr> +<tr><td><a href="mod_alias.html#redirect">Redirect [<var>status</var>] <var>URL-path</var> +<var>URL</var></a></td><td></td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">클라이언트가 다른 URL에 접속하도록 요청하는 외부 리다이렉션을 보낸다</td></tr> -<tr><td><a href="mod_alias.html#redirectmatch">RedirectMatch [<var>status</var>] <var>regex</var> -<var>URL</var></a></td><td></td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">현재 URL이 정규표현식에 해당하면 외부 리다이렉션을 +<tr class="odd"><td><a href="mod_alias.html#redirectmatch">RedirectMatch [<var>status</var>] <var>regex</var> +<var>URL</var></a></td><td></td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">현재 URL이 정규표현식에 해당하면 외부 리다이렉션을 보낸다</td></tr> -<tr class="odd"><td><a href="mod_alias.html#redirectpermanent">RedirectPermanent <var>URL-path</var> <var>URL</var></a></td><td></td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">클라이언트가 다른 URL에 접속하도록 요청하는 외부 +<tr><td><a href="mod_alias.html#redirectpermanent">RedirectPermanent <var>URL-path</var> <var>URL</var></a></td><td></td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">클라이언트가 다른 URL에 접속하도록 요청하는 외부 영구 리다이렉션을 보낸다</td></tr> -<tr><td><a href="mod_alias.html#redirecttemp">RedirectTemp <var>URL-path</var> <var>URL</var></a></td><td></td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">클라이언트가 다른 URL에 접속하도록 요청하는 외부 +<tr class="odd"><td><a href="mod_alias.html#redirecttemp">RedirectTemp <var>URL-path</var> <var>URL</var></a></td><td></td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">클라이언트가 다른 URL에 접속하도록 요청하는 외부 임시 리다이렉션을 보낸다</td></tr> -<tr class="odd"><td><a href="mod_mime.html#removecharset">RemoveCharset <var>extension</var> [<var>extension</var>] -...</a></td><td></td><td>vdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Removes any character set associations for a set of file +<tr><td><a href="mod_mime.html#removecharset">RemoveCharset <var>extension</var> [<var>extension</var>] +...</a></td><td></td><td>vdh</td><td>B</td></tr><tr><td class="descr" colspan="4">Removes any character set associations for a set of file extensions</td></tr> -<tr><td><a href="mod_mime.html#removeencoding">RemoveEncoding <var>extension</var> [<var>extension</var>] -...</a></td><td></td><td>vdh</td><td>B</td></tr><tr><td class="descr" colspan="4">Removes any content encoding associations for a set of file +<tr class="odd"><td><a href="mod_mime.html#removeencoding">RemoveEncoding <var>extension</var> [<var>extension</var>] +...</a></td><td></td><td>vdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Removes any content encoding associations for a set of file extensions</td></tr> -<tr class="odd"><td><a href="mod_mime.html#removehandler">RemoveHandler <var>extension</var> [<var>extension</var>] -...</a></td><td></td><td>vdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Removes any handler associations for a set of file +<tr><td><a href="mod_mime.html#removehandler">RemoveHandler <var>extension</var> [<var>extension</var>] +...</a></td><td></td><td>vdh</td><td>B</td></tr><tr><td class="descr" colspan="4">Removes any handler associations for a set of file extensions</td></tr> -<tr><td><a href="mod_mime.html#removeinputfilter">RemoveInputFilter <var>extension</var> [<var>extension</var>] -...</a></td><td></td><td>vdh</td><td>B</td></tr><tr><td class="descr" colspan="4">Removes any input filter associations for a set of file +<tr class="odd"><td><a href="mod_mime.html#removeinputfilter">RemoveInputFilter <var>extension</var> [<var>extension</var>] +...</a></td><td></td><td>vdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Removes any input filter associations for a set of file extensions</td></tr> -<tr class="odd"><td><a href="mod_mime.html#removelanguage">RemoveLanguage <var>extension</var> [<var>extension</var>] -...</a></td><td></td><td>vdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Removes any language associations for a set of file +<tr><td><a href="mod_mime.html#removelanguage">RemoveLanguage <var>extension</var> [<var>extension</var>] +...</a></td><td></td><td>vdh</td><td>B</td></tr><tr><td class="descr" colspan="4">Removes any language associations for a set of file extensions</td></tr> -<tr><td><a href="mod_mime.html#removeoutputfilter">RemoveOutputFilter <var>extension</var> [<var>extension</var>] -...</a></td><td></td><td>vdh</td><td>B</td></tr><tr><td class="descr" colspan="4">Removes any output filter associations for a set of file +<tr class="odd"><td><a href="mod_mime.html#removeoutputfilter">RemoveOutputFilter <var>extension</var> [<var>extension</var>] +...</a></td><td></td><td>vdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Removes any output filter associations for a set of file extensions</td></tr> -<tr class="odd"><td><a href="mod_mime.html#removetype">RemoveType <var>extension</var> [<var>extension</var>] -...</a></td><td></td><td>vdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Removes any content type associations for a set of file +<tr><td><a href="mod_mime.html#removetype">RemoveType <var>extension</var> [<var>extension</var>] +...</a></td><td></td><td>vdh</td><td>B</td></tr><tr><td class="descr" colspan="4">Removes any content type associations for a set of file extensions</td></tr> -<tr><td><a href="mod_headers.html#requestheader">RequestHeader set|append|add|unset <var>header</var> -[<var>value</var>] [early|env=[!]<var>variable</var>]</a></td><td></td><td>svdh</td><td>E</td></tr><tr><td class="descr" colspan="4">Configure HTTP request headers</td></tr> -<tr class="odd"><td><a href="core.html#require">Require <var>entity-name</var> [<var>entity-name</var>] ...</a></td><td></td><td>dh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Selects which authenticated users can access +<tr class="odd"><td><a href="mod_headers.html#requestheader">RequestHeader set|append|add|unset <var>header</var> +[<var>value</var>] [early|env=[!]<var>variable</var>]</a></td><td></td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Configure HTTP request headers</td></tr> +<tr><td><a href="core.html#require">Require <var>entity-name</var> [<var>entity-name</var>] ...</a></td><td></td><td>dh</td><td>C</td></tr><tr><td class="descr" colspan="4">Selects which authenticated users can access a resource</td></tr> -<tr><td><a href="mod_rewrite.html#rewritebase">RewriteBase <em>URL-path</em></a></td><td></td><td>dh</td><td>E</td></tr><tr><td class="descr" colspan="4">Sets the base URL for per-directory rewrites</td></tr> -<tr class="odd"><td><a href="mod_rewrite.html#rewritecond"> RewriteCond - <em>TestString</em> <em>CondPattern</em></a></td><td></td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Defines a condition under which rewriting will take place +<tr class="odd"><td><a href="mod_rewrite.html#rewritebase">RewriteBase <em>URL-path</em></a></td><td></td><td>dh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Sets the base URL for per-directory rewrites</td></tr> +<tr><td><a href="mod_rewrite.html#rewritecond"> RewriteCond + <em>TestString</em> <em>CondPattern</em></a></td><td></td><td>svdh</td><td>E</td></tr><tr><td class="descr" colspan="4">Defines a condition under which rewriting will take place </td></tr> -<tr><td><a href="mod_rewrite.html#rewriteengine">RewriteEngine on|off</a></td><td> off </td><td>svdh</td><td>E</td></tr><tr><td class="descr" colspan="4">Enables or disables runtime rewriting engine</td></tr> -<tr class="odd"><td><a href="mod_rewrite.html#rewritelock">RewriteLock <em>file-path</em></a></td><td></td><td>s</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Sets the name of the lock file used for <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> +<tr class="odd"><td><a href="mod_rewrite.html#rewriteengine">RewriteEngine on|off</a></td><td> off </td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Enables or disables runtime rewriting engine</td></tr> +<tr><td><a href="mod_rewrite.html#rewritelock">RewriteLock <em>file-path</em></a></td><td></td><td>s</td><td>E</td></tr><tr><td class="descr" colspan="4">Sets the name of the lock file used for <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> synchronization</td></tr> -<tr><td><a href="mod_rewrite.html#rewritelog">RewriteLog <em>file-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Sets the name of the file used for logging rewrite engine +<tr class="odd"><td><a href="mod_rewrite.html#rewritelog">RewriteLog <em>file-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Sets the name of the file used for logging rewrite engine processing</td></tr> -<tr class="odd"><td><a href="mod_rewrite.html#rewriteloglevel">RewriteLogLevel <em>Level</em></a></td><td> 0 </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Sets the verbosity of the log file used by the rewrite +<tr><td><a href="mod_rewrite.html#rewriteloglevel">RewriteLogLevel <em>Level</em></a></td><td> 0 </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Sets the verbosity of the log file used by the rewrite engine</td></tr> -<tr><td><a href="mod_rewrite.html#rewritemap">RewriteMap <em>MapName</em> <em>MapType</em>:<em>MapSource</em> -</a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Defines a mapping function for key-lookup</td></tr> -<tr class="odd"><td><a href="mod_rewrite.html#rewriteoptions">RewriteOptions <var>Options</var></a></td><td> MaxRedirects=10 </td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Sets some special options for the rewrite engine</td></tr> -<tr><td><a href="mod_rewrite.html#rewriterule">RewriteRule - <em>Pattern</em> <em>Substitution</em></a></td><td></td><td>svdh</td><td>E</td></tr><tr><td class="descr" colspan="4">Defines rules for the rewriting engine</td></tr> -<tr class="odd"><td><a href="core.html#rlimitcpu">RLimitCPU <var>seconds</var>|max [<var>seconds</var>|max]</a></td><td></td><td>svdh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Limits the CPU consumption of processes launched +<tr class="odd"><td><a href="mod_rewrite.html#rewritemap">RewriteMap <em>MapName</em> <em>MapType</em>:<em>MapSource</em> +</a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Defines a mapping function for key-lookup</td></tr> +<tr><td><a href="mod_rewrite.html#rewriteoptions">RewriteOptions <var>Options</var></a></td><td> MaxRedirects=10 </td><td>svdh</td><td>E</td></tr><tr><td class="descr" colspan="4">Sets some special options for the rewrite engine</td></tr> +<tr class="odd"><td><a href="mod_rewrite.html#rewriterule">RewriteRule + <em>Pattern</em> <em>Substitution</em></a></td><td></td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Defines rules for the rewriting engine</td></tr> +<tr><td><a href="core.html#rlimitcpu">RLimitCPU <var>seconds</var>|max [<var>seconds</var>|max]</a></td><td></td><td>svdh</td><td>C</td></tr><tr><td class="descr" colspan="4">Limits the CPU consumption of processes launched by Apache children</td></tr> -<tr><td><a href="core.html#rlimitmem">RLimitMEM <var>bytes</var>|max [<var>bytes</var>|max]</a></td><td></td><td>svdh</td><td>C</td></tr><tr><td class="descr" colspan="4">Limits the memory consumption of processes launched +<tr class="odd"><td><a href="core.html#rlimitmem">RLimitMEM <var>bytes</var>|max [<var>bytes</var>|max]</a></td><td></td><td>svdh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Limits the memory consumption of processes launched by Apache children</td></tr> -<tr class="odd"><td><a href="core.html#rlimitnproc">RLimitNPROC <var>number</var>|max [<var>number</var>|max]</a></td><td></td><td>svdh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Limits the number of processes that can be launched by +<tr><td><a href="core.html#rlimitnproc">RLimitNPROC <var>number</var>|max [<var>number</var>|max]</a></td><td></td><td>svdh</td><td>C</td></tr><tr><td class="descr" colspan="4">Limits the number of processes that can be launched by processes launched by Apache children</td></tr> -<tr><td><a href="core.html#satisfy" id="S" name="S">Satisfy Any|All</a></td><td> All </td><td>dh</td><td>C</td></tr><tr><td class="descr" colspan="4">Interaction between host-level access control and +<tr class="odd"><td><a href="core.html#satisfy" id="S" name="S">Satisfy Any|All</a></td><td> All </td><td>dh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Interaction between host-level access control and user authentication</td></tr> -<tr class="odd"><td><a href="mpm_common.html#scoreboardfile">ScoreBoardFile <var>file-path</var></a></td><td> logs/apache_status </td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Location of the file used to store coordination data for +<tr><td><a href="mpm_common.html#scoreboardfile">ScoreBoardFile <var>file-path</var></a></td><td> logs/apache_status </td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Location of the file used to store coordination data for the child processes</td></tr> -<tr><td><a href="mod_actions.html#script">Script <var>method</var> <var>cgi-script</var></a></td><td></td><td>svd</td><td>B</td></tr><tr><td class="descr" colspan="4">특정 요청메서드에 대해 CGI 스크립트를 +<tr class="odd"><td><a href="mod_actions.html#script">Script <var>method</var> <var>cgi-script</var></a></td><td></td><td>svd</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">특정 요청메서드에 대해 CGI 스크립트를 사용한다.</td></tr> -<tr class="odd"><td><a href="mod_alias.html#scriptalias">ScriptAlias <var>URL-path</var> -<var>file-path</var>|<var>directory-path</var></a></td><td></td><td>sv</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">URL을 특정 파일시스템 장소로 대응하고 대상이 CGI +<tr><td><a href="mod_alias.html#scriptalias">ScriptAlias <var>URL-path</var> +<var>file-path</var>|<var>directory-path</var></a></td><td></td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">URL을 특정 파일시스템 장소로 대응하고 대상이 CGI 스크립트라고 알린다</td></tr> -<tr><td><a href="mod_alias.html#scriptaliasmatch">ScriptAliasMatch <var>regex</var> -<var>file-path</var>|<var>directory-path</var></a></td><td></td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">정규표현식을 사용하여 URL을 특정 파일시스템 장소로 +<tr class="odd"><td><a href="mod_alias.html#scriptaliasmatch">ScriptAliasMatch <var>regex</var> +<var>file-path</var>|<var>directory-path</var></a></td><td></td><td>sv</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">정규표현식을 사용하여 URL을 특정 파일시스템 장소로 대응하고 대상이 CGI 스크립트라고 알린다</td></tr> -<tr class="odd"><td><a href="core.html#scriptinterpretersource">ScriptInterpreterSource Registry|Registry-Strict|Script</a></td><td> Script </td><td>svdh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Technique for locating the interpreter for CGI +<tr><td><a href="core.html#scriptinterpretersource">ScriptInterpreterSource Registry|Registry-Strict|Script</a></td><td> Script </td><td>svdh</td><td>C</td></tr><tr><td class="descr" colspan="4">Technique for locating the interpreter for CGI scripts</td></tr> -<tr><td><a href="mod_cgi.html#scriptlog">ScriptLog <var>file-path</var></a></td><td></td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">CGI 스크립트 오류로그파일의 위치</td></tr> -<tr class="odd"><td><a href="mod_cgi.html#scriptlogbuffer">ScriptLogBuffer <var>bytes</var></a></td><td> 1024 </td><td>sv</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">스크립트 로그에 기록할 PUT 혹은 POST 요청의 최대량</td></tr> -<tr><td><a href="mod_cgi.html#scriptloglength">ScriptLogLength <var>bytes</var></a></td><td> 10385760 </td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">CGI 스크립트 로그파일의 크기 제한</td></tr> -<tr class="odd"><td><a href="mod_cgid.html#scriptsock">ScriptSock <var>file-path</var></a></td><td> logs/cgisock </td><td>sv</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">cgi 데몬과 통신을 위해 사용할 소켓의 이름</td></tr> -<tr><td><a href="mod_nw_ssl.html#securelisten">SecureListen [<var>IP-address</var>:]<var>portnumber</var> -<var>Certificate-Name</var> [MUTUAL]</a></td><td></td><td>s</td><td>B</td></tr><tr><td class="descr" colspan="4">Enables SSL encryption for the specified port</td></tr> -<tr class="odd"><td><a href="mpm_common.html#sendbuffersize">SendBufferSize <var>bytes</var></a></td><td> 0 </td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">TCP buffer size</td></tr> -<tr><td><a href="core.html#serveradmin">ServerAdmin <var>email-address</var>|<var>URL</var></a></td><td></td><td>sv</td><td>C</td></tr><tr><td class="descr" colspan="4">Email address that the server includes in error +<tr class="odd"><td><a href="mod_cgi.html#scriptlog">ScriptLog <var>file-path</var></a></td><td></td><td>sv</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">CGI 스크립트 오류로그파일의 위치</td></tr> +<tr><td><a href="mod_cgi.html#scriptlogbuffer">ScriptLogBuffer <var>bytes</var></a></td><td> 1024 </td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">스크립트 로그에 기록할 PUT 혹은 POST 요청의 최대량</td></tr> +<tr class="odd"><td><a href="mod_cgi.html#scriptloglength">ScriptLogLength <var>bytes</var></a></td><td> 10385760 </td><td>sv</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">CGI 스크립트 로그파일의 크기 제한</td></tr> +<tr><td><a href="mod_cgid.html#scriptsock">ScriptSock <var>file-path</var></a></td><td> logs/cgisock </td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">cgi 데몬과 통신을 위해 사용할 소켓의 이름</td></tr> +<tr class="odd"><td><a href="mod_nw_ssl.html#securelisten">SecureListen [<var>IP-address</var>:]<var>portnumber</var> +<var>Certificate-Name</var> [MUTUAL]</a></td><td></td><td>s</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Enables SSL encryption for the specified port</td></tr> +<tr><td><a href="mpm_common.html#sendbuffersize">SendBufferSize <var>bytes</var></a></td><td> 0 </td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">TCP buffer size</td></tr> +<tr class="odd"><td><a href="core.html#serveradmin">ServerAdmin <var>email-address</var>|<var>URL</var></a></td><td></td><td>sv</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Email address that the server includes in error messages sent to the client</td></tr> -<tr class="odd"><td><a href="core.html#serveralias">ServerAlias <var>hostname</var> [<var>hostname</var>] ...</a></td><td></td><td>v</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Alternate names for a host used when matching requests +<tr><td><a href="core.html#serveralias">ServerAlias <var>hostname</var> [<var>hostname</var>] ...</a></td><td></td><td>v</td><td>C</td></tr><tr><td class="descr" colspan="4">Alternate names for a host used when matching requests to name-virtual hosts</td></tr> -<tr><td><a href="mpm_common.html#serverlimit">ServerLimit <var>number</var></a></td><td></td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Upper limit on configurable number of processes</td></tr> -<tr class="odd"><td><a href="core.html#servername">ServerName <var>fully-qualified-domain-name</var>[:<var>port</var>]</a></td><td></td><td>sv</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Hostname and port that the server uses to identify +<tr class="odd"><td><a href="mpm_common.html#serverlimit">ServerLimit <var>number</var></a></td><td></td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Upper limit on configurable number of processes</td></tr> +<tr><td><a href="core.html#servername">ServerName <var>fully-qualified-domain-name</var>[:<var>port</var>]</a></td><td></td><td>sv</td><td>C</td></tr><tr><td class="descr" colspan="4">Hostname and port that the server uses to identify itself</td></tr> -<tr><td><a href="core.html#serverpath">ServerPath <var>URL-path</var></a></td><td></td><td>v</td><td>C</td></tr><tr><td class="descr" colspan="4">Legacy URL pathname for a name-based virtual host that +<tr class="odd"><td><a href="core.html#serverpath">ServerPath <var>URL-path</var></a></td><td></td><td>v</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Legacy URL pathname for a name-based virtual host that is accessed by an incompatible browser</td></tr> -<tr class="odd"><td><a href="core.html#serverroot">ServerRoot <var>directory-path</var></a></td><td> /usr/local/apache </td><td>s</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Base directory for the server installation</td></tr> -<tr><td><a href="core.html#serversignature">ServerSignature On|Off|EMail</a></td><td> Off </td><td>svdh</td><td>C</td></tr><tr><td class="descr" colspan="4">Configures the footer on server-generated documents</td></tr> -<tr class="odd"><td><a href="core.html#servertokens">ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full</a></td><td> Full </td><td>s</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Configures the <code>Server</code> HTTP response +<tr><td><a href="core.html#serverroot">ServerRoot <var>directory-path</var></a></td><td> /usr/local/apache </td><td>s</td><td>C</td></tr><tr><td class="descr" colspan="4">Base directory for the server installation</td></tr> +<tr class="odd"><td><a href="core.html#serversignature">ServerSignature On|Off|EMail</a></td><td> Off </td><td>svdh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Configures the footer on server-generated documents</td></tr> +<tr><td><a href="core.html#servertokens">ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full</a></td><td> Full </td><td>s</td><td>C</td></tr><tr><td class="descr" colspan="4">Configures the <code>Server</code> HTTP response header</td></tr> -<tr><td><a href="mod_env.html#setenv">SetEnv <var>env-variable</var> <var>value</var></a></td><td></td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">환경변수를 설정한다</td></tr> -<tr class="odd"><td><a href="mod_setenvif.html#setenvif">SetEnvIf <em>attribute +<tr class="odd"><td><a href="mod_env.html#setenv">SetEnv <var>env-variable</var> <var>value</var></a></td><td></td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">환경변수를 설정한다</td></tr> +<tr><td><a href="mod_setenvif.html#setenvif">SetEnvIf <em>attribute regex [!]env-variable</em>[=<em>value</em>] - [[!]<em>env-variable</em>[=<em>value</em>]] ...</a></td><td></td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">요청의 성질에 따라 환경변수를 설정한다</td></tr> -<tr><td><a href="mod_setenvif.html#setenvifnocase">SetEnvIfNoCase <em>attribute regex + [[!]<em>env-variable</em>[=<em>value</em>]] ...</a></td><td></td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">요청의 성질에 따라 환경변수를 설정한다</td></tr> +<tr class="odd"><td><a href="mod_setenvif.html#setenvifnocase">SetEnvIfNoCase <em>attribute regex [!]env-variable</em>[=<em>value</em>] - [[!]<em>env-variable</em>[=<em>value</em>]] ...</a></td><td></td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">대소문자를 구별하지않고 요청의 성질에 따라 환경변수를 + [[!]<em>env-variable</em>[=<em>value</em>]] ...</a></td><td></td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">대소문자를 구별하지않고 요청의 성질에 따라 환경변수를 설정한다</td></tr> -<tr class="odd"><td><a href="core.html#sethandler">SetHandler <var>handler-name</var>|None</a></td><td></td><td>svdh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Forces all matching files to be processed by a +<tr><td><a href="core.html#sethandler">SetHandler <var>handler-name</var>|None</a></td><td></td><td>svdh</td><td>C</td></tr><tr><td class="descr" colspan="4">Forces all matching files to be processed by a handler</td></tr> -<tr><td><a href="core.html#setinputfilter">SetInputFilter <var>filter</var>[;<var>filter</var>...]</a></td><td></td><td>svdh</td><td>C</td></tr><tr><td class="descr" colspan="4">Sets the filters that will process client requests and POST +<tr class="odd"><td><a href="core.html#setinputfilter">SetInputFilter <var>filter</var>[;<var>filter</var>...]</a></td><td></td><td>svdh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Sets the filters that will process client requests and POST input</td></tr> -<tr class="odd"><td><a href="core.html#setoutputfilter">SetOutputFilter <var>filter</var>[;<var>filter</var>...]</a></td><td></td><td>svdh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Sets the filters that will process responses from the +<tr><td><a href="core.html#setoutputfilter">SetOutputFilter <var>filter</var>[;<var>filter</var>...]</a></td><td></td><td>svdh</td><td>C</td></tr><tr><td class="descr" colspan="4">Sets the filters that will process responses from the server</td></tr> -<tr><td><a href="mod_include.html#ssiendtag">SSIEndTag <var>tag</var></a></td><td> "-->" </td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">String that ends an include element</td></tr> -<tr class="odd"><td><a href="mod_include.html#ssierrormsg">SSIErrorMsg <var>message</var></a></td><td> "[an error occurred +</td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Error message displayed when there is an SSI +<tr class="odd"><td><a href="mod_include.html#ssiendtag">SSIEndTag <var>tag</var></a></td><td> "-->" </td><td>sv</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">String that ends an include element</td></tr> +<tr><td><a href="mod_include.html#ssierrormsg">SSIErrorMsg <var>message</var></a></td><td> "[an error occurred +</td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">Error message displayed when there is an SSI error</td></tr> -<tr><td><a href="mod_include.html#ssistarttag">SSIStartTag <var>tag</var></a></td><td> "<!--#" </td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">String that starts an include element</td></tr> -<tr class="odd"><td><a href="mod_include.html#ssitimeformat">SSITimeFormat <var>formatstring</var></a></td><td> "%A, %d-%b-%Y %H:%M +</td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Configures the format in which date strings are +<tr class="odd"><td><a href="mod_include.html#ssistarttag">SSIStartTag <var>tag</var></a></td><td> "<!--#" </td><td>sv</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">String that starts an include element</td></tr> +<tr><td><a href="mod_include.html#ssitimeformat">SSITimeFormat <var>formatstring</var></a></td><td> "%A, %d-%b-%Y %H:%M +</td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">Configures the format in which date strings are displayed</td></tr> -<tr><td><a href="mod_include.html#ssiundefinedecho">SSIUndefinedEcho <var>string</var></a></td><td> "(none)" </td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">String displayed when an unset variable is echoed</td></tr> -<tr class="odd"><td><a href="mod_ssl.html#sslcacertificatefile">SSLCACertificateFile <em>file-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">File of concatenated PEM-encoded CA Certificates +<tr class="odd"><td><a href="mod_include.html#ssiundefinedecho">SSIUndefinedEcho <var>string</var></a></td><td> "(none)" </td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">String displayed when an unset variable is echoed</td></tr> +<tr><td><a href="mod_ssl.html#sslcacertificatefile">SSLCACertificateFile <em>file-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">File of concatenated PEM-encoded CA Certificates for Client Auth</td></tr> -<tr><td><a href="mod_ssl.html#sslcacertificatepath">SSLCACertificatePath <em>directory-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Directory of PEM-encoded CA Certificates for +<tr class="odd"><td><a href="mod_ssl.html#sslcacertificatepath">SSLCACertificatePath <em>directory-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Directory of PEM-encoded CA Certificates for Client Auth</td></tr> -<tr class="odd"><td><a href="mod_ssl.html#sslcarevocationfile">SSLCARevocationFile <em>file-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">File of concatenated PEM-encoded CA CRLs for +<tr><td><a href="mod_ssl.html#sslcarevocationfile">SSLCARevocationFile <em>file-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">File of concatenated PEM-encoded CA CRLs for Client Auth</td></tr> -<tr><td><a href="mod_ssl.html#sslcarevocationpath">SSLCARevocationPath <em>directory-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Directory of PEM-encoded CA CRLs for +<tr class="odd"><td><a href="mod_ssl.html#sslcarevocationpath">SSLCARevocationPath <em>directory-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Directory of PEM-encoded CA CRLs for Client Auth</td></tr> -<tr class="odd"><td><a href="mod_ssl.html#sslcertificatechainfile">SSLCertificateChainFile <em>file-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">File of PEM-encoded Server CA Certificates</td></tr> -<tr><td><a href="mod_ssl.html#sslcertificatefile">SSLCertificateFile <em>file-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Server PEM-encoded X.509 Certificate file</td></tr> -<tr class="odd"><td><a href="mod_ssl.html#sslcertificatekeyfile">SSLCertificateKeyFile <em>file-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Server PEM-encoded Private Key file</td></tr> -<tr><td><a href="mod_ssl.html#sslciphersuite">SSLCipherSuite <em>cipher-spec</em></a></td><td> ALL:!ADH:RC4+RSA:+H +</td><td>svdh</td><td>E</td></tr><tr><td class="descr" colspan="4">Cipher Suite available for negotiation in SSL +<tr><td><a href="mod_ssl.html#sslcertificatechainfile">SSLCertificateChainFile <em>file-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">File of PEM-encoded Server CA Certificates</td></tr> +<tr class="odd"><td><a href="mod_ssl.html#sslcertificatefile">SSLCertificateFile <em>file-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Server PEM-encoded X.509 Certificate file</td></tr> +<tr><td><a href="mod_ssl.html#sslcertificatekeyfile">SSLCertificateKeyFile <em>file-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Server PEM-encoded Private Key file</td></tr> +<tr class="odd"><td><a href="mod_ssl.html#sslciphersuite">SSLCipherSuite <em>cipher-spec</em></a></td><td> ALL:!ADH:RC4+RSA:+H +</td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Cipher Suite available for negotiation in SSL handshake</td></tr> -<tr class="odd"><td><a href="mod_ssl.html#sslcryptodevice">SSLCryptoDevice <em>engine</em></a></td><td> builtin </td><td>s</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Enable use of a cryptographic hardware accelerator</td></tr> -<tr><td><a href="mod_ssl.html#sslengine">SSLEngine on|off</a></td><td> off </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">SSL Engine Operation Switch</td></tr> -<tr class="odd"><td><a href="mod_ssl.html#sslhonorcipherorder">SSLHonorCiperOrder <em>flag</em></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Option to prefer the server's cipher preference order</td></tr> -<tr><td><a href="mod_ssl.html#sslmutex">SSLMutex <em>type</em></a></td><td> none </td><td>s</td><td>E</td></tr><tr><td class="descr" colspan="4">Semaphore for internal mutual exclusion of +<tr><td><a href="mod_ssl.html#sslcryptodevice">SSLCryptoDevice <em>engine</em></a></td><td> builtin </td><td>s</td><td>E</td></tr><tr><td class="descr" colspan="4">Enable use of a cryptographic hardware accelerator</td></tr> +<tr class="odd"><td><a href="mod_ssl.html#sslengine">SSLEngine on|off</a></td><td> off </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">SSL Engine Operation Switch</td></tr> +<tr><td><a href="mod_ssl.html#sslhonorcipherorder">SSLHonorCiperOrder <em>flag</em></a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Option to prefer the server's cipher preference order</td></tr> +<tr class="odd"><td><a href="mod_ssl.html#sslmutex">SSLMutex <em>type</em></a></td><td> none </td><td>s</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Semaphore for internal mutual exclusion of operations</td></tr> -<tr class="odd"><td><a href="mod_ssl.html#ssloptions">SSLOptions [+|-]<em>option</em> ...</a></td><td></td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Configure various SSL engine run-time options</td></tr> -<tr><td><a href="mod_ssl.html#sslpassphrasedialog">SSLPassPhraseDialog <em>type</em></a></td><td> builtin </td><td>s</td><td>E</td></tr><tr><td class="descr" colspan="4">Type of pass phrase dialog for encrypted private +<tr><td><a href="mod_ssl.html#ssloptions">SSLOptions [+|-]<em>option</em> ...</a></td><td></td><td>svdh</td><td>E</td></tr><tr><td class="descr" colspan="4">Configure various SSL engine run-time options</td></tr> +<tr class="odd"><td><a href="mod_ssl.html#sslpassphrasedialog">SSLPassPhraseDialog <em>type</em></a></td><td> builtin </td><td>s</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Type of pass phrase dialog for encrypted private keys</td></tr> -<tr class="odd"><td><a href="mod_ssl.html#sslprotocol">SSLProtocol [+|-]<em>protocol</em> ...</a></td><td> all </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Configure usable SSL protocol flavors</td></tr> -<tr><td><a href="mod_ssl.html#sslproxycacertificatefile">SSLProxyCACertificateFile <em>file-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">File of concatenated PEM-encoded CA Certificates +<tr><td><a href="mod_ssl.html#sslprotocol">SSLProtocol [+|-]<em>protocol</em> ...</a></td><td> all </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Configure usable SSL protocol flavors</td></tr> +<tr class="odd"><td><a href="mod_ssl.html#sslproxycacertificatefile">SSLProxyCACertificateFile <em>file-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">File of concatenated PEM-encoded CA Certificates for Remote Server Auth</td></tr> -<tr class="odd"><td><a href="mod_ssl.html#sslproxycacertificatepath">SSLProxyCACertificatePath <em>directory-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Directory of PEM-encoded CA Certificates for +<tr><td><a href="mod_ssl.html#sslproxycacertificatepath">SSLProxyCACertificatePath <em>directory-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Directory of PEM-encoded CA Certificates for Remote Server Auth</td></tr> -<tr><td><a href="mod_ssl.html#sslproxycarevocationfile">SSLProxyCARevocationFile <em>file-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">File of concatenated PEM-encoded CA CRLs for +<tr class="odd"><td><a href="mod_ssl.html#sslproxycarevocationfile">SSLProxyCARevocationFile <em>file-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">File of concatenated PEM-encoded CA CRLs for Remote Server Auth</td></tr> -<tr class="odd"><td><a href="mod_ssl.html#sslproxycarevocationpath">SSLProxyCARevocationPath <em>directory-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Directory of PEM-encoded CA CRLs for +<tr><td><a href="mod_ssl.html#sslproxycarevocationpath">SSLProxyCARevocationPath <em>directory-path</em></a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Directory of PEM-encoded CA CRLs for Remote Server Auth</td></tr> -<tr><td><a href="mod_ssl.html#sslproxyciphersuite">SSLProxyCipherSuite <em>cipher-spec</em></a></td><td> ALL:!ADH:RC4+RSA:+H +</td><td>svdh</td><td>E</td></tr><tr><td class="descr" colspan="4">Cipher Suite available for negotiation in SSL +<tr class="odd"><td><a href="mod_ssl.html#sslproxyciphersuite">SSLProxyCipherSuite <em>cipher-spec</em></a></td><td> ALL:!ADH:RC4+RSA:+H +</td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Cipher Suite available for negotiation in SSL proxy handshake</td></tr> -<tr class="odd"><td><a href="mod_ssl.html#sslproxyengine">SSLProxyEngine on|off</a></td><td> off </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">SSL Proxy Engine Operation Switch</td></tr> -<tr><td><a href="mod_ssl.html#sslproxymachinecertificatefile">SSLProxyMachineCertificateFile <em>filename</em></a></td><td></td><td>s</td><td>E</td></tr><tr><td class="descr" colspan="4">File of concatenated PEM-encoded client certificates and keys to be used by the proxy</td></tr> -<tr class="odd"><td><a href="mod_ssl.html#sslproxymachinecertificatepath">SSLProxyMachineCertificatePath <em>directory</em></a></td><td></td><td>s</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Directory of PEM-encoded client certificates and keys to be used by the proxy</td></tr> -<tr><td><a href="mod_ssl.html#sslproxyprotocol">SSLProxyProtocol [+|-]<em>protocol</em> ...</a></td><td> all </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Configure usable SSL protocol flavors for proxy usage</td></tr> -<tr class="odd"><td><a href="mod_ssl.html#sslproxyverify">SSLProxyVerify <em>level</em></a></td><td> none </td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Type of remote server Certificate verification</td></tr> -<tr><td><a href="mod_ssl.html#sslproxyverifydepth">SSLProxyVerifyDepth <em>number</em></a></td><td> 1 </td><td>svdh</td><td>E</td></tr><tr><td class="descr" colspan="4">Maximum depth of CA Certificates in Remote Server +<tr><td><a href="mod_ssl.html#sslproxyengine">SSLProxyEngine on|off</a></td><td> off </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">SSL Proxy Engine Operation Switch</td></tr> +<tr class="odd"><td><a href="mod_ssl.html#sslproxymachinecertificatefile">SSLProxyMachineCertificateFile <em>filename</em></a></td><td></td><td>s</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">File of concatenated PEM-encoded client certificates and keys to be used by the proxy</td></tr> +<tr><td><a href="mod_ssl.html#sslproxymachinecertificatepath">SSLProxyMachineCertificatePath <em>directory</em></a></td><td></td><td>s</td><td>E</td></tr><tr><td class="descr" colspan="4">Directory of PEM-encoded client certificates and keys to be used by the proxy</td></tr> +<tr class="odd"><td><a href="mod_ssl.html#sslproxyprotocol">SSLProxyProtocol [+|-]<em>protocol</em> ...</a></td><td> all </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Configure usable SSL protocol flavors for proxy usage</td></tr> +<tr><td><a href="mod_ssl.html#sslproxyverify">SSLProxyVerify <em>level</em></a></td><td> none </td><td>svdh</td><td>E</td></tr><tr><td class="descr" colspan="4">Type of remote server Certificate verification</td></tr> +<tr class="odd"><td><a href="mod_ssl.html#sslproxyverifydepth">SSLProxyVerifyDepth <em>number</em></a></td><td> 1 </td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Maximum depth of CA Certificates in Remote Server Certificate verification</td></tr> -<tr class="odd"><td><a href="mod_ssl.html#sslrandomseed">SSLRandomSeed <em>context</em> <em>source</em> -[<em>bytes</em>]</a></td><td></td><td>s</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Pseudo Random Number Generator (PRNG) seeding +<tr><td><a href="mod_ssl.html#sslrandomseed">SSLRandomSeed <em>context</em> <em>source</em> +[<em>bytes</em>]</a></td><td></td><td>s</td><td>E</td></tr><tr><td class="descr" colspan="4">Pseudo Random Number Generator (PRNG) seeding source</td></tr> -<tr><td><a href="mod_ssl.html#sslrequire">SSLRequire <em>expression</em></a></td><td></td><td>dh</td><td>E</td></tr><tr><td class="descr" colspan="4">Allow access only when an arbitrarily complex +<tr class="odd"><td><a href="mod_ssl.html#sslrequire">SSLRequire <em>expression</em></a></td><td></td><td>dh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Allow access only when an arbitrarily complex boolean expression is true</td></tr> -<tr class="odd"><td><a href="mod_ssl.html#sslrequiressl">SSLRequireSSL</a></td><td></td><td>dh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Deny access when SSL is not used for the +<tr><td><a href="mod_ssl.html#sslrequiressl">SSLRequireSSL</a></td><td></td><td>dh</td><td>E</td></tr><tr><td class="descr" colspan="4">Deny access when SSL is not used for the HTTP request</td></tr> -<tr><td><a href="mod_ssl.html#sslsessioncache">SSLSessionCache <em>type</em></a></td><td> none </td><td>s</td><td>E</td></tr><tr><td class="descr" colspan="4">Type of the global/inter-process SSL Session +<tr class="odd"><td><a href="mod_ssl.html#sslsessioncache">SSLSessionCache <em>type</em></a></td><td> none </td><td>s</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Type of the global/inter-process SSL Session Cache</td></tr> -<tr class="odd"><td><a href="mod_ssl.html#sslsessioncachetimeout">SSLSessionCacheTimeout <em>seconds</em></a></td><td> 300 </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Number of seconds before an SSL session expires +<tr><td><a href="mod_ssl.html#sslsessioncachetimeout">SSLSessionCacheTimeout <em>seconds</em></a></td><td> 300 </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Number of seconds before an SSL session expires in the Session Cache</td></tr> -<tr><td><a href="mod_ssl.html#sslusername">SSLUserName <em>varname</em></a></td><td></td><td>sdh</td><td>E</td></tr><tr><td class="descr" colspan="4">Variable name to determine user name</td></tr> -<tr class="odd"><td><a href="mod_ssl.html#sslverifyclient">SSLVerifyClient <em>level</em></a></td><td> none </td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Type of Client Certificate verification</td></tr> -<tr><td><a href="mod_ssl.html#sslverifydepth">SSLVerifyDepth <em>number</em></a></td><td> 1 </td><td>svdh</td><td>E</td></tr><tr><td class="descr" colspan="4">Maximum depth of CA Certificates in Client +<tr class="odd"><td><a href="mod_ssl.html#sslusername">SSLUserName <em>varname</em></a></td><td></td><td>sdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Variable name to determine user name</td></tr> +<tr><td><a href="mod_ssl.html#sslverifyclient">SSLVerifyClient <em>level</em></a></td><td> none </td><td>svdh</td><td>E</td></tr><tr><td class="descr" colspan="4">Type of Client Certificate verification</td></tr> +<tr class="odd"><td><a href="mod_ssl.html#sslverifydepth">SSLVerifyDepth <em>number</em></a></td><td> 1 </td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Maximum depth of CA Certificates in Client Certificate verification</td></tr> -<tr class="odd"><td><a href="mpm_common.html#startservers">StartServers <var>number</var></a></td><td></td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Number of child server processes created at startup</td></tr> -<tr><td><a href="mpm_common.html#startthreads">StartThreads <var>number</var></a></td><td></td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Number of threads created on startup</td></tr> -<tr class="odd"><td><a href="mod_suexec.html#suexecusergroup">SuexecUserGroup <em>User Group</em></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">CGI 프로그램이 사용할 사용자와 그룹 권한</td></tr> -<tr><td><a href="mpm_common.html#threadlimit" id="T" name="T">ThreadLimit <var>number</var></a></td><td></td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Sets the upper limit on the configurable number of threads +<tr><td><a href="mpm_common.html#startservers">StartServers <var>number</var></a></td><td></td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Number of child server processes created at startup</td></tr> +<tr class="odd"><td><a href="mpm_common.html#startthreads">StartThreads <var>number</var></a></td><td></td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Number of threads created on startup</td></tr> +<tr><td><a href="mod_suexec.html#suexecusergroup">SuexecUserGroup <em>User Group</em></a></td><td></td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">CGI 프로그램이 사용할 사용자와 그룹 권한</td></tr> +<tr class="odd"><td><a href="mpm_common.html#threadlimit" id="T" name="T">ThreadLimit <var>number</var></a></td><td></td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Sets the upper limit on the configurable number of threads per child process</td></tr> -<tr class="odd"><td><a href="mpm_common.html#threadsperchild">ThreadsPerChild <var>number</var></a></td><td></td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Number of threads created by each child process</td></tr> -<tr><td><a href="mpm_common.html#threadstacksize">ThreadStackSize <var>size</var></a></td><td></td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">The size in bytes of the stack used by threads handling +<tr><td><a href="mpm_common.html#threadsperchild">ThreadsPerChild <var>number</var></a></td><td></td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Number of threads created by each child process</td></tr> +<tr class="odd"><td><a href="mpm_common.html#threadstacksize">ThreadStackSize <var>size</var></a></td><td></td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">The size in bytes of the stack used by threads handling client connections</td></tr> -<tr class="odd"><td><a href="core.html#timeout">TimeOut <var>seconds</var></a></td><td> 300 </td><td>s</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Amount of time the server will wait for +<tr><td><a href="core.html#timeout">TimeOut <var>seconds</var></a></td><td> 300 </td><td>s</td><td>C</td></tr><tr><td class="descr" colspan="4">Amount of time the server will wait for certain events before failing a request</td></tr> -<tr><td><a href="mod_log_config.html#transferlog">TransferLog <var>file</var>|<var>pipe</var></a></td><td></td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">Specify location of a log file</td></tr> -<tr class="odd"><td><a href="mod_mime.html#typesconfig">TypesConfig <var>file-path</var></a></td><td> conf/mime.types </td><td>s</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">The location of the <code>mime.types</code> file</td></tr> -<tr><td><a href="mod_env.html#unsetenv" id="U" name="U">UnsetEnv <var>env-variable</var> [<var>env-variable</var>] -...</a></td><td></td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">환경변수를 제거한다</td></tr> -<tr class="odd"><td><a href="core.html#usecanonicalname">UseCanonicalName On|Off|DNS</a></td><td> On </td><td>svd</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Configures how the server determines its own name and +<tr class="odd"><td><a href="mod_log_config.html#transferlog">TransferLog <var>file</var>|<var>pipe</var></a></td><td></td><td>sv</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Specify location of a log file</td></tr> +<tr><td><a href="mod_mime.html#typesconfig">TypesConfig <var>file-path</var></a></td><td> conf/mime.types </td><td>s</td><td>B</td></tr><tr><td class="descr" colspan="4">The location of the <code>mime.types</code> file</td></tr> +<tr class="odd"><td><a href="mod_env.html#unsetenv" id="U" name="U">UnsetEnv <var>env-variable</var> [<var>env-variable</var>] +...</a></td><td></td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">환경변수를 제거한다</td></tr> +<tr><td><a href="core.html#usecanonicalname">UseCanonicalName On|Off|DNS</a></td><td> On </td><td>svd</td><td>C</td></tr><tr><td class="descr" colspan="4">Configures how the server determines its own name and port</td></tr> -<tr><td><a href="mpm_common.html#user">User <var>unix-userid</var></a></td><td> #-1 </td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">The userid under which the server will answer +<tr class="odd"><td><a href="mpm_common.html#user">User <var>unix-userid</var></a></td><td> #-1 </td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">The userid under which the server will answer requests</td></tr> -<tr class="odd"><td><a href="mod_userdir.html#userdir">UserDir <em>directory-filename</em></a></td><td> public_html </td><td>sv</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">사용자별 디렉토리 위치</td></tr> -<tr><td><a href="mod_vhost_alias.html#virtualdocumentroot" id="V" name="V">VirtualDocumentRoot <em>interpolated-directory</em>|none</a></td><td> none </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Dynamically configure the location of the document root +<tr><td><a href="mod_userdir.html#userdir">UserDir <em>directory-filename</em></a></td><td> public_html </td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">사용자별 디렉토리 위치</td></tr> +<tr class="odd"><td><a href="mod_vhost_alias.html#virtualdocumentroot" id="V" name="V">VirtualDocumentRoot <em>interpolated-directory</em>|none</a></td><td> none </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Dynamically configure the location of the document root for a given virtual host</td></tr> -<tr class="odd"><td><a href="mod_vhost_alias.html#virtualdocumentrootip">VirtualDocumentRootIP <em>interpolated-directory</em>|none</a></td><td> none </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Dynamically configure the location of the document root +<tr><td><a href="mod_vhost_alias.html#virtualdocumentrootip">VirtualDocumentRootIP <em>interpolated-directory</em>|none</a></td><td> none </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Dynamically configure the location of the document root for a given virtual host</td></tr> -<tr><td><a href="core.html#virtualhost"><VirtualHost +<tr class="odd"><td><a href="core.html#virtualhost"><VirtualHost <var>addr</var>[:<var>port</var>] [<var>addr</var>[:<var>port</var>]] - ...> ... </VirtualHost></a></td><td></td><td>s</td><td>C</td></tr><tr><td class="descr" colspan="4">Contains directives that apply only to a specific + ...> ... </VirtualHost></a></td><td></td><td>s</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Contains directives that apply only to a specific hostname or IP address</td></tr> -<tr class="odd"><td><a href="mod_vhost_alias.html#virtualscriptalias">VirtualScriptAlias <em>interpolated-directory</em>|none</a></td><td> none </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Dynamically configure the location of the CGI directory for +<tr><td><a href="mod_vhost_alias.html#virtualscriptalias">VirtualScriptAlias <em>interpolated-directory</em>|none</a></td><td> none </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Dynamically configure the location of the CGI directory for a given virtual host</td></tr> -<tr><td><a href="mod_vhost_alias.html#virtualscriptaliasip">VirtualScriptAliasIP <em>interpolated-directory</em>|none</a></td><td> none </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Dynamically configure the location of the cgi directory for +<tr class="odd"><td><a href="mod_vhost_alias.html#virtualscriptaliasip">VirtualScriptAliasIP <em>interpolated-directory</em>|none</a></td><td> none </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Dynamically configure the location of the cgi directory for a given virtual host</td></tr> -<tr class="odd"><td><a href="mpm_winnt.html#win32disableacceptex" id="W" name="W">Win32DisableAcceptEx</a></td><td></td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Use accept() rather than AcceptEx() to accept network connections</td></tr> -<tr><td><a href="mod_include.html#xbithack" id="X" name="X">XBitHack on|off|full</a></td><td> off </td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">Parse SSI directives in files with the execute bit +<tr><td><a href="mpm_winnt.html#win32disableacceptex" id="W" name="W">Win32DisableAcceptEx</a></td><td></td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Use accept() rather than AcceptEx() to accept network connections</td></tr> +<tr class="odd"><td><a href="mod_include.html#xbithack" id="X" name="X">XBitHack on|off|full</a></td><td> off </td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Parse SSI directives in files with the execute bit set</td></tr> </table></div> <div class="bottomlang"> diff --git a/docs/manual/programs/configure.html.ko.euc-kr b/docs/manual/programs/configure.html.ko.euc-kr index fc0e054d1a..f28d97eeae 100644 --- a/docs/manual/programs/configure.html.ko.euc-kr +++ b/docs/manual/programs/configure.html.ko.euc-kr @@ -21,8 +21,6 @@ <p><span>가능한 언어: </span><a href="../en/programs/configure.html" hreflang="en" rel="alternate" title="English"> en </a> | <a href="../ko/programs/configure.html" title="Korean"> ko </a></p> </div> -<div class="outofdate">이 문서는 최신판 번역이 아닙니다. - 최근에 변경된 내용은 영어 문서를 참고하세요.</div> <p><code>configure</code> 스크립트는 특정 플래폼에서 아파치 웹서버를 컴파일하고 설치하기위해 소스 트리를 구성한다. 여러 diff --git a/docs/manual/programs/configure.xml.ko b/docs/manual/programs/configure.xml.ko index 5634ebfcaa..80f4afe833 100644 --- a/docs/manual/programs/configure.xml.ko +++ b/docs/manual/programs/configure.xml.ko @@ -1,7 +1,7 @@ <?xml version='1.0' encoding='EUC-KR' ?> <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> -<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?> -<!-- English Revision: 1.11 (outdated: 1.12) --> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.12 --> <!-- Copyright 2004 The Apache Software Foundation diff --git a/docs/manual/programs/configure.xml.meta b/docs/manual/programs/configure.xml.meta index 7a520cd68d..61da38b508 100644 --- a/docs/manual/programs/configure.xml.meta +++ b/docs/manual/programs/configure.xml.meta @@ -7,6 +7,6 @@ <variants> <variant>en</variant> - <variant outdated="yes">ko</variant> + <variant>ko</variant> </variants> </metafile> diff --git a/docs/manual/programs/rotatelogs.html.ko.euc-kr b/docs/manual/programs/rotatelogs.html.ko.euc-kr index d2d09803b0..458a296fd4 100644 --- a/docs/manual/programs/rotatelogs.html.ko.euc-kr +++ b/docs/manual/programs/rotatelogs.html.ko.euc-kr @@ -23,8 +23,6 @@ <p><span>가능한 언어: </span><a href="../en/programs/rotatelogs.html" hreflang="en" rel="alternate" title="English"> en </a> | <a href="../ko/programs/rotatelogs.html" title="Korean"> ko </a></p> </div> -<div class="outofdate">이 문서는 최신판 번역이 아닙니다. - 최근에 변경된 내용은 영어 문서를 참고하세요.</div> <p><code>rotatelogs</code>는 아파치의 파이프 로그파일 기능을 위한 간단한 프로그램이다. 예를 들어:</p> @@ -45,6 +43,13 @@ <p>이 설정은 로그파일 크기가 5 메가바이트가 될때마다 순환한다.</p> +<div class="example"><p><code> + ErrorLog "|bin/rotatelogs /var/logs/errorlog.%Y-%m-%d-%H_%M_%S 5M" +</code></p></div> + <p>이 설정은 오류로그 파일 크기가 5 메가바이트가 될때마다 + <code>errorlog.YYYY-mm-dd-HH_MM_SS</code>와 같은 파일을 + 만들어서 오류로그 파일을 순환한다.</p> + </div> <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">개요</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#options">옵션</a></li> @@ -54,7 +59,9 @@ <div class="section"> <h2><a name="synopsis" id="synopsis">개요</a></h2> - <p><code><strong>rotatelogs</strong> <var>logfile</var> + <p><code><strong>rotatelogs</strong> + [ -<strong>l</strong> ] + <var>logfile</var> [ <var>rotationtime</var> [ <var>offset</var> ]] | [ <var>filesize</var>M ]</code></p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> @@ -63,6 +70,11 @@ <dl> +<dt><code>-l</code></dt> +<dd>순환주기로 GMT 대신 지역시간을 사용한다. (BST나 DST와 같이) +GMT 시간차가 변하는 환경에서 <code>-l</code>을 사용하면 예기치 +않은 결과가 발생할 수 있다!</dd> + <dt><code><var>logfile</var></code></dt> <dd>로그파일의 경로와 이름. <var>logfile</var>에 '%' 문자가 diff --git a/docs/manual/programs/rotatelogs.xml.ko b/docs/manual/programs/rotatelogs.xml.ko index 9f8b609512..e882c41e6a 100644 --- a/docs/manual/programs/rotatelogs.xml.ko +++ b/docs/manual/programs/rotatelogs.xml.ko @@ -1,7 +1,7 @@ <?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.7 (outdated: 1.10) --> +<!-- English Revision: 1.10 --> <!-- Copyright 2004 The Apache Software Foundation @@ -45,11 +45,20 @@ <p>이 설정은 로그파일 크기가 5 메가바이트가 될때마다 순환한다.</p> +<example> + ErrorLog "|bin/rotatelogs /var/logs/errorlog.%Y-%m-%d-%H_%M_%S 5M" +</example> + <p>이 설정은 오류로그 파일 크기가 5 메가바이트가 될때마다 + <code>errorlog.YYYY-mm-dd-HH_MM_SS</code>와 같은 파일을 + 만들어서 오류로그 파일을 순환한다.</p> + </summary> <section id="synopsis"><title>개요</title> - <p><code><strong>rotatelogs</strong> <var>logfile</var> + <p><code><strong>rotatelogs</strong> + [ -<strong>l</strong> ] + <var>logfile</var> [ <var>rotationtime</var> [ <var>offset</var> ]] | [ <var>filesize</var>M ]</code></p> </section> @@ -58,6 +67,11 @@ <dl> +<dt><code>-l</code></dt> +<dd>순환주기로 GMT 대신 지역시간을 사용한다. (BST나 DST와 같이) +GMT 시간차가 변하는 환경에서 <code>-l</code>을 사용하면 예기치 +않은 결과가 발생할 수 있다!</dd> + <dt><code><var>logfile</var></code></dt> <dd>로그파일의 경로와 이름. <var>logfile</var>에 '%' 문자가 diff --git a/docs/manual/programs/rotatelogs.xml.meta b/docs/manual/programs/rotatelogs.xml.meta index 0316ff9177..6426888332 100644 --- a/docs/manual/programs/rotatelogs.xml.meta +++ b/docs/manual/programs/rotatelogs.xml.meta @@ -7,6 +7,6 @@ <variants> <variant>en</variant> - <variant outdated="yes">ko</variant> + <variant>ko</variant> </variants> </metafile> diff --git a/docs/manual/sitemap.html.ko.euc-kr b/docs/manual/sitemap.html.ko.euc-kr index cd3919b3a3..f625e576bd 100644 --- a/docs/manual/sitemap.html.ko.euc-kr +++ b/docs/manual/sitemap.html.ko.euc-kr @@ -105,7 +105,7 @@ <div class="section"><h2><a name="howto" id="howto">지침서, 투토리얼, HowTo</a></h2> <ul><li class="separate"><a href="howto/">개요</a></li> <li><a href="howto/auth.html">인증</a></li> -<li><a href="howto/cgi.html">CGI로 동적 내용</a></li> +<li><a href="howto/cgi.html">CGI로 동적 페이지 생성</a></li> <li><a href="howto/ssi.html">Server Side Includes 소개</a></li> <li><a href="howto/htaccess.html">.htaccess 파일</a></li> <li><a href="howto/public_html.html">사용자별 웹디렉토리</a></li> diff --git a/docs/manual/sitemap.xml.ko b/docs/manual/sitemap.xml.ko index f414264d2a..c4402d654d 100644 --- a/docs/manual/sitemap.xml.ko +++ b/docs/manual/sitemap.xml.ko @@ -93,7 +93,7 @@ <title>지침서, 투토리얼, HowTo</title> <page separate="yes" href="howto/">개요</page> <page href="howto/auth.html">인증</page> -<page href="howto/cgi.html">CGI로 동적 내용</page> +<page href="howto/cgi.html">CGI로 동적 페이지 생성</page> <page href="howto/ssi.html">Server Side Includes 소개</page> <page href="howto/htaccess.html">.htaccess 파일</page> <page href="howto/public_html.html">사용자별 웹디렉토리</page> diff --git a/docs/manual/style/lang/ko.xml b/docs/manual/style/lang/ko.xml index dc2cda71c9..83a6587223 100644 --- a/docs/manual/style/lang/ko.xml +++ b/docs/manual/style/lang/ko.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="EUC-KR"?> <!DOCTYPE language [ <!ENTITY nbsp " "> ]> -<!-- English Revision: 1.16 --> +<!-- English Revision: 1.18 --> <!-- Copyright 2003-2004 The Apache Software Foundation @@ -31,13 +31,19 @@ <settings>Korean</settings> </chm> + <!-- + <man> + <charset>ISO-8859-1</charset> + </man> + --> + <!-- Some strings might be used in other contexts, than stated in the --> <!-- comments... --> <messages> <!-- language link titles --> <message id="nativename">Korean</message> - <!-- Used for the moduleindex --> + <!-- Used for the moduleindex --> <message id="corefeatures">핵심 기능과 다중처리 모듈</message> <message id="othermodules">다른 모듈</message> <message id="obsoletemodules">이전 모듈</message> diff --git a/docs/manual/style/manual.ko.xsl b/docs/manual/style/manual.ko.xsl index 0b2e8c80ef..5efd81dbe8 100644 --- a/docs/manual/style/manual.ko.xsl +++ b/docs/manual/style/manual.ko.xsl @@ -1,4 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- English Revision: 1.9 --> <!-- Copyright 2002-2004 The Apache Software Foundation @@ -33,4 +34,4 @@ <!-- Now get the real guts of the stylesheet --> <xsl:include href="xsl/common.xsl"/> -</xsl:stylesheet>
\ No newline at end of file +</xsl:stylesheet> diff --git a/docs/manual/suexec.html.ko.euc-kr b/docs/manual/suexec.html.ko.euc-kr index 58b4316470..e038158b61 100644 --- a/docs/manual/suexec.html.ko.euc-kr +++ b/docs/manual/suexec.html.ko.euc-kr @@ -22,8 +22,6 @@ <a href="./ja/suexec.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="./ko/suexec.html" title="Korean"> ko </a></p> </div> -<div class="outofdate">이 문서는 최신판 번역이 아닙니다. - 최근에 변경된 내용은 영어 문서를 참고하세요.</div> <p><strong>suEXEC</strong> 기능은 아파치가 <strong>CGI</strong>와 <strong>SSI</strong> 프로그램을 웹서버를 실행한 사용자 ID가 @@ -381,23 +379,6 @@ 기본값은 "/usr/local/bin:/usr/bin:/bin"이다.</dd> </dl> - <p><strong>suEXEC 구성을 점검하라</strong><br /> - suEXEC wrapper를 컴파일하고 설치하기 전에 <code>--layout</code> - 옵션을 사용하여 설정을 점검할 수 있다.<br /> - 출력예:</p> - -<div class="example"><p><code> - suEXEC setup:<br /> - suexec binary: /usr/local/apache2/sbin/suexec<br /> - document root: /usr/local/apache2/share/htdocs<br /> - userdir suffix: public_html<br /> - logfile: /usr/local/apache2/var/log/suexec_log<br /> - safe path: /usr/local/bin:/usr/bin:/bin<br /> - caller ID: www<br /> - minimum user ID: 100<br /> - minimum group ID: 100<br /> -</code></p></div> - <p><strong>suEXEC wrapper를 컴파일하고 설치하기</strong><br /> <code>--enable-suexec</code> 옵션으로 suEXEC 기능을 가능하게한 경우 <code>make</code> 명령어를 실행하면 <code>suexec</code> diff --git a/docs/manual/suexec.xml.ko b/docs/manual/suexec.xml.ko index ec0aef7638..7025e9ebd1 100644 --- a/docs/manual/suexec.xml.ko +++ b/docs/manual/suexec.xml.ko @@ -1,7 +1,7 @@ <?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.14 (outdated: 1.15) --> +<!-- English Revision: 1.15 --> <!-- Copyright 2003-2004 The Apache Software Foundation @@ -373,23 +373,6 @@ 기본값은 "/usr/local/bin:/usr/bin:/bin"이다.</dd> </dl> - <p><strong>suEXEC 구성을 점검하라</strong><br /> - suEXEC wrapper를 컴파일하고 설치하기 전에 <code>--layout</code> - 옵션을 사용하여 설정을 점검할 수 있다.<br /> - 출력예:</p> - -<example> - suEXEC setup:<br /> - suexec binary: /usr/local/apache2/sbin/suexec<br /> - document root: /usr/local/apache2/share/htdocs<br /> - userdir suffix: public_html<br /> - logfile: /usr/local/apache2/var/log/suexec_log<br /> - safe path: /usr/local/bin:/usr/bin:/bin<br /> - caller ID: www<br /> - minimum user ID: 100<br /> - minimum group ID: 100<br /> -</example> - <p><strong>suEXEC wrapper를 컴파일하고 설치하기</strong><br /> <code>--enable-suexec</code> 옵션으로 suEXEC 기능을 가능하게한 경우 <code>make</code> 명령어를 실행하면 <code>suexec</code> diff --git a/docs/manual/suexec.xml.meta b/docs/manual/suexec.xml.meta index eb64d9e261..f3815fb393 100644 --- a/docs/manual/suexec.xml.meta +++ b/docs/manual/suexec.xml.meta @@ -8,6 +8,6 @@ <variants> <variant>en</variant> <variant>ja</variant> - <variant outdated="yes">ko</variant> + <variant>ko</variant> </variants> </metafile> diff --git a/docs/manual/urlmapping.html.ko.euc-kr b/docs/manual/urlmapping.html.ko.euc-kr index 4221a238a5..5b5607eb86 100644 --- a/docs/manual/urlmapping.html.ko.euc-kr +++ b/docs/manual/urlmapping.html.ko.euc-kr @@ -22,8 +22,6 @@ <a href="./ja/urlmapping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="./ko/urlmapping.html" title="Korean"> ko </a></p> </div> -<div class="outofdate">이 문서는 최신판 번역이 아닙니다. - 최근에 변경된 내용은 영어 문서를 참고하세요.</div> <p>이 문서는 요청의 URL을 가지고 아파치가 어떻게 서비스할 파일의 파일시스템상 위치를 찾는지 설명한다.</p> @@ -41,7 +39,7 @@ <div class="section"> <h2><a name="related" id="related">관련된 모듈과 지시어들</a></h2> -<table class="related"><tr><th>관련된 모듈</th><th>관련된 지시어</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_alias.html">mod_alias</a></code></li><li><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li><li><code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code></li><li><code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code></li><li><code class="module"><a href="./mod/mod_vhost_alias.html">mod_vhost_alias</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_alias.html#alias">Alias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code></li><li><code class="directive"><a href="./mod/mod_speling.html#checkspelling">CheckSpelling</a></code></li><li><code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code></li><li><code class="directive"><a href="./mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#redirect">Redirect</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#redirectmatch">RedirectMatch</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritematch">RewriteMatch</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#scriptaliasmatch">ScriptAliasMatch</a></code></li><li><code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code></li></ul></td></tr></table> +<table class="related"><tr><th>관련된 모듈</th><th>관련된 지시어</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_alias.html">mod_alias</a></code></li><li><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li><li><code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code></li><li><code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code></li><li><code class="module"><a href="./mod/mod_vhost_alias.html">mod_vhost_alias</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_alias.html#alias">Alias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code></li><li><code class="directive"><a href="./mod/mod_speling.html#checkspelling">CheckSpelling</a></code></li><li><code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code></li><li><code class="directive"><a href="./mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiepath">ProxyPassReverseCookiePath</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#redirect">Redirect</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#redirectmatch">RedirectMatch</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritematch">RewriteMatch</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#scriptaliasmatch">ScriptAliasMatch</a></code></li><li><code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code></li></ul></td></tr></table> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div> <div class="section"> <h2><a name="documentroot" id="documentroot">DocumentRoot</a></h2> @@ -182,10 +180,14 @@ ProxyPassReverse /foo/ http://internal.example.com/bar/ 적절한 문서를 가져오도록 설정하며, <code class="directive"><a href="./mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code> 지시어는 <code>internal.example.com</code>이 보내는 리다이렉션을 재작성하여 리다이렉션이 현재 서버의 적절한 디렉토리를 가리키도록 한다. -그러나 문서 안에 있는 링크는 재작성하지 않음을 주의하라. +또, <code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code>과 +<code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code>은 +같은 방법으로 원래 서버가 보낸 쿠키를 재작성한다.</p> +<p>그러나 문서 안에 있는 링크는 재작성하지 않음을 주의하라. <code>internal.example.com</code>에 대한 절대링크는 클라이언트가 프록시서버가 아니라 <code>internal.example.com</code>으로 직접 -요청하게 한다.</p> +요청하게 한다. 제삼자가 만든 <a href="http://apache.webthing.com/mod_proxy_html/">mod_proxy_html</a> +모듈을 사용하여 HTML과 XHTML에 있는 링크를 재작성할 수 있다.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div> <div class="section"> <h2><a name="rewrite" id="rewrite">재작성 엔진 (Rewriting Engine)</a></h2> diff --git a/docs/manual/urlmapping.xml.ko b/docs/manual/urlmapping.xml.ko index 4ec00dd527..b7773e7c70 100644 --- a/docs/manual/urlmapping.xml.ko +++ b/docs/manual/urlmapping.xml.ko @@ -1,7 +1,7 @@ <?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.12 (outdated: 1.13) --> +<!-- English Revision: 1.13 --> <!-- Copyright 2003-2004 The Apache Software Foundation @@ -48,6 +48,8 @@ <directive module="core">Options</directive> <directive module="mod_proxy">ProxyPass</directive> <directive module="mod_proxy">ProxyPassReverse</directive> +<directive module="mod_proxy">ProxyPassReverseCookieDomain</directive> +<directive module="mod_proxy">ProxyPassReverseCookiePath</directive> <directive module="mod_alias">Redirect</directive> <directive module="mod_alias">RedirectMatch</directive> <directive module="mod_rewrite">RewriteCond</directive> @@ -204,10 +206,16 @@ ProxyPassReverse /foo/ http://internal.example.com/bar/ 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>으로 직접 -요청하게 한다.</p> +요청하게 한다. 제삼자가 만든 <a +href="http://apache.webthing.com/mod_proxy_html/">mod_proxy_html</a> +모듈을 사용하여 HTML과 XHTML에 있는 링크를 재작성할 수 있다.</p> </section> <section id="rewrite"><title>재작성 엔진 (Rewriting Engine)</title> diff --git a/docs/manual/urlmapping.xml.meta b/docs/manual/urlmapping.xml.meta index f31114d930..9988a3d7ee 100644 --- a/docs/manual/urlmapping.xml.meta +++ b/docs/manual/urlmapping.xml.meta @@ -8,6 +8,6 @@ <variants> <variant>en</variant> <variant outdated="yes">ja</variant> - <variant outdated="yes">ko</variant> + <variant>ko</variant> </variants> </metafile> |