mod_ext_filter.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_ext_filter.xml.meta">

<name>mod_ext_filter</name>
<description>览翠 郴侩阑 寇何 橇肺弊伐栏肺 贸府茄 饶 努扼捞攫飘肺
焊辰促</description>
<status>Extension</status>
<sourcefile>mod_ext_filter.c</sourcefile>
<identifier>ext_filter_module</identifier>

<summary>
    <p><module>mod_ext_filter</module>甫 荤侩窍搁 埃窜窍绊 劳槛茄
    规过栏肺 <a href="../filter.html">鞘磐</a>甫 父甸 荐 乐促.
    钎霖涝仿俊辑 佬绊 钎霖免仿俊 静绰 橇肺弊伐(溜, 蜡葱胶侥
    鞘磐 疙飞绢)阑 酒颇摹 鞘磐肺 荤侩且 荐 乐促. 捞繁 鞘磐绰
    酒颇摹 API肺 静咯瘤绊 酒颇摹 辑滚 橇肺技胶 救俊辑 角青登绰
    鞘磐俊 厚秦 概快 蠢府瘤父, 促澜苞 鞍篮 厘痢捞 乐促:</p>

    <ul>
      <li>橇肺弊贰怪 葛胆捞 概快 埃窜窍促</li>

      <li>橇肺弊伐捞 钎霖涝仿俊辑 佬绊 钎霖免仿俊 镜 荐父 乐促搁
      绢恫 橇肺弊贰怪/胶农赋飘 攫绢扼档 荤侩且 荐 乐促</li>

      <li>捞固 乐绰 橇肺弊伐阑 荐沥绝捞 酒颇摹 鞘磐肺 荤侩且
      荐 乐促</li>
    </ul>

    <p>角力 荤侩窍扁俊绰 己瓷捞 冻绢瘤瘤父,
    <module>mod_ext_filter</module>甫 荤侩窍咯 鞘磐甫 弧府 父甸绢杭
    荐 乐促.</p>

</summary>
<seealso><a href="../filter.html">鞘磐</a></seealso>

