mod_isapi.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 2002-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_isapi.xml.meta">

<name>mod_isapi</name>
<description>Windows侩 酒颇摹俊辑 ISAPI Extension 荤侩</description>
<status>Base</status>
<sourcefile>mod_isapi.c</sourcefile>
<identifier>isapi_module</identifier>
<compatibility>Win32 only</compatibility>

<summary>
    <p>捞 葛碘篮 Internet Server extension API甫 备泅茄促. 弊贰辑
    力距篮 乐瘤父 Windows侩 酒颇摹俊辑 Internet Server extension阑
    (<em>溜,</em> ISAPI .dll 葛碘) 荤侩且 荐 乐促.</p>

    <p>ISAPI extension 葛碘(.dll 颇老)篮 力伙磊啊 累己茄促.
    Apache Group捞 捞甸 葛碘阑 父甸瘤 臼疽栏哥, 瘤盔档 窍瘤
    臼绰促. ISAPI extension 荤侩俊 包茄 巩力绰 ISAPI 力累磊俊霸
    流立 楷遏窍辨 官鄂促. <strong>力惯 捞繁 巩力甫 酒颇摹
    皋老傅府胶飘唱 滚弊焊绊 其捞瘤俊 棵府瘤 <em>付扼</em>.</strong></p>
</summary>

<section id="usage"><title>荤侩过</title>

    <p>辑滚汲沥颇老俊辑 <directive
    module="mod_mime">AddHandler</directive> 瘤矫绢甫 荤侩窍咯
    ISAPI 颇老 犬厘磊客 <code>isapi-isa</code> 勤甸矾甫 楷搬茄促.
    .dll 颇老阑 ISAPI extension栏肺 贸府窍妨搁 httpd.conf 颇老俊
    促澜苞 鞍捞 眠啊茄促.</p>
    <example>
        AddHandler isapi-isa .dll
    </example>

    <p>酒颇摹 辑滚绰 夸没茄 葛碘阑 皋葛府俊 拌加 笛 荐 绝促.
    弊矾唱 httpd.conf俊辑 促澜苞 鞍篮 汲沥栏肺 漂沥 葛碘阑 固府
    佬绢甸老 荐绰 乐促.</p>
    <example>
        ISAPICacheFile c:/WebWork/Scripts/ISAPI/mytest.dll
    </example>

    <p>ISAPI extension阑 固府 佬绢甸捞带瘤 固府 佬绢甸捞瘤 臼带瘤
    包拌绝捞 ISAPI extension篮 CGI 胶农赋飘客 悼老茄 鼻茄苞
    力距阑 蝶弗促. 溜, ISAPI .dll 颇老捞 乐绰 叼泛配府俊 <directive
    module="core">Options</directive> <code>ExecCGI</code>啊
    鞘夸窍促.</p>

    <p><module>mod_isapi</module>狼 ISAPI 瘤盔俊 措茄 磊技茄
    郴侩苞 汲疙篮 <a href="#notes">眠啊 汲疙</a>苞 <a
    href="#journal">俺惯磊 沥焊</a>甫 曼绊窍扼.</p>
</section>

