mod_setenvif.xml.ko

Apache HTTP Server 是一个功能强大的灵活的与HTTP/1.1相兼容的web服务器.这里给出的是Apache HTTP服务器的源码。

<?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: 151405 -->

<!--
 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_setenvif.xml.meta">

<name>mod_setenvif</name>
<description>夸没狼 己拜俊 蝶扼 券版函荐 汲沥阑 函版茄促</description>
<status>Base</status>
<sourcefile>mod_setenvif.c</sourcefile>
<identifier>setenvif_module</identifier>


<summary>

    <p><module>mod_setenvif</module> 葛碘篮 夸没狼 己拜捞
    沥痹钎泅侥俊 秦寸窍绰瘤 咯何肺 券版函荐甫 汲沥茄促. 辑滚狼
    促弗 何盒捞 青悼阑 搬沥且锭 捞 券版函荐甫 荤侩且 荐 乐促.</p>

    <p>汲沥颇老俊 唱坷绰 鉴辑措肺 瘤矫绢甫 贸府茄促. 弊贰辑
    宏扼快历啊 MSIE啊 酒聪扼 mozilla牢 版快 <code>netscape</code>甫
    汲沥窍绰 酒贰 抗客 鞍捞 咯矾 瘤矫绢甫 窃膊 荤侩且 荐 乐促.</p>

<example>
  BrowserMatch ^Mozilla netscape<br />
  BrowserMatch MSIE !netscape<br />
</example>
</summary>

<seealso><a href="../env.html">酒颇摹狼 券版函荐</a></seealso>

<directivesynopsis>
<name>BrowserMatch</name>
<description>HTTP User-Agent俊 蝶扼 券版函荐甫 汲沥茄促</description>
<syntax>BrowserMatch <em>regex [!]env-variable</em>[=<em>value</em>]
[[!]<em>env-variable</em>[=<em>value</em>]] ...</syntax>
<contextlist><context>server config</context>
<context>virtual host</context><context>directory</context>
<context>.htaccess</context></contextlist>
<override>FileInfo</override>

<usage>
  <p><directive>BrowserMatch</directive>绰 <directive
  module="mod_setenvif">SetEnvIf</directive> 瘤矫绢狼 漂喊茄
  版快肺, HTTP 夸没 庆歹 <code>User-Agent</code>俊 蝶扼 券版函荐甫
  汲沥茄促. 促澜 滴 临篮 鞍促:</p>
<example>
   BrowserMatchNoCase Robot is_a_robot<br /> 
   SetEnvIfNoCase User-Agent Robot is_a_robot<br /> 
</example>

    <p>眠啊 抗力:</p>
<example>
    BrowserMatch ^Mozilla forms jpeg=yes browser=netscape<br />
    BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript<br />
    BrowserMatch MSIE !javascript<br />
</example>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>BrowserMatchNoCase</name>
<description>措家巩磊甫 备喊窍瘤臼绊 User-Agent俊 蝶扼 券版函荐甫
汲沥茄促</description>
<syntax>BrowserMatchNoCase  <em>regex [!]env-variable</em>[=<em>value</em>]
    [[!]<em>env-variable</em>[=<em>value</em>]] ...</syntax>
<contextlist><context>server config</context>
<context>virtual host</context><context>directory</context>
<context>.htaccess</context></contextlist>
<override>FileInfo</override>
<compatibility>酒颇摹 1.2 捞惑 (酒颇摹 1.2俊辑 捞 瘤矫绢绰 泅犁
    绝绢柳 mod_browser 葛碘俊 乐菌促)</compatibility>

<usage>

    <p><directive>BrowserMatchNoCase</directive> 瘤矫绢绰 <directive
    module="mod_setenvif">BrowserMatch</directive> 瘤矫绢客
    狼固惑 鞍促. 弊矾唱 捞 瘤矫绢绰 措家巩磊甫 备喊窍瘤臼绰促.
    抗甫 甸绢:</p>
<example>
    BrowserMatchNoCase mac platform=macintosh<br />
    BrowserMatchNoCase win platform=windows<br />