<section id="examples"><title>抗力</title>

    <section><title>促弗 type狼 览翠阑 HTML肺 父电促</title>
      <example>
        # mod_ext_filter 瘤矫绢甫 啊瘤绊<br />
        # 寇何 橇肺弊伐 /usr/bin/enscript甫 荤侩窍咯<br />
        # 巩辑颇老苞 text/c 颇老阑 HTML肺 父甸绊 搬苞狼<br />
        # type阑 text/html肺 函版窍绰 鞘磐甫 沥狼茄促<br />
        ExtFilterDefine c-to-html mode=output \<br />
        <indent>
          intype=text/c outtype=text/html \<br />
          cmd="/usr/bin/enscript --color -W html -Ec -o - -"<br />
        </indent>
        <br />
        &lt;Directory "/export/home/trawick/apacheinst/htdocs/c"&gt;<br />
        <indent>
          # 免仿俊 货肺款 鞘磐甫 角青窍绰 core 瘤矫绢<br />
          SetOutputFilter c-to-html<br />
          <br />
          # .c 颇老狼 type阑 text/c肺 父靛绰 mod_mime<br />
          # 瘤矫绢<br />
          AddType text/c .c<br />
          <br />
          # 叼滚弊 荐霖阑 臭咯辑 夸没付促 泅犁 汲沥阑<br />
          # 舅妨林绰 肺弊巩阑 扁废窍绰 mod_ext_filter<br />
          # 瘤矫绢<br />
          ExtFilterOptions DebugLevel=1<br />
        </indent>
        &lt;/Directory&gt;
      </example>
    </section>

    <section><title>content 牢内爹 鞘磐 备泅窍扁</title>
      <p>Note: 酒贰 gzip 抗力绰 窜瘤 汲疙阑 抗肺 电 巴捞促.
      角力 辑厚胶俊 荤侩窍妨搁 <module>mod_deflate</module>甫
      曼绊窍辨 官鄂促.</p>

      <example>
        # 寇何 鞘磐甫 沥狼窍绰 mod_ext_filter 瘤矫绢<br />
        ExtFilterDefine gzip mode=output cmd=/bin/gzip<br />
        <br />
        &lt;Location /gzipped&gt;<br />
        <indent>
          # 免仿且锭 gzip 鞘磐甫 角青窍绰 core 瘤矫绢<br />
          SetOutputFilter gzip<br />
          <br />
          # "Content-Encoding: gzip" 庆歹甫 眠啊窍绰<br />
          # mod_header 瘤矫绢<br />
          Header set Content-Encoding gzip<br />
        </indent>
        &lt;/Location&gt;
      </example>
    </section>

    <section><title>辑滚甫 蠢府霸 窍扁</title>
      <example>
        # cat栏肺 葛电 郴侩阑 烹苞窍绰 鞘磐甫 沥狼窍绰<br />
        # mod_ext_filter 瘤矫绢; cat篮 酒公巴档 荐沥窍瘤<br />
        # 臼绰促; 窜瘤 贸府版肺甫 辨霸 窍咯 磊盔阑 歹 家葛茄促<br />
        ExtFilterDefine slowdown mode=output cmd=/bin/cat \<br />
        <indent>
          preservescontentlength<br />
        </indent>
        <br />
        &lt;Location /&gt;<br />
        <indent>
          # 免仿且锭 slowdown 鞘磐甫 咯矾锅 角青窍绰 core 瘤矫绢<br />
          #<br />
          SetOutputFilter slowdown;slowdown;slowdown<br />
        </indent>
        &lt;/Location&gt;
      </example>
    </section>

    <section><title>sed甫 荤侩窍咯 览翠俊辑 臂阑 措眉窍扁</title>
      <example>
        # 览翠俊辑 臂阑 措眉窍绰 鞘磐甫 沥狼窍绰<br />
        # mod_ext_filter 瘤矫绢<br />
        #<br />
        ExtFilterDefine fixtext mode=output intype=text/html \<br />
        <indent>
          cmd="/bin/sed s/verdana/arial/g"<br />
        </indent>
        <br />
        &lt;Location /&gt;<br />
        <indent>
          # 免仿且锭 fixtext 鞘磐甫 角青窍绰 core 瘤矫绢<br />
          SetOutputFilter fixtext<br />
        </indent>
        &lt;/Location&gt;
      </example>
    </section>

    <section><title>促弗 鞘磐甫 眠利窍扁</title>
      <example>
        # 拘绵 巩力啊 乐绰 漂沥 努扼捞攫飘(IP 192.168.1.31)俊<br />
        # 措秦 mod_deflate啊 佬绊 静绰 磊丰甫 眠利茄促.<br />
        # 捞 鞘磐绰 mod_deflate肺 焊郴扁 傈 磊丰甫 眠利茄促.<br />
        ExtFilterDefine tracebefore \<br />
        <indent>
          cmd="/bin/tracefilter.pl /tmp/tracebefore" \<br />
          EnableEnv=trace_this_client<br />
        </indent>
        <br />
        # 捞 鞘磐绰 mod_deflate俊辑 唱坷绰 磊丰甫 眠利茄促.<br />
        # ftype 颇扼固磐甫 荤侩窍瘤臼绰 版快, 扁夯 鞘磐屈<br />
        # AP_FTYPE_RESOURCE绰 鞘磐 鉴辑甫 mod_deflate *捞傈俊*<br />
        # 敌促. AP_FTYPE_CONTENT_SET 焊促 炼陛 臭篮 箭磊蔼阑<br />
        # 瘤沥窍搁 mod_deflate 捞饶俊 角青茄促.<br />
        ExtFilterDefine traceafter \<br />
        <indent>
          cmd="/bin/tracefilter.pl /tmp/traceafter" \<br />
          EnableEnv=trace_this_client ftype=21<br />
        </indent>
        <br />
        &lt;Directory /usr/local/docs&gt;<br />
        <indent>
          SetEnvIf Remote_Addr 192.168.1.31 trace_this_client<br />
          SetOutputFilter tracebefore;deflate;traceafter<br />
        </indent>
        &lt;/Directory&gt;
      </example>

      <example><title>促澜篮 磊丰甫 眠利窍绰 鞘磐捞促:</title>
        #!/usr/local/bin/perl -w<br />
        use strict;<br />
        <br />
        open(SAVE, "&gt;$ARGV[0]")<br />
        <indent>
          or die "can't open $ARGV[0]: $?";<br />
        </indent>
        <br />
        while (&lt;STDIN&gt;) {<br />
        <indent>
          print SAVE $_;<br />
          print $_;<br />
        </indent>
        }<br />
        <br />
        close(SAVE);
      </example>
    </section>