<section id="notes"><title>眠啊 汲疙</title>

    <p>酒颇摹 ISAPI 备泅篮 厚悼扁 涝免仿俊 措茄 "付捞农肺家橇飘
    漂蜡狼" 犬厘扁瓷阑 力寇茄 ISAPI 2.0 痹距阑 葛滴 父练茄促.
    酒颇摹狼 涝免仿 备炼肺绰 ISAPI啊 荤侩且 荐 乐绰 规侥栏肺
    厚悼扁 涝免仿阑 且 荐 绝促. ISA啊 厚悼扁 涝免仿苞 鞍捞 瘤盔窍瘤
    臼绰 扁瓷阑 荤侩窍妨 茄促搁, 叼滚彪俊 档框阑 林扁困秦 坷幅
    肺弊俊 扁废阑 巢变促. 肺弊啊 概快 目龙 荐 乐扁锭巩俊
    <code>ISAPILogNotSupported Off</code> 瘤矫绢甫 荤侩窍搁
    肺弊俊 扁废窍瘤 臼绰促.</p>

    <p>Microsoft IIS客 鞍篮 辑滚绰 ISAPI extension阑 皋葛府肺
    佬绢甸咯辑 皋葛府 荤侩樊捞 概快 腹瘤 臼芭唱 漂喊洒 汲沥窍瘤
    臼绰茄 弊措肺 皋葛府俊 敌促. 酒颇摹绰 泅犁 <directive
    module="mod_isapi">ISAPICacheFile</directive> 瘤矫绢甫 荤侩窍瘤
    臼绰促搁 夸没阑 罐阑锭付促 ISAPI extension阑 皋葛府俊 佬绢甸捞绊
    滚赴促. 厚瓤啦利捞瘤父, 酒颇摹狼 皋葛府 备炼惑 捞巴捞 啊厘
    瓤啦利牢 规过捞促. 咯矾 ISAPI 葛碘捞 酒颇摹 辑滚客 距埃
    龋券捞 救嘎扁锭巩俊 辑滚狼 救沥己阑 困秦 葛碘阑 皋葛府俊辑
    滚赴促.</p>

    <p>肚, 酒颇摹绰 ISAPI Extension阑 瘤盔窍瘤父, <strong>ISAPI
    Filter甫 瘤盔窍瘤 臼澜阑</strong> 扁撅窍扼. 唱吝俊 鞘磐甫
    瘤盔且 荐 乐瘤父, 泅犁绰 拌裙捞 绝促.</p>
</section>

<section id="journal"><title>俺惯磊 沥焊</title>

    <p>酒颇摹 2.0 <module>mod_isapi</module> 葛碘阑 橇肺弊贰怪茄促搁,
    <code>ServerSupportFunction</code> 龋免阑 促澜 瘤矫绢肺
    力茄秦具 茄促.</p>

    <dl>
      <dt><code>HSE_REQ_SEND_URL_REDIRECT_RESP</code></dt>
      <dd>荤侩磊甫 促弗 困摹肺 府促捞泛记茄促.<br />
      肯傈茄 URL阑 荤侩秦具 茄促 (<em>抗甫 甸绢,</em>
      <code>http://server/location</code>).</dd>

      <dt><code>HSE_REQ_SEND_URL</code></dt>
      <dd>荤侩磊甫 促弗 困摹肺 府促捞泛记茄促.<br />
      肯傈茄 URL捞 酒聪哥, 橇肺配妮苞 辑滚疙阑 逞辨 荐 绝促
      (<em>抗甫 甸绢,</em> <code>/location</code>鞍篮 巴父 啊瓷).<br />
      宏扼快历啊 酒聪扼 辑滚啊 府促捞泛记阑 贸府茄促.<br />
      <note type="warning"><title>版绊</title>
        <p>弥辟 巩辑甫 焊搁 Microsoft啊 滴 <code>HSE_REQ_SEND_URL</code>
        扁瓷埃狼 瞒捞甫 绝矩 巴贸烦 焊牢促. 酒颇摹绰 拌加 捞
        笛狼 酒痹刚飘 炼扒苞 青悼阑 促福霸 贸府且 巴捞促.</p>
      </note></dd>

      <dt><code>HSE_REQ_SEND_RESPONSE_HEADER</code></dt>
      <dd>headers 巩磊凯 酒痹刚飘俊 后临捞 (临官厕巩磊啊 滴锅
      楷加) 乐促搁 酒颇摹绰 庆歹 促澜 郴侩阑 览翠 郴侩栏肺 荤侩茄促.
      headers 酒痹刚飘啊 NULL肺 场唱扁锭巩俊, 览翠 郴侩俊 NULL阑
      荤侩且 荐 绝促.</dd>

      <dt><code>HSE_REQ_DONE_WITH_SESSION</code></dt>
      <dd>ISAPI啊 贸府甫 付摹搁 技记捞 场唱扁锭巩俊 酒颇摹绰
      酒公 老档 窍瘤 臼绰促.</dd>

      <dt><code>HSE_REQ_MAP_URL_TO_PATH</code></dt>
      <dd>酒颇摹绰 啊惑 捞抚阑 拱府利(角力) 捞抚栏肺 函券茄促.</dd>

      <dt><code>HSE_APPEND_LOG_PARAMETER</code></dt>
      <dd>
        巩备甫 酒贰 肺弊吝 茄镑俊 巢变促.

        <ul>
          <li><directive module="mod_log_config">CustomLog</directive>
          瘤矫绢狼 <code>\"%{isapi-parameter}n\"</code> 亲格俊</li>

          <li><directive module="mod_isapi">ISAPIAppendLogToQuery</directive>
          <code>On</code> 瘤矫绢甫 荤侩窍咯 <code>%q</code>
          肺弊 亲格俊</li>

          <li><directive
          module="mod_isapi">ISAPIAppendLogToErrors</directive>
          <code>On</code> 瘤矫绢甫 荤侩窍咯 坷幅 肺弊俊</li>
        </ul>

        <p>霉锅掳肺 唱柯 <code>%{isapi-parameter}n</code> 亲格篮
        攫力唱 荤侩且 荐 乐栏哥 鼻厘茄促.</p>
      </dd>

      <dt><code>HSE_REQ_IS_KEEP_CONN</code></dt>
      <dd>蛆惑等 Keep-Alive 惑怕甫 馆券茄促.</dd>

      <dt><code>HSE_REQ_SEND_RESPONSE_HEADER_EX</code></dt>
      <dd><code>fKeepConn</code> 可记阑 公矫窍绰 巴阑 力寇窍绊绰
      巩辑俊 唱柯单肺 悼累茄促.</dd>

      <dt><code>HSE_REQ_IS_CONNECTED</code></dt>
      <dd>夸没捞 吝埃俊 谗绢脸促搁 false甫 馆券茄促.</dd>
    </dl>

    <p>瘤盔窍瘤 臼绰 <code>ServerSupportFunction</code> 龋免阑
    窍搁 酒颇摹绰 <code>FALSE</code>甫 馆券窍绊
    <code>GetLastError</code> 蔼阑
    <code>ERROR_INVALID_PARAMETER</code>肺 汲沥茄促.</p>

    <p><code>ReadClient</code>绰 (<directive
    module="mod_isapi">ISAPIReadAheadBuffer</directive>肺 沥狼茄)
    檬扁滚欺农扁甫 逞绢急 夸没 郴侩阑 啊廉柯促.
    <directive>ISAPIReadAheadBuffer</directive> 汲沥 (ISAPI
    勤甸矾甫 何福扁傈 滚欺狼 官捞飘荐) 焊促 陋篮 夸没篮 extension阑
    何甫锭 傈何 傈崔等促. 夸没捞 辨搁, ISAPI extension篮
    <code>ReadClient</code>肺 唱赣瘤 夸没 郴侩阑 啊廉客具 茄促.</p>

    <p><code>WriteClient</code>甫 瘤盔窍瘤父,
    <code>HSE_IO_SYNC</code> 可记父 荤侩窍芭唱 (<code>0</code>
    蔼) 酒公 可记档 荤侩窍瘤 臼酒具 茄促. 促弗
    <code>WriteClient</code> 夸没篮 <code>FALSE</code>甫 馆券窍哥
    角菩窍绊, <code>GetLastError</code> 蔼篮
    <code>ERROR_INVALID_PARAMETER</code>啊 等促.</p>

    <p><code>GetServerVariable</code>篮 瘤盔窍瘤父, (促弗 辑滚俊辑
    沥狼窍绰) 犬厘 辑滚函荐绰 绝促.
    <code>GetServerVariable</code>俊辑 葛电 老馆利牢 酒颇摹
    CGI 券版函荐客 <code>ALL_HTTP</code>, <code>ALL_RAW</code>
    蔼阑 荤侩且 荐 乐促.</p>

    <p>酒颇摹 2.0 <module>mod_isapi</module>绰 捞饶 ISAPI 痹距俊
    唱柯 眠啊 扁瓷阑 瘤盔窍绊, 厚悼扁 涝免仿苞
    <code>TransmitFile</code> 扁瓷阑 炼陛 蠕郴辰促. 肚, ISAPI
    .dll阑 固府 佬绢甸咯辑 己瓷阑 臭捞绰 酒颇摹 1.3
    <code>mod_isapi</code>俊绰 绝绰 扁瓷阑 瘤盔茄促.</p>
</section>

<directivesynopsis>
<name>ISAPICacheFile</name>
<description>辑滚啊 矫累且锭 皋葛府肺 佬绢甸老 ISAPI .dll 颇老甸</description>
<syntax>ISAPICacheFile <var>file-path</var> [<var>file-path</var>]
...</syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>

<usage>
    <p>酒颇摹 辑滚啊 矫累且锭 皋葛府肺 佬绢甸咯辑 辑滚甫 辆丰且锭鳖瘤
    皋葛府俊 巢酒乐阑 颇老疙阑 傍归栏肺 备盒窍咯 瘤沥茄促. 捞
    瘤矫绢绰 ISAPI .dll 颇老喊肺 咯矾锅 荤侩且 荐 乐促. 颇老狼
    傈眉 版肺甫 利绰促. 例措 版肺啊 酒聪搁 <directive
    module="core">ServerRoot</directive>俊 惑措 版肺肺 罐酒甸牢促.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>ISAPIReadAheadBuffer</name>
<description>ISAPI extension狼 固府佬扁滚欺(read ahead buffer)
农扁</description>
<syntax>ISAPIReadAheadBuffer <var>size</var></syntax>
<default>ISAPIReadAheadBuffer 49152</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>FileInfo</override>

<usage>
    <p>ISAPI extension阑 贸澜 龋免且锭 固府佬扁滚欺狼 弥措 农扁甫
    瘤沥茄促. (捞 农扁焊促 奴) 唱赣瘤 磊丰绰 <code>ReadClient</code>
    妮归阑 荤侩窍咯 佬绢具 茄促. 绢恫 ISAPI extension篮
    <code>ReadClient</code> 扁瓷阑 瘤盔窍瘤 臼绰促. 捞 版快
    ISAPI extension 力累磊俊霸 巩狼窍扼.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>ISAPILogNotSupported</name>
<description>ISAPI extension捞 瘤盔窍瘤 臼绰 扁瓷阑 夸没窍搁
肺弊俊 扁废茄促</description>
<syntax>ISAPILogNotSupported on|off</syntax>
<default>ISAPILogNotSupported off</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>FileInfo</override>

<usage>
    <p>ISAPI extension捞 瘤盔窍瘤 臼绰 扁瓷阑 夸没窍搁 辑滚
    坷幅 肺弊俊 扁废茄促. 唱吝俊 包府磊啊 巩力甫 眠利窍绰单
    档框捞 等促. 盔窍绰 葛电 ISAPI 葛碘捞 沥惑利栏肺 悼累窍搁
    促矫 off肺 登倒妨具 茄促.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>ISAPIAppendLogToErrors</name>
<description>ISAPI exntension狼 <code>HSE_APPEND_LOG_PARAMETER</code>
夸没阑 坷幅 肺弊俊 扁废茄促</description>
<syntax>ISAPIAppendLogToErrors on|off</syntax>
<default>ISAPIAppendLogToErrors off</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>FileInfo</override>

<usage>
    <p>ISAPI exntension狼 <code>HSE_APPEND_LOG_PARAMETER</code>
    夸没阑 坷幅 肺弊俊 扁废茄促.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>ISAPIAppendLogToQuery</name>
<description>ISAPI exntension狼 <code>HSE_APPEND_LOG_PARAMETER</code>
夸没阑 龙狼巩磊凯俊 扁废茄促</description>
<syntax>ISAPIAppendLogToQuery on|off</syntax>
<default>ISAPIAppendLogToQuery on</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>FileInfo</override>

<usage>
    <p>ISAPI exntension狼 <code>HSE_APPEND_LOG_PARAMETER</code>
    夸没阑 龙狼巩磊凯俊 扁废茄促 (<directive
    module="mod_log_config">CustomLog</directive> <code>%q</code>
    亲格俊 怠嘿牢促).</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>ISAPIFakeAsync</name>
<description>厚悼扁 ISAPI 妮归阑 瘤盔窍绰 么茄促</description>
<syntax>ISAPIFakeAsync on|off</syntax>
<default>ISAPIFakeAsync off</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>FileInfo</override>

<usage>
    <p>on栏肺 汲沥窍搁 厚悼扁 ISAPI 妮归 瘤盔阑 蠕郴辰促.</p>
</usage>
</directivesynopsis>

</modulesynopsis>