</example>

    <p><directive>BrowserMatch</directive>客
    <directive>BrowserMatchNoCase</directive> 瘤矫绢绰
    <directive module="mod_setenvif">SetEnvIf</directive>客
    <directive module="mod_setenvif">SetEnvIfNoCase</directive>
    瘤矫绢狼 漂喊茄 版快促. 促澜 林 临篮 鞍促:</p>
<example>
   BrowserMatchNoCase Robot is_a_robot<br />
   SetEnvIfNoCase User-Agent Robot is_a_robot<br />
</example>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>SetEnvIf</name>
<description>夸没狼 己龙俊 蝶扼 券版函荐甫 汲沥茄促</description>
<syntax>SetEnvIf <em>attribute
    regex [!]env-variable</em>[=<em>value</em>]
    [[!]<em>env-variable</em>[=<em>value</em>]] ...</syntax>
<contextlist><context>server config</context>
<context>virtual host</context><context>directory</context>
<context>.htaccess</context></contextlist>
<override>FileInfo</override>

<usage>
    <p><directive>SetEnvIf</directive> 瘤矫绢绰 夸没狼 己龙俊
    蝶扼 券版函荐甫 沥狼茄促. 霉锅掳 酒痹刚飘 <em>attribute</em>绰
    促澜 技啊瘤吝 窍唱促:</p>

<ol>
<li>HTTP 夸没 庆歹 (歹 磊技茄 沥焊绰 <a
    href="http://www.rfc-editor.org/rfc/rfc2616.txt">RFC2616</a>
    曼绊); 抗甫 甸绢: <code>Host</code>, <code>User-Agent</code>,
    <code>Referer</code>, <code>Accept-Language</code>. 沥痹钎泅侥阑
    荤侩窍咯 咯矾 夸没 庆歹甫 瘤莫且 荐 乐促.</li>

<li>夸没狼 促澜 己龙吝 窍唱:
    <ul>
      <li><code>Remote_Host</code> - (乐促搁) 夸没窍绰 努扼捞攫飘狼
      龋胶飘疙</li>

      <li><code>Remote_Addr</code> - 夸没窍绰 努扼捞攫飘狼 IP 林家</li>

      <li><code>Server_Addr</code> - 夸没阑 罐绰 辑滚狼 IP 林家
      (2.0.43 滚傈 捞饶俊父)</li>

      <li><code>Request_Method</code> - 荤侩茄 皋结靛 捞抚
      (<code>GET</code>, <code>POST</code>, <em>殿殿</em>)</li>

      <li><code>Request_Protocol</code> - 夸没狼 橇肺配妮 捞抚苞
      滚傈 (<em>抗甫 甸绢</em>, "HTTP/0.9", "HTTP/1.1", <em>殿.</em>)</li>

      <li><code>Request_URI</code> - HTTP 夸没俊辑 夸没茄 磊盔
      -- 老馆利栏肺 URL俊辑 龙狼巩磊凯阑 力寇茄 胶糯(scheme)苞
      龋胶飘 捞饶 何盒</li>
    </ul>
</li>

<li>夸没苞 楷包等 券版函荐 捞抚. 弊贰辑 <directive>SetEnvIf</directive>
瘤矫绢绰 捞傈 瘤矫绢狼 搬苞甫 八荤且 荐 乐促. 捞傈俊
<code>SetEnvIf[NoCase]</code> 瘤矫绢肺 沥狼茄 券版函荐父阑
八荤且 荐 乐促. '捞傈'捞鄂 (辑滚傈开苞 鞍捞) 歹 承篮 康开 趣篮
瘤矫绢狼 泅犁 康开 捞傈阑 舵茄促. 夸没 己龙捞 酒聪绊 沥痹钎泅侥捞
酒囱 <em>attribute</em>绰 券版函荐肺 秒鞭茄促.</li>
</ol>

<p>滴锅掳 酒痹刚飘绰 (<em>regex</em>) <a
href="http://www.pcre.org/">Perl 龋券 沥痹钎泅侥</a>捞促.
捞绰 POSIX.2 egrep狼 沥痹钎泅侥苞 厚搅窍促. <em>regex</em>啊
<em>attribute</em>俊 措览窍搁 唱赣瘤 酒痹刚飘甫 贸府茄促.</p>