</section> <!-- /Examples -->

<directivesynopsis>
<name>ExtFilterDefine</name>
<description>寇何 鞘磐甫 沥狼茄促</description>
<syntax>ExtFilterDefine <var>filtername</var> <var>parameters</var></syntax>
<contextlist><context>server config</context></contextlist>

<usage>
    <p><directive>ExtFilterDefine</directive> 瘤矫绢绰 寇何
    鞘磐狼 己龙苞 角青且 橇肺弊伐, 酒痹刚飘甫 沥狼茄促.</p>

    <p><var>filtername</var>篮 沥狼且 鞘磐 捞抚阑 瘤沥茄促.
    捞 捞抚阑 SetOutputFilter 瘤矫绢俊辑 荤侩茄促. 殿废茄 葛电
    鞘磐甸埃俊 捞抚捞 般摹搁 救等促. <em>泅犁 鞘磐殿废 API绰
    坷幅甫 焊绊窍瘤 臼绰促. 弊贰辑 荤侩磊绰 捞抚捞 般摹绰 巩力甫
    舅瘤 给茄促.</em></p>

    <p>角青且 寇何 疙飞绢客 促弗 己龙阑 沥狼窍绰 唱赣瘤 酒痹刚飘绰
    绢恫 鉴辑肺 唱客档 啊瓷窍促. 窜, <code>cmd=</code> 颇扼固磐绰
    馆靛矫 鞘夸窍促. 荤侩且 荐 乐绰 颇扼固磐绰 促澜苞 鞍促:</p>

    <dl>
      <dt><code>cmd=<var>cmdline</var></code></dt>

      <dd><code>cmd=</code> 虐况靛绰 角青且 寇何 疙飞绢甫 瘤沥茄促.
      橇肺弊伐疙 第俊 酒痹刚飘啊 乐促搁 疙飞青阑 街蝶咳钎肺
      弓绢具 茄促 (<em>抗甫 甸绢</em>,
      <code>cmd="<var>/bin/mypgm</var> <var>arg1</var>
      <var>arg2</var>"</code>). 僵阑 芭摹瘤臼绊 流立 橇肺弊伐阑
      角青窍扁锭巩俊 老馆利牢 僵 蝶咳钎绰 鞘夸绝促. 橇肺弊伐
      酒痹刚飘甸篮 傍归栏肺 备盒茄促. 橇肺弊伐 酒痹刚飘俊 傍归捞
      乐促搁 傍归 菊俊 归浇贰浆肺 荤侩秦具 茄促. 归浇贰浆啊
      酒痹刚飘狼 老何扼搁 归浇贰浆甫 滴锅 荤侩秦具 茄促. 橇肺弊伐阑
      角青且锭 钎霖 CGI 券版函荐客 眠啊肺 DOCUMENT_URI,
      DOCUMENT_PATH_INFO, QUERY_STRING_UNESCAPED 函荐甫 汲沥茄促.</dd>

      <dt><code>mode=<var>mode</var></code></dt>

      <dd><code>mode</code>绰 泅犁 (扁夯蔼牢) <code>output</code>父
      啊瓷窍促. 固贰俊绰 <code>mode=input</code>阑 荤侩窍咯
      夸没 郴侩阑 贸府窍绰 鞘磐甫 瘤沥且 荐 乐阑 巴捞促.</dd>

      <dt><code>intype=<var>imt</var></code></dt>

      <dd>捞 颇扼固磐绰 鞘磐肺 贸府且 巩辑狼 牢磐齿 media
      type(<em>溜</em>, MIME type)阑 瘤沥茄促. 扁夯利栏肺 葛电
      巩辑甫 鞘磐肺 贸府茄促. <code>intype=</code>阑 瘤沥窍搁
      促弗 type狼 巩辑绰 鞘磐肺 贸府窍瘤 臼绰促.</dd>

      <dt><code>outtype=<var>imt</var></code></dt>

      <dd>捞 颇扼固磐绰 鞘磐肺 贸府茄 巩辑狼 牢磐齿 media
      type(<em>溜</em>, MIME type)阑 瘤沥茄促. 鞘磐贸府 累诀吝俊
      牢磐齿 media type阑 函版且锭 蜡侩窍促. 扁夯利栏肺, 牢磐齿
      media type篮 函窍瘤 臼绰促.</dd>

      <dt><code>PreservesContentLength</code></dt>

      <dd><code>PreservesContentLength</code> 虐况靛绰 鞘磐啊
      content length甫 蜡瘤窍档废 茄促. 措何盒狼 鞘磐啊 content
      length甫 函版窍骨肺 捞 虐况靛绰 扁夯蔼捞 酒聪促. 鞘磐啊
      辨捞甫 蜡瘤且锭父 捞 虐况靛甫 荤侩秦具 茄促.</dd>

      <dt><code>ftype=<var>filtertype</var></code></dt>

      <dd>捞 颇扼固磐绰 鞘磐 辆幅俊 措茄 箭磊蔼阑 瘤沥茄促.
      措何盒狼 版快 扁夯蔼牢 AP_FTYPE_RESOURCE啊 利寸窍促.
      鞘磐甫 角青窍绰 鉴辑啊 磊盔鞘磐客 崔扼具窍绰 版快 捞
      颇扼固磐啊 鞘夸窍促. 利寸茄 蔼阑 舅妨搁 util_filter.h俊
      乐绰 AP_FTYPE_* 沥狼甫 曼绊窍扼.</dd>

      <dt><code>disableenv=<var>env</var></code></dt>

      <dd>捞 颇扼固磐肺 汲沥茄 券版函荐啊 沥狼登菌促搁 鞘磐甫
      荤侩窍瘤 臼绰促.</dd>

      <dt><code>enableenv=<var>env</var></code></dt>

      <dd>捞 颇扼固磐肺 汲沥茄 券版函荐啊 沥狼等 版快 鞘磐甫
      荤侩茄促.</dd>
    </dl>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>ExtFilterOptions</name>
<description><module>mod_ext_filter</module> 可记阑 汲沥茄促</description>
<syntax>ExtFilterOptions <var>option</var> [<var>option</var>] ...</syntax>
<default>ExtFilterOptions DebugLevel=0 NoLogStderr</default>
<contextlist><context>directory</context></contextlist>

<usage>
    <p><directive>ExtFilterOptions</directive> 瘤矫绢绰
    <module>mod_ext_filter</module>狼 漂喊茄 贸府可记阑 瘤沥茄促.
    <var>Option</var>篮 促澜吝 窍唱促.</p>

    <dl>
      <dt><code>DebugLevel=<var>n</var></code></dt>

      <dd>
        <code>DebugLevel</code> 虐况靛绰
        <module>mod_ext_filter</module>啊 扁废窍绰 叼滚弊 巩备
        荐霖阑 沥茄促. 扁夯蔼篮 叼滚弊巩阑 扁废窍瘤 臼绰促.
        捞绰 <code>DebugLevel=0</code>苞 鞍促. 臭篮 箭磊甫
        荤侩且荐废, 歹 腹篮 叼滚弊巩捞 扁废登绊 辑滚 己瓷捞
        冻绢柳促. 箭磊蔼狼 角力 狼固绰 <code>mod_ext_filter.c</code>
        菊何盒俊 乐绰 DBGLVL_ 惑荐 沥狼俊 汲疙登乐促.

        <p>林狼: 鞘磐 肺弊甫 扁废窍妨搁 core 瘤矫绢 <directive
        module="core">LogLevel</directive>阑 荤侩窍咯 叼滚弊巩阑
        酒颇摹 坷幅肺弊俊 扁废秦具 茄促.</p>
      </dd>

      <dt><code>LogStderr | NoLogStderr</code></dt>

      <dd><code>LogStderr</code> 虐况靛绰 寇何 鞘磐 橇肺弊伐捞
      钎霖坷幅肺 免仿窍绰 巩备甫 酒颇摹 坷幅肺弊俊 扁废茄促.
      <code>NoLogStderr</code>绰 捞 扁瓷阑 窍瘤 臼绰促.</dd>
    </dl>

    <example><title>抗力</title>
      ExtFilterOptions LogStderr DebugLevel=0
    </example>

    <p>困狼 汲沥阑 荤侩窍搁 鞘磐啊 钎霖坷幅肺 免仿窍绰 巩备甫
    酒颇摹 坷幅肺弊俊 扁废窍绊, <module>mod_ext_filter</module>绰
    磊眉 叼滚弊巩阑 扁废窍瘤 臼绰促. </p>
</usage>
</directivesynopsis>

</modulesynopsis>