Commit af738213 authored by No Author's avatar No Author
Browse files

This commit was manufactured by cvs2svn to create branch 

'APACHE_2_0_BRANCH'.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/APACHE_2_0_BRANCH@104959 13f79535-47bb-0310-9956-ffa450edef68
parent 80549fa1

docs/manual/developer/modules.xml.ja

0 → 100644
+271 −0
Changes for docs/manual/developer/modules.xml.ja: 271 added lines, 0 removed lines.
Original line number Diff line number Diff line 
<?xml version="1.0" encoding="iso-2022-jp"?>

<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">

<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>

<!-- English Revision: 1.7 -->



<!--

 Copyright 2003-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="modules.xml.meta">

<parentdocument href="./">Developer Documentation</parentdocument>



<title>$B%b%8%e!<%k$N(B Apache 1.3 $B$+$i(B Apache 2.0 $B$X$N0\?"(B</title>



<summary>

    <p>$B$3$NJ8=q$O(B <code>mod_mmap_static</code> $B%b%8%e!<%k$r(B Apache 2.0 $BMQ$K0\?"$7$?;~$K(B

    $B3X$s$@7P83$r$b$H$K=q$$$?!":G=i$N<j0z$-=q$G$9!#$^$@$^$@40A4$8$c$J$$$7!"(B

    $B$R$g$C$H$9$k$H4V0c$C$F$$$kItJ,$b$"$k$+$b$7$l$^$;$s$,!"(B

    $B<h$C3]$j$K$O$J$k$G$7$g$&!#(B</p>

</summary>



<section id="easy"><title>$B4JC1$JJQ99E@(B</title>



    <section id="cleanup"><title>$B%/%j!<%s%J%C%W(B $B%k!<%A%s(B</title>

      <p>$B%/%j!<%s%J%C%W%k!<%A%s$O(B <code>apr_status_t</code> $B7?$G$"$kI,MW$,$"$j$^$9!#(B

      $B$=$7$F!"(Bapr_status_t $B7?$NCM$rJV$5$J$/$F$O$J$j$^$;$s!#(B

      $B%/%j!<%s%J%C%WCf$N%(%i!<$rDLCN$9$kI,MW$,$J$1$l$P!"JV$jCM$OIaDL!"(B

      <code>ARP_SUCCESS</code> $B$G$9!#$?$H$(%(%i!<$rDLCN$7$?$H$7$F$b!"(B

      $B$9$Y$F$N%3!<%I$,$=$NDLCN$r%A%'%C%/$7$?$j!"(B

      $B%(%i!<$K1~$8$?F0:n$r$9$k$o$1$G$O$J$$$3$H$K5$$r$D$1$F$/$@$5$$!#(B</p>

    </section>





    <section id="init"><title>$B=i4|2=%k!<%A%s(B</title>



    <p>$B=i4|2=%k!<%A%s$O=hM}A4BN$+$i8+$F$7$C$/$j$/$k$h$&$J0UL#$rI=$9$h$&$K!"(B

    $BL>A0$,JQ99$5$l$^$7$?!#$G$9$+$i!"(B<code>mmap_init</code> $B$+$i(B <code>mmap_post_config</code>

    $B$N$h$&$K$A$g$C$HJQ99$5$l$^$7$?!#(B

    $BEO$5$l$k0z?t$OBgI}$KJQ99$5$l!"<!$N$h$&$K$J$j$^$7$?!#(B</p>



      <ul>

        <li><code>apr_pool_t *p</code></li>

        <li><code>apr_pool_t *plog</code></li>

        <li><code>apr_pool_t *ptemp</code></li>

        <li><code>server_rec *s</code></li>

      </ul>

    </section>



    <section id="datatypes"><title>$B%G!<%?7?(B</title>

      <p>$B%G!<%?7?$N$[$H$s$I$O(B <a

      href="http://apr.apache.org/">APR</a> $B$K0\$5$l$^$7$?!#$D$^$j!"(B

      $B$$$/$D$+$NL>A0$,A0=R$N$h$&$KJQ99$5$l$F$$$^$9!#(B

      $B;\$9$Y$-JQ99E@$N4JC1$J0lMw$r0J2<$K<($7$^$9!#(B</p>



      <ul>

        <li><code>pool</code> becomes <code>apr_pool_t</code></li>

        <li><code>table</code> becomes <code>apr_table_t</code></li>

      </ul>

    </section>

</section>



<section id="messy"><title>$B$b$C$HLq2p$JJQ99E@!D(B</title>



    <section id="register-hooks"><title>$B%U%C%/$NEPO?(B</title>

      <p>$B?7$7$$%"!<%-%F%/%A%c$G$O:n@.$7$?4X?t$r8F$S=P$9$N$K(B

      $B0lO"$N%U%C%/$r;HMQ$7$^$9!#$3$N%U%C%/$O!"?7$7$$4X?t(B

      <code>static void register_hooks(void)</code> $B$r;H$C$FEPO?$9$k$h$&!"(B

      $B%b%8%e!<%k$K=q$-B-$5$J$/$F$O$J$j$^$;$s!#(B

      $B$3$N4X?t$O!"$J$K$r$9$Y$-$+0lC6M}2r$7$F$7$^$($P!"(B

      $B==J,$K$o$+$j$d$9$$$b$N$G$9!#(B

      $B%j%/%(%9%H$N=hM}$N$"$k%9%F!<%8$G8F$S=P$5$J$/$F$O$J$i$J$$(B

      $B4X?t$OEPO?$9$kI,MW$,$"$j$^$9!#%O%s%I%i$OEPO?$9$kI,MW$O$"$j$^$;$s!#(B

      $B4X?t$rEPO?$G$-$k%U%'!<%:$O$?$/$5$s$"$j$^$9!#(B

      $B$=$l$>$l$N%U%'!<%:$G!"4X?t$r8F$S=P$9AjBPE*$J=gHV$O!"(B

      $B$+$J$j$NDxEY@)8f$G$-$^$9!#(B</p>



    <p>$B0J2<$O!"(B<code>mod_mmap_static</code> $B$KDI2C$7$?%3!<%I$G$9(B:</p>



      <example><pre>

static void register_hooks(void)

{

    static const char * const aszPre[]={ "http_core.c",NULL };

    ap_hook_post_config(mmap_post_config,NULL,NULL,HOOK_MIDDLE);

    ap_hook_translate_name(mmap_static_xlat,aszPre,NULL,HOOK_LAST);

};</pre>

      </example>



    <p>$B$3$3$G$O8F$S$@$9$Y$-Fs$D$N4X?t$rEPO?$7$F$$$^$9!#0l$D$O(B

    <code>post_config</code> $B%9%F!<%8MQ(B ($B$[$H$s$I$9$Y$F$N%b%8%e!<%k(B

    $B$O$3$l$,I,MW$G$9(B) $B$G!"$b$&0l$D$O(B <code>translate_name</code> $B%U%'!<%:MQ$G$9!#(B

    $B$=$l$>$l$N4X?t$OL>A0$O0c$&$1$l$I$b7A<0$OF1$8$G$"$k$3$H$KCm0U$7$F$/$@$5$$!#(B

    $B$=$l$G$O!"7A<0$O$I$N$h$&$K$J$C$F$$$k$G$7$g$&$+(B?</p>



      <example>

        ap_hook_<var>phase_name</var>(<var>function_name</var>,

        <var>predecessors</var>, <var>successors</var>, <var>position</var>);

      </example>



    <p>$B;0$D$N0LCV$,Dj5A$5$l$F$$$^$9!D(B</p>



      <ul>

        <li><code>HOOK_FIRST</code></li>

        <li><code>HOOK_MIDDLE</code></li>

        <li><code>HOOK_LAST</code></li>

      </ul>



    <p>$B0LCV$rDj5A$9$k$K$O!">e5-$N!V0LCV!W$r;XDj$7!"(B

    $B=$>~;R$G$"$k!V@h9T!W$H!V8e9T!W$G<j$r2C$($^$9!#(B

   $B!V@h9T!W!V8e9T!W$O!"8F$P$l$k$Y$-4X?t$N%j%9%H$G$9!#(B

   $B!V@h9T!W$O4X?t$N<B9TA0$K8F$P$l$k$b$N$G!"(B

   $B!V8e9T!W$O<B9T8e$K8F$P$l$k$b$N$G$9!#(B</p>



    <p><code>mod_mmap_static</code> $B$N>l9g!"(B<code>post_config</code>

    $B%9%F!<%8$G$OI,MW$"$j$^$;$s$,!"(B

    <code>mmap_static_xlat</code> $B$,(B core $B%b%8%e!<%k$,L>A0$NJQ49$r<B9T$7$?8e$K(B

    <strong>$B8F$P$l$J$1$l$P$J$j$^$;$s(B</strong>$B!#(B

    $B$=$3$G(B aszPre $B$r;H$C$F(B <code>HOOK_LAST</code> $B$N=$>~;R$rDj5A$7$F$$$^$9!#(B</p>

  </section>



    <section id="moddef"><title>$B%b%8%e!<%k$NDj5A(B</title>

      <p>$B%b%8%e!<%k$NDj5A$r:n@.$9$k:]$KCm0U$7$J$1$l$P$J$i$J$$(B

      $B%9%F!<%8$N?t$O7c8:$7$F$$$^$9!#8E$$Dj5A$O<!$N$h$&$K$J$C$F$$$^$7$?!#(B</p>



      <example><pre>

module MODULE_VAR_EXPORT <var>module_name</var>_module =

{

    STANDARD_MODULE_STUFF,

    /* initializer */

    /* dir config creater */

    /* dir merger --- default is to override */

    /* server config */

    /* merge server config */

    /* command handlers */

    /* handlers */

    /* filename translation */

    /* check_user_id */

    /* check auth */

    /* check access */

    /* type_checker */

    /* fixups */

    /* logger */

    /* header parser */

    /* child_init */

    /* child_exit */

    /* post read-request */

};</pre>

      </example>



    <p>$B?7$7$$9=B$BN$O$H$C$F$b%7%s%W%k$G$9!D(B</p>

      <example><pre>

module MODULE_VAR_EXPORT <var>module_name</var>_module =

{

    STANDARD20_MODULE_STUFF,

    /* create per-directory config structures */

    /* merge per-directory config structures  */

    /* create per-server config structures    */

    /* merge per-server config structures     */

    /* command handlers */

    /* handlers */

    /* register hooks */

};</pre>

      </example>



    <p>$B$3$N$&$A$N$$$/$D$+$O8E$$$b$N$+$i?7$7$$$b$N$KD>@\FI$_BX$($i$l$k$b$N$G!"(B

    $B$$$/$D$+$O$=$&$G$O$"$j$^$;$s!#$I$&$9$l$P$$$$$N$+$rMWLs$7$F$_$^$9!#(B</p>



    <p>$BD>@\FI$_BX$($i$l$k%9%F!<%8(B:</p>



    <dl>

      <dt><code>/* $B%G%#%l%/%H%j@_Dj:n@.4X?t(B */</code></dt>

      <dd><code>/* $B%G%#%l%/%H%jKh@_Dj9=B$BN:n@.(B */</code></dd>



      <dt><code>/* $B%5!<%P@_Dj:n@.4X?t(B */</code></dt>

      <dd><code>/* $B%5!<%PKh@_Dj9=B$BN:n@.(B */</code></dd>



      <dt><code>/* $B%G%#%l%/%H%j@_Dj%^!<%84X?t(B */</code></dt>

      <dd><code>/* $B%G%#%l%/%H%jKh@_Dj9=B$BN%^!<%8(B */</code></dd>



      <dt><code>/* $B%5!<%P@_Dj%^!<%84X?t(B */</code></dt>

      <dd><code>/* $B%5!<%PKh@_Dj9=B$BN:n@.%^!<%8(B */</code></dd>



      <dt><code>/* $B%3%^%s%I!&%F!<%V%k(B */</code></dt>

      <dd><code>/* $B%3%^%s%I(B apr_table_t */</code></dd>



      <dt><code>/* $B%O%s%I%i(B */</code></dt>

      <dd><code>/* $B%O%s%I%i(B */</code></dd>

    </dl>



    <p>$B8E$$4X?t$N;D$j$N$b$N$O%U%C%/$H$7$FEPO?$5$l$k$Y$-$G$9!#(B

    $B8=;~E@$G<!$N$h$&$J%U%C%/!&%9%F!<%8$,Dj5A$5$l$F$$$^$9!D(B</p>



    <dl>

      <dt><code>ap_hook_post_config</code></dt>

      <dd>($B0JA0$N(B <code>_init</code> $B%k!<%A%s$,EPO?$5$l$k$Y$->l=j$G$9(B)</dd>



      <dt><code>ap_hook_http_method</code></dt>

      <dd>($B%j%/%(%9%H$+$i(B HTTP $B%a%=%C%I$r<hF@$7$^$9(B ($B8_49MQ(B))</dd>



      <dt><code>ap_hook_open_logs</code></dt>

      <dd>($BFCDj$N%m%0$N%*!<%W%s(B)</dd>



      <dt><code>ap_hook_auth_checker</code></dt>

      <dd>($B%j%=!<%9$,8"8B$rI,MW$H$9$k$+$I$&$+$N3NG'(B)</dd>



      <dt><code>ap_hook_access_checker</code></dt>

      <dd>($B%b%8%e!<%k8GM-$N@)Ls$N3NG'(B)</dd>



      <dt><code>ap_hook_check_user_id</code></dt>

      <dd>($B%f!<%6(B ID $B$H%Q%9%o!<%I$N3NG'(B)</dd>



      <dt><code>ap_hook_default_port</code></dt>

      <dd>($B%5!<%P$N%G%U%)%k%H!&%]!<%H$N<hF@(B)</dd>



      <dt><code>ap_hook_pre_connection</code></dt>

      <dd>($B=hM}$ND>A0$KI,MW$J$3$H$r<B9T!#$?$@$7(B accept $BD>8e$K8F$P$l$k(B)</dd>



      <dt><code>ap_hook_process_connection</code></dt>

      <dd>($B%W%m%H%3%k$N=hM}(B)</dd>



      <dt><code>ap_hook_child_init</code></dt>

      <dd>($B;R%W%m%;%k5/F0D>8e(B)</dd>



      <dt><code>ap_hook_create_request</code></dt>

      <dd>(??)</dd>



      <dt><code>ap_hook_fixups</code></dt>

      <dd>($B1~EzFbMF$N@8@.$rJQ99$9$k%i%9%H!&%A%c%s%9(B)</dd>



      <dt><code>ap_hook_handler</code></dt>

      <dd>($B1~EzFbMF$N@8@.(B)</dd>



      <dt><code>ap_hook_header_parser</code></dt>

      <dd>($B%b%8%e!<%k$K%X%C%@$N>H2q$r$5$;$k!#$[$H$s$I$N%b%8%e!<%k$G$O;H$o$l$^$;$s!#(Bpost_read_request $B$r;H$$$^$9(B)</dd>



      <dt><code>ap_hook_insert_filter</code></dt>

      <dd>($B%U%#%k%?!&%A%'%$%s$K%U%#%k%?$rA^F~(B)</dd>



      <dt><code>ap_hook_log_transaction</code></dt>

      <dd>($B%j%/%(%9%H$K$D$$$F$N>pJs$r5-O?$9$k(B)</dd>



      <dt><code>ap_hook_optional_fn_retrieve</code></dt>

      <dd>($B%*%W%7%g%s$H$7$FEPO?$5$l$?4X?t$N<hF@(B)</dd>



      <dt><code>ap_hook_post_read_request</code></dt>

      <dd>($B%j%/%(%9%H$rFI$_$3$s$@8e!"B>$N%U%'!<%:$NA0$K8F$P$l$k(B)</dd>



      <dt><code>ap_hook_quick_handler</code></dt>

      <dd>$B%j%/%(%9%H$N=hM}$,;O$^$kA0$K8F$P$l$k!#%-%c%C%7%e%b%8%e!<%k$,(B

      $B;HMQ$7$F$$$k(B</dd>



      <dt><code>ap_hook_translate_name</code></dt>

      <dd>(URI $B$r%U%!%$%kL>$KJQ49$9$k(B)</dd>



      <dt><code>ap_hook_type_checker</code></dt>

      <dd>($BJ8=q7?$N7hDj$H@_Dj!#$"$k$$$O$=$NJRJ}(B)</dd>

    </dl>

  </section>

</section>

</manualpage>

docs/manual/howto/auth.xml.ja

0 → 100755
+389 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/manual/mod/mod_alias.html.ko.euc-kr

0 → 100644
+351 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/manual/mod/mod_alias.xml.ko

0 → 100644
+335 −0
Changes for docs/manual/mod/mod_alias.xml.ko: 335 added lines, 0 removed lines.
Original line number Diff line number Diff line 
<?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.18 (outdated: 1.19) -->



<!--

 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.

-->



<modulesynopsis metafile="mod_alias.xml.meta">



<name>mod_alias</name>

<description>파일시스템의 다른 부분들을 문서 계층구조에 포함하고,

    URL 리다이렉션을 제공한다</description>

<status>Base</status>

<sourcefile>mod_alias.c</sourcefile>

<identifier>alias_module</identifier>



<summary>

    <p>이 모듈이 제공하는 지시어들을 사용하여 서버가 요청을

    받을때 URL을 수정하거나 조작할 수 있다. <directive

    module="mod_alias">Alias</directive>와 <directive

    module="mod_alias">ScriptAlias</directive> 지시어는 URL을

    파일시스템 경로로 대응한다. 그래서 <directive

    module="core">DocumentRoot</directive> 아래에 없는 내용을

    웹으로 서비스할 수 있다. 또, <directive

    module="mod_alias">ScriptAlias</directive> 지시어는 지정한

    디렉토리에 CGI 스크립트밖에 없다고 알린다.</p>



    <p><directive module="mod_alias">Redirect</directive> 지시어는

    클라이언트에게 다른 URL로 새로운 요청을 하도록 지시한다.

    자원을 새로운 장소로 옮긴 경우 자주 사용한다.</p>

</summary>



<seealso><module>mod_rewrite</module></seealso> <seealso><a

href="../urlmapping.html">URL을 파일시스템에 대응</a></seealso>



<section id="order"><title>처리 순서</title>



<p>서로 다른 사용장소에서 Alias와 Redirect를 사용하면 다른 지시어와

같이 표준 <a href="../sections.html#mergin">결합 방법</a>에

따라 처리한다. 그러나 같은 사용장소에 (예를 들어, 같은 <directive

type="section" module="core">VirtualHost</directive> 섹션에)

Alias와 Redirect를 사용하면 아래 순서대로 처리한다.</p>



<p>먼저 모든 Redirect를 처리한 후 Alias를 처리한다. 그래서

<directive module="mod_alias">Redirect</directive>나 <directive

module="mod_alias">RedirectMatch</directive>에 해당하는 요청은

절대로 Alias하지 않는다. 그리고 Alias와 Redirect는 설정파일에서

첫번째로 나오는 것을 사용한다.</p>



<p>그래서 여러 지시어가 동일한 하위경로에 해당하는 경우 모든

지시어를 적용하기위해서는 가장 상세한 경로를 먼저 사용해야 한다.

예를 들어, 다음 설정은 의도한대로 동작한다:</p>



<example>

Alias /foo/bar /baz<br />

Alias /foo /gaq

</example>



<p>그러나 위의 두 지시어 순서를 바꾸면 <code>/foo/bar</code>

<directive module="mod_alias">Alias</directive> 이전에

<code>/foo</code> <directive module="mod_alias">Alias</directive>를

적용하므로 항상 두번째 지시어를 무시한다.</p>



</section>



<directivesynopsis>

<name>Alias</name>

<description>URL을 특정 파일시스템 장소로 대응한다</description>

<syntax>Alias <var>URL-path</var>

<var>file-path</var>|<var>directory-path</var></syntax>

<contextlist><context>server config</context><context>virtual host</context>

</contextlist>



<usage>



    <p><directive>Alias</directive> 지시어를 사용하면 파일시스템에서

    <directive module="core">DocumentRoot</directive> 밖에 있는

    문서도 서비스할 수 있다. <var>url-path</var>로 시작하는

    (%로 인코딩된) URL을 <var>directory-path</var>로 시작하는

    파일에 대응한다.</p>



    <example><title>예제:</title>

      Alias /image /ftp/pub/image

    </example>



    <p>http://myserver/image/foo.gif를 요청하면 서버는

    /ftp/pub/image/foo.gif 파일을 넘겨준다.</p>



    <p><var>url-path</var> 끝에 /를 포함하면, URL 끝에 /를

    사용해야만 영향이 있음을 주의하라. 즉, <code>Alias /icons/

    /usr/local/apache/icons/</code> 설정은 url <code>/icons</code>와

    관계가 없다.</p>



    <p>대응의 <em>대상</em>을 포함하는 여러 <directive

    type="section" module="core">Directory</directive> 섹션이

    필요할지도 모른다. 이 지시어는 <directive type="section"

    module="core">Directory</directive> 섹션을 검사하기 전에

    처리하므로, 대응의 대상만 섹션의 영향을 받는다. (그러나

    <directive type="section" module="core">Location</directive>

    섹션은 이 지시어를 처리하기 전에 한번만 검사하므로 지정한

    URL 이하 전체에 영향을 준다.)</p>



    <p>특히 <directive module="core">DocumentRoot</directive>

    밖에 있는 디렉토리로 <code>Alias</code>를 만들었다면, 직접

    대상 디렉토리의 접근을 허용해줘야 한다.</p>



    <example><title>예제:</title>

        Alias /image /ftp/pub/image<br />

        &lt;Directory /ftp/pub/image&gt;<br />

        <indent>

            Order allow,deny<br />

            Allow from all<br />

        </indent>

        &lt;/Directory&gt;

    </example>



</usage>

</directivesynopsis>



<directivesynopsis>

<name>AliasMatch</name>

<description>정규표현식을 사용하여 URL을 파일시스템 장소로

대응한다</description>

<syntax>AliasMatch <var>regex</var>

<var>file-path</var>|<var>directory-path</var></syntax>

<contextlist><context>server config</context><context>virtual host</context>

</contextlist>



<usage>

    <p>이 지시어는 <directive module="mod_alias">Alias</directive>와

    같지만, 간단히 URL의 앞부분만 비교하는 대신 표준 정규표현식을

    사용한다. 지정한 정규표현식을 URL 경로와 비교하여 맞다면,

    서버는 괄호로 묶은 부분을 대체하여 파일명으로 사용한다.

    예를 들어, 다음과 같이 <code>/icons</code> 디렉토리를 사용할

    수 있다:</p>



    <example>

      AliasMatch ^/icons(.*) /usr/local/apache/icons$1

    </example>

</usage>

</directivesynopsis>



<directivesynopsis>

<name>Redirect</name>

<description>클라이언트가 다른 URL에 접속하도록 요청하는 외부

리다이렉션을 보낸다</description>

<syntax>Redirect [<var>status</var>] <var>URL-path</var>

<var>URL</var></syntax>

<contextlist><context>server config</context><context>virtual host</context>

<context>directory</context><context>.htaccess</context></contextlist>

<override>FileInfo</override>



<usage>

    <p>Redirect 지시어는 이전 URL을 새로운 URL로 대응한다.

    클라이언트에게 새로운 URL을 보내고, 클라이언트는 새로운

    주소로 다시 한번 접속한다. (%로 인코딩된) <var>URL-path</var>로

    시작하는 요청을 받으면 (%로 인코딩된) <var>URL</var>로 시작하는

    새로운 URL로 리다이렉션 오류를 보낸다.</p>



    <example><title>예제:</title>

      Redirect /service http://foo2.bar.com/service

    </example>



    <p>클라이언트가 http://myserver/service/foo.txt를 요청하면

    대신 http://foo2.bar.com/service/foo.txt에 접근하라는 응답을

    받는다.</p>



<note><title>주의</title> <p>Redirect 지시어는 설정파일에서

나오는 순서와 관계없이 Alias와 ScriptAlias 지시어보다 우선순위가

높다. 또, .htaccess 파일이나 <directive type="section"

module="core">Directory</directive> 섹션에서 사용하더라도

<var>URL-path</var>에는 상대경로가 아니라 반드시 완전한 URL을

사용해야 한다.</p></note>



    <p><var>status</var> 아규먼트를 지정하지않으면, "임시

    (temporary)" (HTTP 상태 302) 리다이렉션을 보낸다. 즉,

    클라이언트에게 자원을 임시로 옮겼다고 알린다. <var>status</var>

    아규먼트를 사용하여 다른 HTTP 상태코드를 반환할 수 있다:</p>



    <dl>

      <dt>permanent</dt>



      <dd>자원을 완전히 옮겼음을 뜻하는 영구 리다이렉션 상태를

      (301) 반환한다.</dd>



      <dt>temp</dt>



      <dd>임시 리다이렉션 상태를 (302) 반환한다. 기본값이다.</dd>



      <dt>seeother</dt>



      <dd>자원이 교체되었음을 뜻하는 "참조 (See Other)" 상태를

      (303) 반환한다.</dd>



      <dt>gone</dt>



      <dd>자원이 영구히 삭제되었음을 뜻하는 "소멸 (Gone)" 상태를

      (410) 반환한다. 이 상태를 사용하면 <var>URL</var> 아규먼트를

      사용할 수 없다.</dd>

    </dl>



    <p><var>status</var>에 숫자 상태코드를 사용하여 다른 상태코드도

    반환할 수 있다. 상태가 300과 399 사이라면 <var>URL</var>

    아규먼트를 사용해야 하고, 아니라면 생략해야 한다. 단, 아파치

    코드에 상태가 정의되있어야 한다 (http_protocol.c의

    <code>send_error_response</code> 함수 참고).</p>



    <example><title>예제:</title>

      Redirect permanent /one http://example.com/two<br />

      Redirect 303 /three http://example.com/other

    </example>



</usage>

</directivesynopsis>



<directivesynopsis>

<name>RedirectMatch</name>

<description>현재 URL이 정규표현식에 해당하면 외부 리다이렉션을

보낸다</description>

<syntax>RedirectMatch [<var>status</var>] <var>regex</var>

<var>URL</var></syntax>

<contextlist><context>server config</context><context>virtual host</context>

<context>directory</context><context>.htaccess</context></contextlist>

<override>FileInfo</override>



<usage>

    <p>이 지시어는 <directive

    module="mod_alias">Redirect</directive>와 같지만, 간단히

    URL의 앞부분만 비교하는 대신 표준 정규표현식을 사용한다.

    지정한 정규표현식을 URL 경로와 비교하여 맞다면, 서버는 괄호로

    묶은 부분을 대체하여 파일명으로 사용한다. 예를 들어, 다음은

    모든 GIF 파일 요청에 대해 다른 서버의 비슷한 이름을 가진

    JPEG 파일로 리다이렉션을 보낸다:</p>



    <example>

      RedirectMatch (.*)\.gif$ http://www.anotherserver.com$1.jpg

    </example>

</usage>

</directivesynopsis>



<directivesynopsis>

<name>RedirectTemp</name>

<description>클라이언트가 다른 URL에 접속하도록 요청하는 외부

임시 리다이렉션을 보낸다</description>

<syntax>RedirectTemp <var>URL-path</var> <var>URL</var></syntax>

<contextlist><context>server config</context><context>virtual host</context>

<context>directory</context><context>.htaccess</context></contextlist>

<override>FileInfo</override>



<usage>

    <p>이 지시어는 클라이언트에게 리다이렉션이 임시적임을 (상태

    302) 알린다. <code>Redirect temp</code>와 정확히 같다.</p>

</usage>

</directivesynopsis>



<directivesynopsis>

<name>RedirectPermanent</name>

<description>클라이언트가 다른 URL에 접속하도록 요청하는 외부

영구 리다이렉션을 보낸다</description>

<syntax>RedirectPermanent <var>URL-path</var> <var>URL</var></syntax>

<contextlist><context>server config</context><context>virtual host</context>

<context>directory</context><context>.htaccess</context></contextlist>

<override>FileInfo</override>



<usage>

    <p>이 지시어는 클라이언트에게 리다이렉션이 영구적임을 (상태

    301) 알린다. <code>Redirect permanent</code>와 정확히 같다.</p>

</usage>

</directivesynopsis>



<directivesynopsis>

<name>ScriptAlias</name>

<description>URL을 특정 파일시스템 장소로 대응하고 대상이 CGI

스크립트라고 알린다</description>

<syntax>ScriptAlias <var>URL-path</var>

<var>file-path</var>|<var>directory-path</var></syntax>

<contextlist><context>server config</context><context>virtual host</context>

</contextlist>



<usage>

    <p><directive>ScriptAlias</directive> 지시어는 <directive

    module="mod_alias">Alias</directive> 지시어와 비슷하지만,

    추가로 대상 디렉토리에 <module >mod_cgi</module>의 cgi-script

    핸들러가 처리할 CGI 스크립트가 있다고 알린다.

    <var>URL-path</var>로 시작하는 (%로 인코딩된) URL을 파일시스템의

    절대경로인 두번째 아규먼트로 시작하는 스크립트에 대응한다.</p>



    <example><title>예제:</title>

      ScriptAlias /cgi-bin/ /web/cgi-bin/

    </example>



    <p><code>http://myserver/cgi-bin/foo</code>를 요청하면 서버는

    <code>/web/cgi-bin/foo</code> 스크립트를 실행한다.</p>

</usage>

</directivesynopsis>



<directivesynopsis>

<name>ScriptAliasMatch</name>

<description>정규표현식을 사용하여 URL을 특정 파일시스템 장소로

대응하고 대상이 CGI 스크립트라고 알린다</description>

<syntax>ScriptAliasMatch <var>regex</var>

<var>file-path</var>|<var>directory-path</var></syntax>

<contextlist><context>server config</context><context>virtual host</context>

</contextlist>



<usage>

    <p>이 지시어는 <directive

    module="mod_alias">ScriptAlias</directive>와 같지만, 간단히

    URL의 앞부분만 비교하는 대신 표준 정규표현식을 사용한다.

    지정한 정규표현식을 URL 경로와 비교하여 맞다면, 서버는 괄호로

    묶은 부분을 대체하여 파일명으로 사용한다. 예를 들어, 다음과

    같이 표준적인 <code>/cgi-bin</code>을 사용할 수 있다:</p>



    <example>

      ScriptAliasMatch ^/cgi-bin(.*) /usr/local/apache/cgi-bin$1

    </example>

</usage>

</directivesynopsis>



</modulesynopsis>

docs/manual/mod/mod_auth_digest.html.ko.euc-kr

0 → 100644
+290 −0

File added.

Preview size limit exceeded, changes collapsed.