granicus.if.org Git - apache/blob - docs/manual/mod/mod_setenvif.xml.ko

   1 <?xml version="1.0" encoding="EUC-KR" ?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
   4 <!-- English Revision: 151408:1043126 (outdated) -->
   5
   6 <!--
   7  Licensed to the Apache Software Foundation (ASF) under one or more
   8  contributor license agreements.  See the NOTICE file distributed with
   9  this work for additional information regarding copyright ownership.
  10  The ASF licenses this file to You under the Apache License, Version 2.0
  11  (the "License"); you may not use this file except in compliance with
  12  the License.  You may obtain a copy of the License at
  13
  14      http://www.apache.org/licenses/LICENSE-2.0
  15
  16  Unless required by applicable law or agreed to in writing, software
  17  distributed under the License is distributed on an "AS IS" BASIS,
  18  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  19  See the License for the specific language governing permissions and
  20  limitations under the License.
  21 -->
  22
  23 <modulesynopsis metafile="mod_setenvif.xml.meta">
  24
  25 <name>mod_setenvif</name>
  26 <description>¿äÃ»ÀÇ ¼º°Ý¿¡ µû¶ó È¯°æº¯¼ö ¼³Á¤À» º¯°æÇÑ´Ù</description>
  27 <status>Base</status>
  28 <sourcefile>mod_setenvif.c</sourcefile>
  29 <identifier>setenvif_module</identifier>
  30
  31
  32 <summary>
  33
  34     <p><module>mod_setenvif</module> ¸ðµâÀº ¿äÃ»ÀÇ ¼º°ÝÀÌ
  35     Á¤±ÔÇ¥Çö½Ä¿¡ ÇØ´çÇÏ´ÂÁö ¿©ºÎ·Î È¯°æº¯¼ö¸¦ ¼³Á¤ÇÑ´Ù. ¼¹öÀÇ
  36     ´Ù¸¥ ºÎºÐÀÌ Çàµ¿À» °áÁ¤ÇÒ¶§ ÀÌ È¯°æº¯¼ö¸¦ »ç¿ëÇÒ ¼ö ÀÖ´Ù.</p>
  37
  38     <p>¼³Á¤ÆÄÀÏ¿¡ ³ª¿À´Â ¼ø¼´ë·Î Áö½Ã¾î¸¦ Ã³¸®ÇÑ´Ù. ±×·¡¼
  39     ºê¶ó¿ìÀú°¡ MSIE°¡ ¾Æ´Ï¶ó mozillaÀÎ °æ¿ì <code>netscape</code>¸¦
  40     ¼³Á¤ÇÏ´Â ¾Æ·¡ ¿¹¿Í °°ÀÌ ¿©·¯ Áö½Ã¾î¸¦ ÇÔ²² »ç¿ëÇÒ ¼ö ÀÖ´Ù.</p>
  41
  42 <example>
  43   BrowserMatch ^Mozilla netscape<br />
  44   BrowserMatch MSIE !netscape<br />
  45 </example>
  46 </summary>
  47
  48 <seealso><a href="../env.html">¾ÆÆÄÄ¡ÀÇ È¯°æº¯¼ö</a></seealso>
  49
  50 <directivesynopsis>
  51 <name>BrowserMatch</name>
  52 <description>HTTP User-Agent¿¡ µû¶ó È¯°æº¯¼ö¸¦ ¼³Á¤ÇÑ´Ù</description>
  53 <syntax>BrowserMatch <em>regex [!]env-variable</em>[=<em>value</em>]
  54 [[!]<em>env-variable</em>[=<em>value</em>]] ...</syntax>
  55 <contextlist><context>server config</context>
  56 <context>virtual host</context><context>directory</context>
  57 <context>.htaccess</context></contextlist>
  58 <override>FileInfo</override>
  59
  60 <usage>
  61   <p><directive>BrowserMatch</directive>´Â <directive
  62   module="mod_setenvif">SetEnvIf</directive> Áö½Ã¾îÀÇ Æ¯º°ÇÑ
  63   °æ¿ì·Î, HTTP ¿äÃ» Çì´õ <code>User-Agent</code>¿¡ µû¶ó È¯°æº¯¼ö¸¦
  64   ¼³Á¤ÇÑ´Ù. ´ÙÀ½ µÎ ÁÙÀº °°´Ù:</p>
  65 <example>
  66    BrowserMatchNoCase Robot is_a_robot<br />
  67    SetEnvIfNoCase User-Agent Robot is_a_robot<br />
  68 </example>
  69
  70     <p>Ãß°¡ ¿¹Á¦:</p>
  71 <example>
  72     BrowserMatch ^Mozilla forms jpeg=yes browser=netscape<br />
  73     BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript<br />
  74     BrowserMatch MSIE !javascript<br />
  75 </example>
  76 </usage>
  77 </directivesynopsis>
  78
  79 <directivesynopsis>
  80 <name>BrowserMatchNoCase</name>
  81 <description>´ë¼Ò¹®ÀÚ¸¦ ±¸º°ÇÏÁö¾Ê°í User-Agent¿¡ µû¶ó È¯°æº¯¼ö¸¦
  82 ¼³Á¤ÇÑ´Ù</description>
  83 <syntax>BrowserMatchNoCase  <em>regex [!]env-variable</em>[=<em>value</em>]
  84     [[!]<em>env-variable</em>[=<em>value</em>]] ...</syntax>
  85 <contextlist><context>server config</context>
  86 <context>virtual host</context><context>directory</context>
  87 <context>.htaccess</context></contextlist>
  88 <override>FileInfo</override>
  89
  90 <usage>
  91
  92     <p><directive>BrowserMatchNoCase</directive> Áö½Ã¾î´Â <directive
  93     module="mod_setenvif">BrowserMatch</directive> Áö½Ã¾î¿Í
  94     ÀÇ¹Ì»ó °°´Ù. ±×·¯³ª ÀÌ Áö½Ã¾î´Â ´ë¼Ò¹®ÀÚ¸¦ ±¸º°ÇÏÁö¾Ê´Â´Ù.
  95     ¿¹¸¦ µé¾î:</p>
  96 <example>
  97     BrowserMatchNoCase mac platform=macintosh<br />
  98     BrowserMatchNoCase win platform=windows<br />
  99 </example>
 100
 101     <p><directive>BrowserMatch</directive>¿Í
 102     <directive>BrowserMatchNoCase</directive> Áö½Ã¾î´Â
 103     <directive module="mod_setenvif">SetEnvIf</directive>¿Í
 104     <directive module="mod_setenvif">SetEnvIfNoCase</directive>
 105     Áö½Ã¾îÀÇ Æ¯º°ÇÑ °æ¿ì´Ù. ´ÙÀ½ ÁÖ ÁÙÀº °°´Ù:</p>
 106 <example>
 107    BrowserMatchNoCase Robot is_a_robot<br />
 108    SetEnvIfNoCase User-Agent Robot is_a_robot<br />
 109 </example>
 110 </usage>
 111 </directivesynopsis>
 112
 113 <directivesynopsis>
 114 <name>SetEnvIf</name>
 115 <description>¿äÃ»ÀÇ ¼ºÁú¿¡ µû¶ó È¯°æº¯¼ö¸¦ ¼³Á¤ÇÑ´Ù</description>
 116 <syntax>SetEnvIf <em>attribute
 117     regex [!]env-variable</em>[=<em>value</em>]
 118     [[!]<em>env-variable</em>[=<em>value</em>]] ...</syntax>
 119 <contextlist><context>server config</context>
 120 <context>virtual host</context><context>directory</context>
 121 <context>.htaccess</context></contextlist>
 122 <override>FileInfo</override>
 123
 124 <usage>
 125     <p><directive>SetEnvIf</directive> Áö½Ã¾î´Â ¿äÃ»ÀÇ ¼ºÁú¿¡
 126     µû¶ó È¯°æº¯¼ö¸¦ Á¤ÀÇÇÑ´Ù. Ã¹¹øÂ° ¾Æ±Ô¸ÕÆ® <em>attribute</em>´Â
 127     ´ÙÀ½ ¼¼°¡ÁöÁß ÇÏ³ª´Ù:</p>
 128
 129 <ol>
 130 <li>HTTP ¿äÃ» Çì´õ (´õ ÀÚ¼¼ÇÑ Á¤º¸´Â <a
 131     href="http://www.rfc-editor.org/rfc/rfc2616.txt">RFC2616</a>
 132     Âü°í); ¿¹¸¦ µé¾î: <code>Host</code>, <code>User-Agent</code>,
 133     <code>Referer</code>, <code>Accept-Language</code>. Á¤±ÔÇ¥Çö½ÄÀ»
 134     »ç¿ëÇÏ¿© ¿©·¯ ¿äÃ» Çì´õ¸¦ ÁöÄªÇÒ ¼ö ÀÖ´Ù.</li>
 135
 136 <li>¿äÃ»ÀÇ ´ÙÀ½ ¼ºÁúÁß ÇÏ³ª:
 137     <ul>
 138       <li><code>Remote_Host</code> - (ÀÖ´Ù¸é) ¿äÃ»ÇÏ´Â Å¬¶óÀÌ¾ðÆ®ÀÇ
 139       È£½ºÆ®¸í</li>
 140
 141       <li><code>Remote_Addr</code> - ¿äÃ»ÇÏ´Â Å¬¶óÀÌ¾ðÆ®ÀÇ IP ÁÖ¼Ò</li>
 142
 143       <li><code>Server_Addr</code> - ¿äÃ»À» ¹Þ´Â ¼¹öÀÇ IP ÁÖ¼Ò
 144       (2.0.43 ¹öÀü ÀÌÈÄ¿¡¸¸)</li>
 145
 146       <li><code>Request_Method</code> - »ç¿ëÇÑ ¸Þ½áµå ÀÌ¸§
 147       (<code>GET</code>, <code>POST</code>, <em>µîµî</em>)</li>
 148
 149       <li><code>Request_Protocol</code> - ¿äÃ»ÀÇ ÇÁ·ÎÅäÄÝ ÀÌ¸§°ú
 150       ¹öÀü (<em>¿¹¸¦ µé¾î</em>, "HTTP/0.9", "HTTP/1.1", <em>µî.</em>)</li>
 151
 152       <li><code>Request_URI</code> - HTTP ¿äÃ»¿¡¼ ¿äÃ»ÇÑ ÀÚ¿ø
 153       -- ÀÏ¹ÝÀûÀ¸·Î URL¿¡¼ ÁúÀÇ¹®ÀÚ¿À» Á¦¿ÜÇÑ ½ºÅ´(scheme)°ú
 154       È£½ºÆ® ÀÌÈÄ ºÎºÐ</li>
 155     </ul>
 156 </li>
 157
 158 <li>¿äÃ»°ú ¿¬°üµÈ È¯°æº¯¼ö ÀÌ¸§. ±×·¡¼ <directive>SetEnvIf</directive>
 159 Áö½Ã¾î´Â ÀÌÀü Áö½Ã¾îÀÇ °á°ú¸¦ °Ë»çÇÒ ¼ö ÀÖ´Ù. ÀÌÀü¿¡
 160 <code>SetEnvIf[NoCase]</code> Áö½Ã¾î·Î Á¤ÀÇÇÑ È¯°æº¯¼ö¸¸À»
 161 °Ë»çÇÒ ¼ö ÀÖ´Ù. 'ÀÌÀü'ÀÌ¶õ (¼¹öÀü¿ª°ú °°ÀÌ) ´õ ³ÐÀº ¿µ¿ª È¤Àº
 162 Áö½Ã¾îÀÇ ÇöÀç ¿µ¿ª ÀÌÀüÀ» ¶æÇÑ´Ù. ¿äÃ» ¼ºÁúÀÌ ¾Æ´Ï°í Á¤±ÔÇ¥Çö½ÄÀÌ
 163 ¾Æ´Ñ <em>attribute</em>´Â È¯°æº¯¼ö·Î Ãë±ÞÇÑ´Ù.</li>
 164 </ol>
 165
 166 <p>µÎ¹øÂ° ¾Æ±Ô¸ÕÆ®´Â (<em>regex</em>) <a
 167 href="http://www.pcre.org/">Perl È£È¯ Á¤±ÔÇ¥Çö½Ä</a>ÀÌ´Ù.
 168 ÀÌ´Â POSIX.2 egrepÀÇ Á¤±ÔÇ¥Çö½Ä°ú ºñ½ÁÇÏ´Ù. <em>regex</em>°¡
 169 <em>attribute</em>¿¡ ´ëÀÀÇÏ¸é ³ª¸ÓÁö ¾Æ±Ô¸ÕÆ®¸¦ Ã³¸®ÇÑ´Ù.</p>
 170
 171 <p>³ª¸ÓÁö ¾Æ±Ô¸ÕÆ®´Â ¼³Á¤ÇÒ º¯¼ö¸í°ú (¼±ÅÃÀûÀÎ) ¼³Á¤°ªµéÀÌ´Ù.
 172 ´ÙÀ½°ú °°Àº Çü½ÄÀÌ´Ù</p>
 173
 174     <ol>
 175       <li><code><em>varname</em></code>, È¤Àº</li>
 176
 177       <li><code>!<em>varname</em></code>, È¤Àº</li>
 178
 179       <li><code><em>varname</em>=<em>value</em></code></li>
 180     </ol>
 181
 182     <p>Ã¹¹øÂ° ÇüÅÂ´Â °ªÀ¸·Î "1"À» »ç¿ëÇÑ´Ù. µÎ¹øÂ° ÇüÅÂ´Â º¯¼ö°¡
 183     ÀÌ¹Ì Á¤ÀÇµÈ °æ¿ì º¯¼ö¸¦ Á¦°ÅÇÏ°í, ¼¼¹øÂ°´Â º¯¼öÀÇ °ªÀ¸·Î
 184     <code><em>value</em></code>¸¦ ¼³Á¤ÇÑ´Ù. ¾ÆÆÄÄ¡ 2.0.51ºÎÅÍ
 185     <var>value</var>¿¡ ÀÖ´Â <code>$1</code>..<code>$9</code>¸¦
 186     <var>regex</var>ÀÇ °ýÈ£Ä£ ÇÏÀ§Ç¥Çö½ÄÀ¸·Î ´ëÃ¼ÇÑ´Ù.</p>
 187
 188 <example>
 189 <title>¿¹Á¦:</title>
 190    SetEnvIf Request_URI "\.gif$" object_is_image=gif<br />
 191    SetEnvIf Request_URI "\.jpg$" object_is_image=jpg<br />
 192    SetEnvIf Request_URI "\.xbm$" object_is_image=xbm<br />
 193         :<br />
 194    SetEnvIf Referer www\.mydomain\.com intra_site_referral<br />
 195         :<br />
 196    SetEnvIf object_is_image xbm XBIT_PROCESSING=1<br />
 197         :<br />
 198    SetEnvIf ^TS*  ^[a-z].*  HAVE_TS<br />
 199 </example>
 200
 201     <p>Ã³À½ ¼¼ ÁÙÀº ÀÌ¹ÌÁö ÆÄÀÏÀ» ¿äÃ»ÇÑ °æ¿ì È¯°æº¯¼ö
 202     <code>object_is_image</code>¸¦ ¼³Á¤ÇÑ´Ù. ³×¹øÂ° ÁÙÀº ÆäÀÌÁö¸¦
 203     <code>www.mydomain.com</code> À¥»çÀÌÆ®¿¡¼ ÂüÁ¶ÇÑ °æ¿ì
 204     <code>intra_site_referral</code>À» ¼³Á¤ÇÑ´Ù.</p>
 205
 206     <p>¸¶Áö¸· ¿¹´Â ¿äÃ»¿¡ ÀÌ¸§¿¡ "TS"·Î ½ÃÀÛÇÏ°í °ªÀÌ [a-z]
 207     Áß ÇÏ³ª·Î ½ÃÀÛÇÏ´Â Çì´õ°¡ ÀÖ´Â °æ¿ì È¯°æº¯¼ö
 208     <code>HAVE_TS</code>¸¦ ¼³Á¤ÇÑ´Ù.</p>
 209 </usage>
 210
 211 <seealso><a href="../env.html">¾ÆÆÄÄ¡ÀÇ È¯°æº¯¼ö</a>¿¡ ´õ ¸¹Àº
 212 ¿¹Á¦°¡ ÀÖ´Ù.
 213 </seealso>
 214 </directivesynopsis>
 215
 216 <directivesynopsis>
 217 <name>SetEnvIfExpr</name>
 218 <description>Sets environment variables based on an ap_expr expression</description>
 219 <contextlist><context>server config</context><context>virtual host</context><context>directory</context><context>.htaccess</context></contextlist>
 220 <usage><p>Documentation not yet translated. Please see English version of document.</p></usage>
 221 </directivesynopsis>
 222
 223 <directivesynopsis>
 224 <name>SetEnvIfNoCase</name>
 225 <description>´ë¼Ò¹®ÀÚ¸¦ ±¸º°ÇÏÁö¾Ê°í ¿äÃ»ÀÇ ¼ºÁú¿¡ µû¶ó È¯°æº¯¼ö¸¦
 226 ¼³Á¤ÇÑ´Ù</description>
 227 <syntax>SetEnvIfNoCase <em>attribute regex
 228         [!]env-variable</em>[=<em>value</em>]
 229     [[!]<em>env-variable</em>[=<em>value</em>]] ...</syntax>
 230 <contextlist><context>server config</context>
 231 <context>virtual host</context><context>directory</context>
 232 <context>.htaccess</context></contextlist>
 233 <override>FileInfo</override>
 234
 235 <usage>
 236
 237     <p><directive>SetEnvIfNoCase</directive>´Â ÀÇ¹Ì»ó <directive
 238     module="mod_setenvif">SetEnvIf</directive> Áö½Ã¾î¿Í °°Áö¸¸,
 239     ´ë¼Ò¹®ÀÚ¸¦ ±¸º°ÇÏÁö¾Ê°í Á¤±ÔÇ¥Çö½ÄÀ» Ã£´Â´Ù. ¿¹¸¦ µé¾î:</p>
 240 <example>
 241    SetEnvIfNoCase Host Apache\.Org site=apache
 242 </example>
 243
 244     <p>ÀÌ °æ¿ì HTTP ¿äÃ» Çì´õ <code>Host:</code>°¡
 245     <code>Apache.Org</code>, <code>apache.org</code> µîÀ» Æ÷ÇÔÇÏ¸é
 246     <code>site</code> È¯°æº¯¼ö¸¦ "<code>apache</code>"·Î ¼³Á¤ÇÑ´Ù.</p>
 247 </usage>
 248 </directivesynopsis>
 249 </modulesynopsis>