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

   1 <?xml version="1.0" encoding="iso-2022-jp"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
   4 <!-- English Revision: 1.9 (outdated: 1.12) -->
   5
   6 <!--
   7  Copyright 2002-2004 The Apache Software Foundation
   8
   9  Licensed under the Apache License, Version 2.0 (the "License");
  10  you may not use this file except in compliance with the License.
  11  You may obtain a copy of the License at
  12
  13      http://www.apache.org/licenses/LICENSE-2.0
  14
  15  Unless required by applicable law or agreed to in writing, software
  16  distributed under the License is distributed on an "AS IS" BASIS,
  17  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  18  See the License for the specific language governing permissions and
  19  limitations under the License.
  20 -->
  21
  22 <modulesynopsis metafile="mod_setenvif.xml.meta">
  23
  24 <name>mod_setenvif</name>
  25 <description>\e$B%j%/%(%9%H$NFCD'$K4p$E$$$?4D6-JQ?t$N@_Dj$r2DG=$K$9$k\e(B</description>
  26 <status>Base</status>
  27 <sourcefile>mod_setenvif.c</sourcefile>
  28 <identifier>setenvif_module</identifier>
  29 <summary>
  30
  31     <p><module>mod_setenvif</module>
  32     \e$B%b%8%e!<%k$O!"%j%/%(%9%H$N$"$kB&LL$,;XDj$5$l$?@55,I=8=\e(B
  33     \e$B$K9g$&$+$I$&$+$K$h$C$F4D6-JQ?t$r@_Dj$9$k5!G=$rDs6!$7$^$9!#\e(B
  34     \e$B$3$l$i$N4D6-JQ?t$r;HMQ$7$F!"%5!<%P$NB>$NItJ,$,$I$N$h$&$JF0:n$r$9$k$+$r\e(B
  35     \e$B7hDj$9$k$3$H$,$G$-$^$9!#\e(B</p>
  36
  37     <p>\e$B$3$N%b%8%e!<%k$,Ds6!$9$k%G%#%l%/%F%#%V$O!"\e(B
  38     \e$B@_Dj%U%!%$%k$K8=$l$k=gHV$KE,MQ$5$l$^$9!#\e(B
  39     \e$B$=$l$r;H$C$F!"<!$NNc$N$h$&$K$h$jJ#;($J@_Dj$r$9$k$3$H$,$G$-$^$9!#\e(B
  40     \e$B$3$l$O!"%V%i%&%6$,\e(B mozilla \e$B$G$O$"$k$1$l$I!"\e(BMSIE \e$B$G$O$J$$$H$-$K\e(B
  41     <code>netscape</code> \e$B$r@_Dj$7$^$9!#\e(B</p>
  42 <example>
  43   BrowserMatch ^Mozilla netscape<br />
  44   BrowserMatch MSIE !netscape<br />
  45 </example>
  46 </summary>
  47
  48 <seealso><a href="../env.html">Apache \e$B$N4D6-JQ?t\e(B</a></seealso>
  49
  50 <directivesynopsis>
  51 <name>BrowserMatch</name>
  52 <description>HTTP User-Agent \e$B$K4p$E$$$F4D6-JQ?t$r@_Dj$9$k\e(B
  53 </description>
  54 <syntax>BrowserMatch <em>regex [!]env-variable</em>[=<em>value</em>]
  55 [[!]<em>env-variable</em>[=<em>value</em>]] ...</syntax>
  56 <contextlist><context>server config</context>
  57 <context>virtual host</context><context>directory</context>
  58 <context>.htaccess</context></contextlist>
  59 <override>FileInfo</override>
  60
  61 <usage>
  62   <p><directive>BrowserMatch</directive> \e$B$O\e(B
  63   <directive module="mod_setenvif">SetEnvIf</directive> \e$B%G%#%l%/%F%#%V$N\e(B
  64   \e$BFCNc$G!"\e(B<code>User-Agent</code> HTTP \e$B%j%/%(%9%H%X%C%@$K4p$E$$$F\e(B
  65   \e$B4D6-JQ?t$r@_Dj$7$^$9!#0J2<$N\e(B 2 \e$B9T$N8z2L$OF1$8$K$J$j$^$9\e(B:</p>
  66
  67 <example>
  68    BrowserMatchNoCase Robot is_a_robot<br />
  69    SetEnvIfNoCase User-Agent Robot is_a_robot<br />
  70 </example>
  71
  72     <p>\e$B$=$NB>$NNc\e(B:</p>
  73 <example>
  74     BrowserMatch ^Mozilla forms jpeg=yes browser=netscape<br />
  75     BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript<br />
  76     BrowserMatch MSIE !javascript<br />
  77 </example>
  78 </usage>
  79 </directivesynopsis>
  80
  81 <directivesynopsis>
  82 <name>BrowserMatchNoCase</name>
  83 <description>HTTP User-Agent \e$B$K4p$E$$$FBgJ8;z>.J8;z$r6hJL$;$:$K\e(B
  84 \e$B4D6-JQ?t$r@_Dj$9$k\e(B</description>
  85 <syntax>BrowserMatchNoCase  <em>regex [!]env-variable</em>[=<em>value</em>]
  86     [[!]<em>env-variable</em>[=<em>value</em>]] ...</syntax>
  87 <contextlist><context>server config</context>
  88 <context>virtual host</context><context>directory</context>
  89 <context>.htaccess</context></contextlist>
  90 <override>FileInfo</override>
  91 <compatibility>Apache 1.2 \e$B0J9_\e(B
  92     (Apache 1.2 \e$B$G$O$3$N%G%#%l%/%F%#%V$O$b$&MQ$$$i$l$F$$$J$$\e(B
  93     mod_browser \e$B%b%8%e!<%k$K$"$j$^$7$?\e(B)</compatibility>
  94
  95 <usage>
  96
  97     <p><directive>BrowserMatchNoCase</directive> \e$B%G%#%l%/%F%#%V$O\e(B
  98     \e$B0UL#E*$K$O\e(B <directive
  99     module="mod_setenvif">BrowserMatch</directive> \e$B%G%#%l%/%F%#%V$H\e(B
 100     \e$BF1$8$G$9!#$?$@$7!"$3$N%G%#%l%/%F%#%V$OBgJ8;z>.J8;z$r6hJL$7$J$$\e(B
 101     \e$B%^%C%A%s%0$r9T$J$$$^$9!#Nc$($P\e(B:</p>
 102
 103 <example>
 104     BrowserMatchNoCase mac platform=macintosh<br />
 105     BrowserMatchNoCase win platform=windows<br />
 106 </example>
 107
 108     <p><directive>BrowserMatch</directive> \e$B%G%#%l%/%F%#%V$H\e(B
 109     <directive>BrowserMatchNoCase</directive> \e$B%G%#%l%/%F%#%V$O\e(B
 110     <directive module="mod_setenvif">SetEnvIf</directive> \e$B%G%#%l%/%F%#%V$H\e(B
 111     <directive
 112     module="mod_setenvif">SetEnvIfNoCase</directive> \e$B%G%#%l%/%F%#%V$N\e(B
 113     \e$BFCNc$G$9!#0J2<$N\e(B 2 \e$B9T$N8z2L$OF1$8$G$9\e(B:</p>
 114
 115 <example>
 116    BrowserMatchNoCase Robot is_a_robot<br />
 117    SetEnvIfNoCase User-Agent Robot is_a_robot<br />
 118 </example>
 119 </usage>
 120 </directivesynopsis>
 121
 122 <directivesynopsis>
 123 <name>SetEnvIf</name>
 124 <description>\e$B%j%/%(%9%H$NB0@-$K4p$E$$$F4D6-JQ?t$r@_Dj$9$k\e(B
 125 </description>
 126 <syntax>SetEnvIf <em>attribute
 127     regex [!]env-variable</em>[=<em>value</em>]
 128     [[!]<em>env-variable</em>[=<em>value</em>]] ...</syntax>
 129 <contextlist><context>server config</context>
 130 <context>virtual host</context><context>directory</context>
 131 <context>.htaccess</context></contextlist>
 132 <override>FileInfo</override>
 133
 134 <usage>
 135     <p><directive>SetEnvIf</directive>
 136     \e$B%G%#%l%/%F%#%V$O!"%j%/%(%9%H$NB0@-$K4p$E$$$F4D6-JQ?t$rDj5A$7$^$9!#\e(B
 137     \e$B:G=i$N0z?t$G;XDj$G$-$k\e(B <em>attribute</em> \e$B$O0J2<$N;0$D$N$I$l$+$G$9\e(B:</p>
 138
 139 <ol>
 140 <li>HTTP \e$B%j%/%(%9%H%X%C%@%U%#!<%k%I\e(B (\e$B>\$7$$>pJs$O\e(B <a
 141     href="http://www.rfc-editor.org/rfc/rfc2616.txt">RFC 2616</a> \e$B$r\e(B
 142     \e$B;2>H$7$F$/$@$5$$\e(B)\e$B!#Nc$($P!"\e(B<code>Host</code>,
 143     <code>User-Agent</code>, <code>Referer</code>,
 144     <code>Accept-Language</code> \e$B$G$9!#%j%/%(%9%H%X%C%@$N=89g$r8=$9$?$a$K\e(B
 145     \e$B@55,I=8=$r;H$&$3$H$b$G$-$^$9!#\e(B</li>
 146
 147 <li>\e$B0J2<$N%j%/%(%9%H$N0lItJ,$N$I$l$+\e(B:
 148
 149     <ul>
 150       <li><code>Remote_Host</code> -
 151       \e$B%j%/%(%9%H$r9T$J$C$F$$$k%/%i%$%"%s%H$N%[%9%HL>\e(B (\e$B$b$7$"$l$P\e(B)</li>
 152
 153       <li><code>Remote_Addr</code> -
 154       \e$B%j%/%(%9%H$r9T$J$C$F$$$k%/%i%$%"%s%H$N\e(B IP \e$B%"%I%l%9\e(B</li>
 155
 156       <li><code>Server_Addr</code> -
 157       \e$B%j%/%(%9%H$r<u$1<h$C$?%5!<%P$N\e(B IP \e$B%"%I%l%9\e(B
 158       (2.0.43 \e$B0J9_$N$_\e(B)</li>
 159
 160       <li><code>Request_Method</code> -
 161       \e$B;HMQ$5$l$F$$$k%a%=%C%IL>\e(B (<code>GET</code>, <code>POST</code>
 162       <em>\e$B$J$I\e(B</em>)</li>
 163
 164       <li><code>Request_Protocol</code> -
 165       \e$B%j%/%(%9%H$,9T$J$o$l$?%W%m%H%3%k$NL>A0$H%P!<%8%g%s\e(B
 166       (<em>\e$BNc$($P\e(B</em>\e$B!"\e(B"HTTP/0.9", "HTTP/1.1" <em>\e$B$J$I!#\e(B</em>)</li>
 167
 168       <li><code>Request_URI</code> -
 169       URL \e$B$N%9%-!<%`$H%[%9%H$N8e$NItJ,\e(B</li>
 170     </ul>
 171 </li>
 172
 173 <li>\e$B%j%/%(%9%H$H4XO"IU$1$i$l$k4D6-JQ?t$N%j%9%H!#$3$l$K$h$j\e(B
 174 <directive>SetEnvIf</directive> \e$B%G%#%l%/%F%#%V$,0JA0$N%^%C%A$N7k2L$r\e(B
 175 \e$B;H$&$3$H$,$G$-$k$h$&$K$J$j$^$9!#$3$NJ}K!$N%F%9%H$G$OA0$NItJ,$K$"$k\e(B
 176 <code>SetEnvIf[NoCase]</code> \e$B$N7k2L$N$_$r;HMQ2DG=$G$9!#!VA0!W$H$O!"\e(B
 177 \e$B$h$j9-$$HO0O$KBP$7$FDj5A$5$l$F$$$k\e(B (\e$B%5!<%PA4BN$N$h$&$K\e(B) \e$B$+!"8=:_$N%G%#%l%/%F%#%V$N\e(B
 178 \e$BHO0O$G$h$jA0$NItJ,$GDj5A$5$l$F$$$k$+!"$H$$$&$3$H$G$9!#\e(B
 179 \e$B4D6-JQ?t$G$"$k2DG=@-$O!"%j%/%(%9%H$NFC@-$KBP$9$k%^%C%A$,B8:_$;$:!"\e(B
 180 <em>attribute</em> \e$B$K@55,I=8=$,;H$o$l$J$+$C$?$H$-$K$N$_9MN8$5$l$^$9!#\e(B</li>
 181 </ol>
 182
 183 <p>\e$BFs$DL\$N0z?t\e(B (<em>regex</em>) \e$B$O\e(B <a
 184 href="http://www.pcre.org/">Perl \e$B8_49$N@55,I=8=\e(B</a>\e$B$G$9!#\e(B
 185 \e$B$3$l$O\e(B POSIX.2 \e$B$N\e(B egrep \e$B7A<0$N@55,I=8=$H;w$F$$$^$9!#\e(B<em>regex</em> \e$B$,\e(B
 186 <em>attribute</em> \e$B$K%^%C%A$9$k>l9g$O!";D$j$N0z?t$,I>2A$5$l$^$9!#\e(B</p>
 187
 188 <p>\e$B;D$j$N0z?t$O@_Dj$9$kJQ?t$NL>A0$G!"@_Dj$5$l$kCM$r;XDj$9$k$3$H$b$G$-$^$9!#\e(B
 189 \e$B$3$l$O!"\e(B</p>
 190
 191     <ol>
 192       <li><code><em>varname</em></code></li>
 193
 194       <li><code>!<em>varname</em></code></li>
 195
 196       <li><code><em>varname</em>=<em>value</em></code></li>
 197     </ol>
 198
 199     <p>\e$B$N$I$l$+$N7A<0$K$J$j$^$9!#\e(B</p>
 200
 201     <p>\e$B:G=i$N7A<0$G$O!"CM$O\e(B "1" \e$B$K@_Dj$5$l$^$9!#\e(B
 202     \e$BFs$DL\$O$b$7CM$,Dj5A$5$l$F$$$l$P$=$l$r<h$j=|$-$^$9!#\e(B
 203     \e$B;0$DL\$OJQ?t$r\e(B <code><em>value</em></code> \e$B$NM?$($i$l$?CM$K@_Dj$7$^$9!#\e(B
 204     2.1 \e$B0J9_$G$O!"\e(B<var>regex</var> \e$BFb$K\e(B <code>$1</code>..<code>$9</code>
 205     \e$B$,B8:_$9$l$P$=$l$rG'<1$7!"\e(B<var>regex</var> \e$B$NBP1~$9$k4]3g8L$G0O$^$l$?ItJ,$G\e(B
 206     \e$BCV49$7$^$9!#\e(B</p>
 207
 208 <example>
 209 <title>\e$BNc\e(B:</title>
 210    SetEnvIf Request_URI "\.gif$" object_is_image=gif<br />
 211    SetEnvIf Request_URI "\.jpg$" object_is_image=jpg<br />
 212    SetEnvIf Request_URI "\.xbm$" object_is_image=xbm<br />
 213         :<br />
 214    SetEnvIf Referer www\.mydomain\.com intra_site_referral<br />
 215         :<br />
 216    SetEnvIf object_is_image xbm XBIT_PROCESSING=1<br />
 217         :<br />
 218    SetEnvIf ^TS*  ^[a-z].*  HAVE_TS<br />
 219 </example>
 220
 221     <p>\e$B=i$a$N;0$D$O%j%/%(%9%H$,2hA|$G$"$k$H$-$K4D6-JQ?t\e(B
 222     <code>object_is_image</code> \e$B$r@_Dj$7$^$9!#;M$DL\$O\e(B
 223     \e$B;2>H85$N%Z!<%8$,%&%'%V%5%$%H\e(B <code>www.mydomain.com</code> \e$B$K$"$k$H$-$K\e(B
 224     <code>intra_site_referral</code> \e$B$r@_Dj$7$^$9!#\e(B</p>
 225
 226     <p>\e$B:G8e$NNc$O!"%j%/%(%9%H$K\e(B "TS" \e$B$G;O$^$j!"CM$,=89g\e(B [a-z] \e$B$N$I$l$+$G\e(B
 227     \e$B;O$^$k%X%C%@$,$"$k$H$-$K\e(B <code>HAVE_TS</code> \e$B$r@_Dj$7$^$9!#\e(B</p>
 228 </usage>
 229
 230 <seealso>\e$BB>$NNc$O!"\e(B<a href="../env.html">Apache \e$B$N4D6-JQ?t\e(B</a>
 231 </seealso>
 232 </directivesynopsis>
 233
 234 <directivesynopsis>
 235 <name>SetEnvIfNoCase</name>
 236 <description>\e$B%j%/%(%9%H$NB0@-$K4p$E$$$FBgJ8;z>.J8;z$r6hJL$;$:$K4D6-JQ?t$r@_Dj$9$k\e(B</description>
 237 <syntax>SetEnvIfNoCase <em>attribute regex
 238         [!]env-variable</em>[=<em>value</em>]
 239     [[!]<em>env-variable</em>[=<em>value</em>]] ...</syntax>
 240 <contextlist><context>server config</context>
 241 <context>virtual host</context><context>directory</context>
 242 <context>.htaccess</context></contextlist>
 243 <override>FileInfo</override>
 244 <compatibility>Apache 1.3 \e$B0J9_\e(B</compatibility>
 245
 246 <usage>
 247
 248     <p><directive>SetEnvIfNoCase</directive> \e$B$O0UL#E*$K$O\e(B
 249     <directive module="mod_setenvif">SetEnvIf</directive> \e$B%G%#%l%/%F%#%V$H\e(B
 250     \e$BF1$8$G$9!#0c$$$O!"@55,I=8=$N%^%C%A%s%0$,BgJ8;z>.J8;z$r6hJL$7$J$$$G\e(B
 251     \e$B9T$J$o$l$k$3$H$G$9!#Nc$($P\e(B:</p>
 252
 253 <example>
 254    SetEnvIfNoCase Host Apache\.Org site=apache
 255 </example>
 256
 257     <p>\e$B$3$l$O\e(B HTTP \e$B%j%/%(%9%H%X%C%@$K%U%#!<%k%I\e(B <code>Host:</code> \e$B$,\e(B
 258     \e$B$"$j!"$=$NCM$,\e(B <code>Apache.Org</code> \e$B$d\e(B <code>apache.org</code>\e$B!"\e(B
 259     \e$B$=$NB>$NBgJ8;z>.J8;z$NAH$_9g$o$;$G$"$C$?$H$-$K\e(B <code>site</code>
 260     \e$B4D6-JQ?t$r\e(B "<code>apache</code>" \e$B$K@_Dj$7$^$9!#\e(B</p>
 261
 262 </usage>
 263 </directivesynopsis>
 264 </modulesynopsis>