<p>唱赣瘤 酒痹刚飘绰 汲沥且 函荐疙苞 (急琶利牢) 汲沥蔼甸捞促.
促澜苞 鞍篮 屈侥捞促</p>

    <ol>
      <li><code><em>varname</em></code>, 趣篮</li>

      <li><code>!<em>varname</em></code>, 趣篮</li>

      <li><code><em>varname</em>=<em>value</em></code></li>
    </ol>

    <p>霉锅掳 屈怕绰 蔼栏肺 "1"阑 荤侩茄促. 滴锅掳 屈怕绰 函荐啊
    捞固 沥狼等 版快 函荐甫 力芭窍绊, 技锅掳绰 函荐狼 蔼栏肺
    <code><em>value</em></code>甫 汲沥茄促. 酒颇摹 2.0.51何磐
    <var>value</var>俊 乐绰 <code>$1</code>..<code>$9</code>甫
    <var>regex</var>狼 褒龋模 窍困钎泅侥栏肺 措眉茄促.</p>

<example>
<title>抗力:</title>
   SetEnvIf Request_URI "\.gif$" object_is_image=gif<br />
   SetEnvIf Request_URI "\.jpg$" object_is_image=jpg<br />
   SetEnvIf Request_URI "\.xbm$" object_is_image=xbm<br />
        :<br />
   SetEnvIf Referer www\.mydomain\.com intra_site_referral<br />
        :<br />
   SetEnvIf object_is_image xbm XBIT_PROCESSING=1<br />
        :<br />
   SetEnvIf ^TS*  ^[a-z].*  HAVE_TS<br />
</example>

    <p>贸澜 技 临篮 捞固瘤 颇老阑 夸没茄 版快 券版函荐
    <code>object_is_image</code>甫 汲沥茄促. 匙锅掳 临篮 其捞瘤甫
    <code>www.mydomain.com</code> 昆荤捞飘俊辑 曼炼茄 版快
    <code>intra_site_referral</code>阑 汲沥茄促.</p>

    <p>付瘤阜 抗绰 夸没俊 捞抚俊 "TS"肺 矫累窍绊 蔼捞 [a-z]
    吝 窍唱肺 矫累窍绰 庆歹啊 乐绰 版快 券版函荐
    <code>HAVE_TS</code>甫 汲沥茄促.</p>
</usage>

<seealso><a href="../env.html">酒颇摹狼 券版函荐</a>俊 歹 腹篮
抗力啊 乐促.
</seealso>
</directivesynopsis>

<directivesynopsis>
<name>SetEnvIfNoCase</name>
<description>措家巩磊甫 备喊窍瘤臼绊 夸没狼 己龙俊 蝶扼 券版函荐甫
汲沥茄促</description>
<syntax>SetEnvIfNoCase <em>attribute regex 
        [!]env-variable</em>[=<em>value</em>]
    [[!]<em>env-variable</em>[=<em>value</em>]] ...</syntax>
<contextlist><context>server config</context>
<context>virtual host</context><context>directory</context>
<context>.htaccess</context></contextlist>
<override>FileInfo</override>
<compatibility>酒颇摹 1.3 捞饶</compatibility>

<usage>

    <p><directive>SetEnvIfNoCase</directive>绰 狼固惑 <directive
    module="mod_setenvif">SetEnvIf</directive> 瘤矫绢客 鞍瘤父,
    措家巩磊甫 备喊窍瘤臼绊 沥痹钎泅侥阑 茫绰促. 抗甫 甸绢:</p>
<example>
   SetEnvIfNoCase Host Apache\.Org site=apache
</example>

    <p>捞 版快 HTTP 夸没 庆歹 <code>Host:</code>啊
    <code>Apache.Org</code>, <code>apache.org</code> 殿阑 器窃窍搁
    <code>site</code> 券版函荐甫 "<code>apache</code>"肺 汲沥茄促.</p>
</usage>
</directivesynopsis>
</modulesynopsis>