📄 mod_isapi.html.en
字号:
<?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX --><title>mod_isapi - Apache HTTP Server</title><link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /><link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /><link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link href="../images/favicon.ico" rel="shortcut icon" /></head><body><div id="page-header"><p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p><p class="apache">Apache HTTP Server Version 2.0</p><img alt="" src="../images/feather.gif" /></div><div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div><div id="path"><a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.0</a> > <a href="./">Modules</a></div><div id="page-content"><div id="preamble"><h1>Apache Module mod_isapi</h1><div class="toplang"><p><span>Available Languages: </span><a href="../en/mod/mod_isapi.html" title="English"> en </a> |<a href="../ko/mod/mod_isapi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p></div><table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>ISAPI Extensions within Apache for Windows</td></tr><tr><th><a href="module-dict.html#Status">Status:</a></th><td>Base</td></tr><tr><th><a href="module-dict.html#ModuleIdentifier">Module營dentifier:</a></th><td>isapi_module</td></tr><tr><th><a href="module-dict.html#SourceFile">Source燜ile:</a></th><td>mod_isapi.c</td></tr><tr><th><a href="module-dict.html#Compatibility">Compatibility:</a></th><td>Win32 only</td></tr></table><h3>Summary</h3> <p>This module implements the Internet Server extension API. It allows Internet Server extensions (<em>e.g.</em> ISAPI .dll modules) to be served by Apache for Windows, subject to the noted restrictions.</p> <p>ISAPI extension modules (.dll files) are written by third parties. The Apache Group does not author these modules, so we provide no support for them. Please contact the ISAPI's author directly if you are experiencing problems running their ISAPI extension. <strong>Please <em>do not</em> post such problems to Apache's lists or bug reporting pages.</strong></p></div><div id="quickview"><h3 class="directives">Directives</h3><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#isapiappendlogtoerrors">ISAPIAppendLogToErrors</a></li><li><img alt="" src="../images/down.gif" /> <a href="#isapiappendlogtoquery">ISAPIAppendLogToQuery</a></li><li><img alt="" src="../images/down.gif" /> <a href="#isapicachefile">ISAPICacheFile</a></li><li><img alt="" src="../images/down.gif" /> <a href="#isapifakeasync">ISAPIFakeAsync</a></li><li><img alt="" src="../images/down.gif" /> <a href="#isapilognotsupported">ISAPILogNotSupported</a></li><li><img alt="" src="../images/down.gif" /> <a href="#isapireadaheadbuffer">ISAPIReadAheadBuffer</a></li></ul><h3>Topics</h3><ul id="topics"><li><img alt="" src="../images/down.gif" /> <a href="#usage">Usage</a></li><li><img alt="" src="../images/down.gif" /> <a href="#notes">Additional Notes</a></li><li><img alt="" src="../images/down.gif" /> <a href="#journal">Programmer's Journal</a></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="section"><h2><a name="usage" id="usage">Usage</a></h2> <p>In the server configuration file, use the <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> directive to associate ISAPI files with the <code>isapi-handler</code> handler, and map it to them with their file extensions. To enable any .dll file to be processed as an ISAPI extension, edit the httpd.conf file and add the following line:</p> <div class="example"><p><code> AddHandler isapi-handler .dll </code></p></div> <div class="note">In versions of the Apache server prior to 2.0.37, use <code>isapi-isa</code> instead of <code>isapi-handler</code>. The new handler name is not available prior to version 2.0.37. For compatibility, configurations may continue using <code>isapi-isa</code> through all versions of Apache prior to 2.3.0.</div> <p>There is no capability within the Apache server to leave a requested module loaded. However, you may preload and keep a specific module loaded by using the following syntax in your httpd.conf:</p> <div class="example"><p><code> ISAPICacheFile c:/WebWork/Scripts/ISAPI/mytest.dll </code></p></div> <p>Whether or not you have preloaded an ISAPI extension, all ISAPI extensions are governed by the same permissions and restrictions as CGI scripts. That is, <code class="directive"><a href="../mod/core.html#options">Options</a></code> <code>ExecCGI</code> must be set for the directory that contains the ISAPI .dll file.</p> <p>Review the <a href="#notes">Additional Notes</a> and the <a href="#journal">Programmer's Journal</a> for additional details and clarification of the specific ISAPI support offered by <code class="module"><a href="../mod/mod_isapi.html">mod_isapi</a></code>.</p></div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="section"><h2><a name="notes" id="notes">Additional Notes</a></h2> <p>Apache's ISAPI implementation conforms to all of the ISAPI 2.0 specification, except for some "Microsoft-specific" extensions dealing with asynchronous I/O. Apache's I/O model does not allow asynchronous reading and writing in a manner that the ISAPI could access. If an ISA tries to access unsupported features, including async I/O, a message is placed in the error log to help with debugging. Since these messages can become a flood, the directive <code>ISAPILogNotSupported Off</code> exists to quiet this noise.</p> <p>Some servers, like Microsoft IIS, load the ISAPI extension into the server and keep it loaded until memory usage is too high, or unless configuration options are specified. Apache currently loads and unloads the ISAPI extension each time it is requested, unless the <code class="directive"><a href="#isapicachefile">ISAPICacheFile</a></code> directive is specified. This is inefficient, but Apache's memory model makes this the most effective method. Many ISAPI modules are subtly incompatible with the Apache server, and unloading these modules helps to ensure the stability of the server.</p> <p>Also, remember that while Apache supports ISAPI Extensions, it <strong>does not support ISAPI Filters</strong>. Support for filters may be added at a later date, but no support is planned at this time.</p></div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="section"><h2><a name="journal" id="journal">Programmer's Journal</a></h2> <p>If you are programming Apache 2.0 <code class="module"><a href="../mod/mod_isapi.html">mod_isapi</a></code> modules, you must limit your calls to <code>ServerSupportFunction</code> to the following directives:</p> <dl> <dt><code>HSE_REQ_SEND_URL_REDIRECT_RESP</code></dt> <dd>Redirect the user to another location.<br /> This must be a fully qualified URL (<em>e.g.</em> <code>http://server/location</code>).</dd> <dt><code>HSE_REQ_SEND_URL</code></dt> <dd>Redirect the user to another location.<br /> This cannot be a fully qualified URL, you are not allowed to pass the protocol or a server name (<em>e.g.</em> simply <code>/location</code>).<br /> This redirection is handled by the server, not the browser.<br /> <div class="warning"><h3>Warning</h3> <p>In their recent documentation, Microsoft appears to have abandoned the distinction between the two <code>HSE_REQ_SEND_URL</code> functions. Apache continues to treat them as two distinct functions with different requirements and behaviors.</p> </div></dd> <dt><code>HSE_REQ_SEND_RESPONSE_HEADER</code></dt> <dd>Apache accepts a response body following the header if it follows the blank line (two consecutive newlines) in the headers string argument. This body cannot contain NULLs, since the headers argument is NULL terminated.</dd> <dt><code>HSE_REQ_DONE_WITH_SESSION</code></dt> <dd>Apache considers this a no-op, since the session will be finished when the ISAPI returns from processing.</dd> <dt><code>HSE_REQ_MAP_URL_TO_PATH</code></dt> <dd>Apache will translate a virtual name to a physical name.</dd> <dt><code>HSE_APPEND_LOG_PARAMETER</code></dt> <dd> This logged message may be captured in any of the following logs:⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -