mirror/openlitespeed
1
0
Fork 0
mirror of https://github.com/litespeedtech/openlitespeed.git synced 2026-06-19 07:37:10 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
014977fc7dca2bbe00ea0f7471f90d2f245df085
openlitespeed/dist/docs/zh-CN/Module_Help.html
T
David 014977fc7d Update document and fix some minor bugs
2018-01-23 17:03:07 -05:00

153 lines
40 KiB
HTML
Raw Blame History

<!DOCTYPE html>
<head>
<meta charset="utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
<title>Open LiteSpeed Web Server Users' Manual - Module Configuration</title>
<meta name="description" content="Open LiteSpeed Web Server Users' Manual - Module Configuration." />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="shortcut icon" href="../img/favicon.ico" />
<link rel="stylesheet" type="text/css" href="../css/hdoc.css">
</head>
<body>
<div class="pagewrapper clearfix"><aside class="sidetree ls-col-1-5">
<figure>
<img src="img/ols_logo.svg" alt="openlitespeed logo" width="150px"/>
</figure>
<h3 class="ls-text-thin">OpenLiteSpeed Web Server <a href="index.html"> Users' Manual</a></h3>
<h5 class="ls-text-muted">Version 1.4 &nbsp;&#8212;&nbsp;Rev. 8</h5>
<hr/>
<div>
<ul>
<li><a href="license.html">License</a></li>
<li><a href="intro.html">Introduction</a></li>
<li><a href="install.html">Installation</a></li>
<li><a href="admin.html">Administration</a>
<ul class="level2"><li><a href="ServerStat_Help.html">Service Manager</a></li></ul></li>
<li><a href="security.html">Security</a></li>
<li><a href="config.html">Configuration</a>
<ul class="level2">
<li><a href="ServGeneral_Help.html">Server General</a></li>
<li><a href="ServLog_Help.html">Server Log</a></li>
<li><a href="ServTuning_Help.html">Server Tuning</a></li>
<li><a href="ServSecurity_Help.html">Server Security</a></li>
<li><a href="ExtApp_Help.html">External Apps</a></li>
<ul class="level3">
<li><a href="External_FCGI.html">Fast CGI App</a></li>
<li><a href="External_FCGI_Auth.html">Fast CGI Authorizer</a></li>
<li><a href="External_LSAPI.html">LSAPI App</a></li>
<li><a href="External_Servlet.html">Servlet Engine</a></li>
<li><a href="External_WS.html">Web Server</a></li>
<li><a href="External_PL.html">Piped logger</a></li>
<li><a href="External_LB.html">Load Balancer</a></li>
</ul>
<li><a href="ScriptHandler_Help.html">Script Handler</a></li>
<li><a href="Rails_Help.html">Rack/Rails Settings</a></li>
<li><span class="current"><a href="Module_Help.html">Module Configuration</a></span></li>
<li><a href="Listeners_General_Help.html">Listener General</a></li>
<li><a href="Listeners_SSL_Help.html">Listener SSL</a></li>
<li><a href="Templates_Help.html">Virtual Host Templates</a></li>
<li><a href="VirtualHosts_Help.html">Virtual Host Basic</a></li>
<li><a href="VHGeneral_Help.html">Virtual Host General</a></li>
<li><a href="VHSecurity_Help.html">Virtual Host Security</a></li>
<li><a href="VHSSL_Help.html">Virtual Host SSL</a></li>
<li><a href="Rewrite_Help.html">Rewrite</a></li>
<li><a href="Context_Help.html">Context</a></li>
<ul class="level3">
<li><a href="Static_Context.html">Static Context</a></li>
<li><a href="Java_Web_App_Context.html">Java Web App Context</a></li>
<li><a href="Servlet_Context.html">Servlet Context</a></li>
<li><a href="FCGI_Context.html">Fast CGI Context</a></li>
<li><a href="LSAPI_Context.html">LSAPI Context</a></li>
<li><a href="Proxy_Context.html">Proxy Context</a></li>
<li><a href="CGI_Context.html">CGI Context</a></li>
<li><a href="LB_Context.html">Load Balancer Context</a></li>
<li><a href="Redirect_Context.html">Redirect Context</a></li>
<li><a href="Rails_Context.html">Rack/Rails Context</a></li>
<li><a href="Module_Context.html">Module Handler Context</a></li>
</ul>
<li><a href="VHWebSocket_Help.html">Web Socket Proxy</a></li>
</ul>
</li>
<li><a href="webconsole.html">Web Console</a>
<ul class="level2">
<li><a href="AdminGeneral_Help.html">Admin Console General</a></li>
<li><a href="AdminSecurity_Help.html">Admin Console Security</a></li>
<li><a href="AdminListeners_General_Help.html">Admin Listener General</a></li>
<li><a href="AdminListeners_SSL_Help.html">Admin Listener SSL</a></li>
</ul>
</li>
</ul>
</div>
</aside>
<article class="contentwrapper ls-col-3-5 clearfix"><div class="nav-bar ls-spacer-micro-top"><div class="prev">&#171 <a href="Rails_Help.html">Rack/Rails Settings</a></div><div class="center"><a href="config.html">Configuration</a></div><div class="next"><a href="Listeners_General_Help.html">Listeners General</a> &#187;</div></div>
<h1>Module Configuration</h1><section class="ls-spacer-small-bottom">Module support is available in Openlitespeed 1.3 and LSWS Enterprise 5.0 and greater.
All required modules must be registered under the Server Modules Configuration tab. Module files must be
located in the server root/modules folder to be available for registering. On start up, the server
loads all registered modules. The server must be restarted after new modules are registered.
Modules can be configured globally under the Server Module configuration tab. The configuration data is
then available to the Listener and Virtual Host Module Configurations to inherit or modify.</section>
<h2 id="top">Table of Contents</h2><section class="toc"><section class="toc-row"><header><a href="#servModules">Server Modules</a></header><p>
<a href="#modulename">Module</a> | <a href="#internalmodule">Is Internal</a> | <a href="#modParams">Module Parameters</a> | <a href="#moduleEnabled">Enable Hooks</a> | <a href="#L4_BEGINSESSION">Hook::L4_BEGINSESSION Priority</a> | <a href="#L4_ENDSESSION">Hook::L4_ENDSESSION Priority</a> | <a href="#L4_RECVING">Hook::L4_RECVING Priority</a> | <a href="#L4_SENDING">Hook::L4_SENDING Priority</a> | <a href="#HTTP_BEGIN">Hook::HTTP_BEGIN Priority</a> | <a href="#RECV_REQ_HEADER">Hook::RECV_REQ_HEADER Priority</a> | <a href="#URI_MAP">Hook::URI_MAP Priority</a> | <a href="#HTTP_AUTH">Hook::HTTP_AUTH Priority</a> | <a href="#RECV_REQ_BODY">Hook::RECV_REQ_BODY Priority</a> | <a href="#RCVD_REQ_BODY">Hook::RCVD_REQ_BODY Priority</a> | <a href="#RECV_RESP_HEADER">Hook::RECV_RESP_HEADER Priority</a> | <a href="#RECV_RESP_BODY">Hook::RECV_RESP_BODY Priority</a> | <a href="#RCVD_RESP_BODY">Hook::RCVD_RESP_BODY Priority</a> | <a href="#HANDLER_RESTART">Hook::HANDLER_RESTART Priority</a> | <a href="#SEND_RESP_HEADER">Hook::SEND_RESP_HEADER Priority</a> | <a href="#SEND_RESP_BODY">Hook::SEND_RESP_BODY Priority</a> | <a href="#HTTP_END">Hook::HTTP_END Priority</a> | <a href="#MAIN_INITED">Hook::MAIN_INITED Priority</a> | <a href="#MAIN_PREFORK">Hook::MAIN_PREFORK Priority</a> | <a href="#MAIN_POSTFORK">Hook::MAIN_POSTFORK Priority</a> | <a href="#WORKER_POSTFORK">Hook::WORKER_POSTFORK Priority</a> | <a href="#WORKER_ATEXIT">Hook::WORKER_ATEXIT Priority</a> | <a href="#MAIN_ATEXIT">Hook::MAIN_ATEXIT Priority</a></p></section>
<section class="toc-row"><header><a href="#listenerModules">Listener Modules</a></header><p>
<a href="#modulename">Module</a> | <a href="#modParams">Module Parameters</a> | <a href="#moduleEnabled_lst">Enable Hooks</a></p></section>
<section class="toc-row"><header><a href="#vhModules">Virtual Host Modules</a></header><p>
<a href="#modulename">Module</a> | <a href="#modParams">Module Parameters</a> | <a href="#moduleEnabled_vh">Enable Hooks</a></p></section>
<section class="toc-row"><header><a href="#vhModuleUrlFilters">Virtual Host Module Context</a></header><p>
<a href="#expuri">URI</a> | <a href="#modParams">Module Parameters</a> | <a href="#moduleEnabled_vh">Enable Hooks</a></p></section>
<section class="toc-row"><header><a href="#moduleContext">Module Handler Context</a></header><p>
<a href="#expuri">URI</a> | <a href="#moduleNameSel">Module</a> | <a href="#extraHeaders">Extra Headers</a> | <a href="#realm">Realm</a> | <a href="#authName">认证名称</a> | <a href="#required">Require（授权的用户/组）</a> | <a href="#accessAllowed">允许访问列表</a> | <a href="#accessDenied">拒绝访问列表</a> | <a href="#extAuthorizer">Authorizer</a> | <a href="#addDefaultCharset">添加默认的字符集</a> | <a href="#defaultCharsetCustomized">自定义默认字符集</a> | <a href="#enableIpGeo">启用IP地理定位</a></p></section>
</section>
<section><div class="helpitem"><article class="ls-helpitem"><div><header id="servModules"><h3>Server Modules<span class="ls-permlink"><a href="#servModules"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>The Server module configuration globally defines the module configuration data. Once defined, the Listeners and Virtual Hosts have access to the modules and module configurations. <br/><br/> All modules that are to be processed must be registered in the Server configuration. The Server configuration also defines the default values for module parameter data. These values can be inherited or overridden by the Listener and Virtual Host configuration data.<br/><br/> Module priority is only defined at server level and is inherited by the Listener and Virtual Host configurations.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="modulename"><h3>Module<span class="ls-permlink"><a href="#modulename"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Name of the module. The module name will be the same as the module filename. The module file must be located under $SERVER_ROOT/modules/modulename.so in order to be loaded by the server application. The server will load the registered modules at start up. This requires that the server is restarted after new modules are registered.</p> <h4>Syntax</h4><p>the library name of .so.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="internalmodule"><h3>Is Internal<span class="ls-permlink"><a href="#internalmodule"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Specify whether the module is an internal module, which is staticaly linked, instead of being an external .so library.</p> <h4>Syntax</h4><p>Select from radio box</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="modParams"><h3>Module Parameters<span class="ls-permlink"><a href="#modParams"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Set module parameters. The module parameters are defined by the module developer.<br/><br/> Set the value in the Server configuration to globally assign the default value. The user can override this setting at the Listener, Virtual Host or Context levels. If the 'Not Set' radio button is selected, it will be inherited from the upper level.</p> <h4>Syntax</h4><p>Specified by the module interface.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="moduleEnabled"><h3>Enable Hooks<span class="ls-permlink"><a href="#moduleEnabled"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Enables or disables the module hooks globally. <br/> If the 'Not Set' radio button is selected and the module contains hook functions, the default is enabled. The user can override this global setting at each level.</p> <h4>Syntax</h4><p>Select from radio box</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="L4_BEGINSESSION"><h3>Hook::L4_BEGINSESSION Priority<span class="ls-permlink"><a href="#L4_BEGINSESSION"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the L4 Begin Session Hook.<br/> The L4 Begin Session Hook is triggered when the TCP/IP connection begins. <br/><br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="L4_ENDSESSION"><h3>Hook::L4_ENDSESSION Priority<span class="ls-permlink"><a href="#L4_ENDSESSION"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the L4 End Session Hook.<br/> The L4 End Session Hook is triggered when the TCP/IP connection ends. <br/><br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="L4_RECVING"><h3>Hook::L4_RECVING Priority<span class="ls-permlink"><a href="#L4_RECVING"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the L4 Receiving Hook.<br/> The L4 Receiving Hook is triggered when the TCP/IP connection receives data. <br/><br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="L4_SENDING"><h3>Hook::L4_SENDING Priority<span class="ls-permlink"><a href="#L4_SENDING"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the L4 Sending Hook.<br/> The L4 Sending Hook is triggered when the TCP/IP connection sends data. <br/><br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="HTTP_BEGIN"><h3>Hook::HTTP_BEGIN Priority<span class="ls-permlink"><a href="#HTTP_BEGIN"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the HTTP Begin Hook.<br/> The HTTP Begin Hook is triggered when the TCP/IP connection begins an HTTP Session. <br/><br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="RECV_REQ_HEADER"><h3>Hook::RECV_REQ_HEADER Priority<span class="ls-permlink"><a href="#RECV_REQ_HEADER"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the HTTP Receive Request Header Hook.<br/> The HTTP Receive Request Header Hook is triggered when the web server receives a request header. <br/><br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="URI_MAP"><h3>Hook::URI_MAP Priority<span class="ls-permlink"><a href="#URI_MAP"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the HTTP URI Map Hook.<br/> The HTTP URI Map Hook is triggered when the web server maps a URI request to a context. <br/><br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="HTTP_AUTH"><h3>Hook::HTTP_AUTH Priority<span class="ls-permlink"><a href="#HTTP_AUTH"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the HTTP Authentication Hook.<br/> The HTTP Authentication Hook is triggered after resource mapping and before handler processing. It occurs after HTTP built-in authentication, and can be used to perform additional authentication checking. <br/><br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="RECV_REQ_BODY"><h3>Hook::RECV_REQ_BODY Priority<span class="ls-permlink"><a href="#RECV_REQ_BODY"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the HTTP Receive Request Body Hook. <br/><br/> The HTTP Receive Request Body Hook is triggered when the web server receives request body data. <br/><br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="RCVD_REQ_BODY"><h3>Hook::RCVD_REQ_BODY Priority<span class="ls-permlink"><a href="#RCVD_REQ_BODY"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the HTTP Received Request Body Hook. <br/><br/> The HTTP Received Request Body Hook is triggered when the web server finishes receiving request body data. <br/><br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="RECV_RESP_HEADER"><h3>Hook::RECV_RESP_HEADER Priority<span class="ls-permlink"><a href="#RECV_RESP_HEADER"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the HTTP Receive Response Header Hook. <br/><br/> The HTTP Receive Response Header Hook is triggered when the web server creates the response header. <br/><br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="RECV_RESP_BODY"><h3>Hook::RECV_RESP_BODY Priority<span class="ls-permlink"><a href="#RECV_RESP_BODY"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the HTTP Receive Response Body Hook. <br/><br/> The HTTP Receive Response Body Hook is triggered when the web server backend receives the response body. <br/><br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="RCVD_RESP_BODY"><h3>Hook::RCVD_RESP_BODY Priority<span class="ls-permlink"><a href="#RCVD_RESP_BODY"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the HTTP Received Response Body Hook. <br/><br/> The HTTP Received Response Body Hook is triggered when the web server backend finishes receiving the response body. <br/><br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="HANDLER_RESTART"><h3>Hook::HANDLER_RESTART Priority<span class="ls-permlink"><a href="#HANDLER_RESTART"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the HTTP Handler Restart Hook.<br/> The HTTP Handler Restart Hook is triggered when the web server needs to discard the current response and start processing from beginning, for example, when an internal redirect has been requested.<br/><br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="SEND_RESP_HEADER"><h3>Hook::SEND_RESP_HEADER Priority<span class="ls-permlink"><a href="#SEND_RESP_HEADER"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the HTTP Send Response Header Hook. <br/><br/> The HTTP Send Response Header Hook is triggered when the web server is ready to send the response header. <br/><br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="SEND_RESP_BODY"><h3>Hook::SEND_RESP_BODY Priority<span class="ls-permlink"><a href="#SEND_RESP_BODY"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the HTTP Send Response Body Hook. <br/><br/> The HTTP Send Response Body Hook is triggered when the web server is going to send the response body. <br/><br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="HTTP_END"><h3>Hook::HTTP_END Priority<span class="ls-permlink"><a href="#HTTP_END"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the HTTP Session End Hook. <br/><br/> The HTTP Session End Hook is triggered when the HTTP connection has ended. <br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="MAIN_INITED"><h3>Hook::MAIN_INITED Priority<span class="ls-permlink"><a href="#MAIN_INITED"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the Main Initialized Hook. <br/><br/> The Main Initialized Hook is triggered once upon startup, after the server configuration and initialization is completed by the main (controller) process, and before any requests are serviced. <br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="MAIN_PREFORK"><h3>Hook::MAIN_PREFORK Priority<span class="ls-permlink"><a href="#MAIN_PREFORK"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the Main Prefork Hook. <br/><br/> The Main Prefork Hook is triggered by the main (controller) process immediately before a new worker process is started (forked). This is called for each worker, and may happen during system startup, or if a worker has been restarted. <br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="MAIN_POSTFORK"><h3>Hook::MAIN_POSTFORK Priority<span class="ls-permlink"><a href="#MAIN_POSTFORK"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the Main Postfork Hook. <br/><br/> The Main Postfork Hook is triggered by the main (controller) process immediately after a new worker process has been started (forked). This is called for each worker, and may happen during system startup, or if a worker has been restarted. <br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="WORKER_POSTFORK"><h3>Hook::WORKER_POSTFORK Priority<span class="ls-permlink"><a href="#WORKER_POSTFORK"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the Worker Postfork Hook. <br/><br/> The Worker Postfork Hook is triggered by a worker process after being created by the main (controller) process. Note that a corresponding Main Postfork Hook may be called by the main process either before or after this callback. <br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="WORKER_ATEXIT"><h3>Hook::WORKER_ATEXIT Priority<span class="ls-permlink"><a href="#WORKER_ATEXIT"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the Worker At Exit Hook. <br/><br/> The Worker At Exit Hook is triggered by a worker process just prior to exiting. It is the last hook point to be called by a worker. <br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="MAIN_ATEXIT"><h3>Hook::MAIN_ATEXIT Priority<span class="ls-permlink"><a href="#MAIN_ATEXIT"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Sets the priority for this module callback within the Main At Exit Hook. <br/><br/> The Main At Exit Hook is triggered by the main (controller) process just prior to exiting. It is the last hook point to be called by the main process. <br/> It will only take effect if the module has a hook point here. If it is not set, the priority will be the default value defined in the module.</p> <h4>Syntax</h4><p>Integer value from -6000 to 6000. Lower value means higher priority.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="listenerModules"><h3>Listener Modules<span class="ls-permlink"><a href="#listenerModules"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Listener module configuration data is, by default inherited from the Server module configuration. The Listener Modules are limited to the TCP/IP Layer 4 hooks.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="moduleEnabled_lst"><h3>Enable Hooks<span class="ls-permlink"><a href="#moduleEnabled_lst"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Enables or disables the module hooks at the Listener level. Only if the module has TCP/IP level hooks (L4_BEGSESSION, L4_ENDSESSION, L4_RECVING, L4_SENDING), this setting will take effect.<br/><br/> If the 'Not Set' radio button is selected, the default will be inherited from the Server configuration. The user only needs to set it here to override the default settings.</p> <h4>Syntax</h4><p>Select from radio box</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="vhModules"><h3>Virtual Host Modules<span class="ls-permlink"><a href="#vhModules"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Virtual Host module configuration data is, by default inherited from the Server module configuration. The Virtual Host Modules are limited to the HTTP level hooks.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="moduleEnabled_vh"><h3>Enable Hooks<span class="ls-permlink"><a href="#moduleEnabled_vh"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Enables or disables the module hooks at the Virtual Host or Context level. Only if the module has HTTP level hooks, this setting will take effect.<br/><br/> If the 'Not Set' radio button is selected, the Virtual Host level default settings will be inherited from the Server configuration. Context level settings will be inherited from the Virtual Host level. The user only needs to set it here to override the default settings.</p> <h4>Syntax</h4><p>Select from radio box</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="vhModuleUrlFilters"><h3>Virtual Host Module Context<span class="ls-permlink"><a href="#vhModuleUrlFilters"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>It's a centralized place to customize module settings for virtual host contexts. Settings for a context URI will override the virtual host or the server level settings.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="expuri"><h3>URI<span class="ls-permlink"><a href="#expuri"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Specifies the URI for this context.</p> <h4>Syntax</h4><p>The URI can be a plain URI (starting with "/") or a Perl compatible regular expression URI (starting with "exp:"). If a plain URI ends with a "/", then this context will include all sub-URIs under this URI. If the context maps to a directory on the file system, a trailing "/" must be added.</p> <h4>See Also</h4><p class="ls-text-small"><span class="tagl"><a href="#location">Location</a></span></p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="moduleContext"><h3>Module Handler Context<span class="ls-permlink"><a href="#moduleContext"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>A module handler context will associate a URI with a registered module. Modules need to be registered at Server Module Configuration tab.</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="moduleNameSel"><h3>Module<span class="ls-permlink"><a href="#moduleNameSel"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Name of the module. The module must be registered under the Server Module Configuration tab. Once it is registered, the module name will be available in the drop down box for the Listener and Virtual Host configurations.</p> <h4>Syntax</h4><p>Select from drop down list</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="extraHeaders"><h3>Extra Headers<span class="ls-permlink"><a href="#extraHeaders"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Specifies extra response headers to be added. Multiple headers can be added, one header per line. Put "NONE" to disable headers inherited from parent content.</p> <h4>Syntax</h4><p>"[HeaderName]: [HeaderValue]" in each line.</p> <h4>Example</h4><div class="ls-example">Cache-control: no-cache, no-store <br/> My-header: Custom header value</div></article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="realm"><h3>Realm<span class="ls-permlink"><a href="#realm"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>指定这个context下的realm授权。 当指定时，必须提供有效的用户和用户名来访问这个context。 <span class="tagl"><a href="VHSecurity_Help.html#realms">Realms授权</a></span>需要在<span class="tagP"><a href="#VHSecurity_Help">Virtual Host Security</a></span>部分进行设置。此设置使用每个realm的<span class="tagl"><a href="VHSecurity_Help.html#realmName">Realm名称</a></span>。</p> <h4>Syntax</h4><p>选项</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="authName"><h3>认证名称<span class="ls-permlink"><a href="#authName"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>为当前context下的realm认证指定一个替代的名称。 如果没有指定，原realm名称将被使用。 认证名称将显示在浏览器登陆弹出窗口。</p> <h4>Syntax</h4><p>文本</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="required"><h3>Require（授权的用户/组）<span class="ls-permlink"><a href="#required"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>指定哪些用户/用户组可以访问此context。 这里允许你使用一个用户/组数据库(在 <span class="tagl"><a href="#realm">Realm</a></span>中指定)访问多个context， 但只允许该数据库下特定的用户/组访问这个context。</p> <h4>Syntax</h4><p>语法兼容Apache的Require指令。例如: <ul> <li><span class="val">user username [username ...]</span> <br/> 只有列出的用户可以访问这个context;</li> <li> <span class="val">group groupid [groupid ...]</span><br/> 用户必须属于列出的组才可以访问这个context。</li> </ul> 如果没有指定，所有有效的用户都可以访问这个资源。</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="accessAllowed"><h3>允许访问列表<span class="ls-permlink"><a href="#accessAllowed"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>指定允许访问这个context下资源的IP地址或子网。综合 <span class="tagl"><a href="#accessDenied">拒绝访问列表</a></span>项的配置以及服务器/虚拟主机级别访问控制， 可访问性将以客户端IP所符合的最小范围来确定。</p> <h4>Syntax</h4><p>逗号分隔的IP地址/子网列表。</p> <h4>Example</h4><div class="ls-example">子网络可以写成<span class="val">192.168.1.0/255.255.255.0</span>, <span class="val">192.168.1</span> 或<span class="val">192.168.1.*</span>。</div></article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="accessDenied"><h3>拒绝访问列表<span class="ls-permlink"><a href="#accessDenied"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>指定哪个IP地址或子网不被允许访问这个context下的资源。 综合<span class="tagl"><a href="#accessAllowed">允许访问列表</a></span>项的配置以及服务器/虚拟主机级别访问控制， 可访问性将以客户端IP所符合的最小范围来确定。</p> <h4>Syntax</h4><p>逗号分隔的IP地址/子网列表。</p> <h4>Example</h4><div class="ls-example">子网络可以写成<span class="val">192.168.1.0/255.255.255.0</span>, <span class="val">192.168.1</span> 或<span class="val">192.168.1.*</span>。</div></article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="extAuthorizer"><h3>Authorizer<span class="ls-permlink"><a href="#extAuthorizer"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>Specifies an external application that can be used to generate authorized/unauthorized decisions. Currently, only the FastCGI Authorizer is available. For more details about the FastCGI Authorizer role, please visit <a href="http://www.fastcgi.com" target="_blank" rel="noopener noreferrer">http://www.fastcgi.com</a>.</p> <h4>Syntax</h4><p>Select from drop down list</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="addDefaultCharset"><h3>添加默认的字符集<span class="ls-permlink"><a href="#addDefaultCharset"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>指定当内容类型是"text/html"或"text/plain"且没有参数时，是否添加字符集标记到"Content-Type"响应报头中。当设置为<span class="val">Off</span>时，该功能禁用。当设置为<span class="val">On</span>时，将添加<span class="tagl"><a href="#defaultCharsetCustomized">自定义默认字符集</a></span>中指定的字符集，如果没有指定，将添加默认的"iso-8859-1"字符集。</p> <h4>Syntax</h4><p>布尔值</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="defaultCharsetCustomized"><h3>自定义默认字符集<span class="ls-permlink"><a href="#defaultCharsetCustomized"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>指定一个字符集当<span class="tagl"><a href="#addDefaultCharset">添加默认的字符集</a></span>是<span class="val">On</span>时使用。这是可选的。默认值是<span class="val">iso-8859-1</span>。当<span class="tagl"><a href="#addDefaultCharset">添加默认的字符集</a></span>是<span class="val">Off</span>时本设置将不生效。</p> <h4>Syntax</h4><p>字符集的名称，例如<span class="val">utf-8</span></p> <h4>Example</h4><div class="ls-example">utf-8</div></article> </div>
<div class="helpitem"><article class="ls-helpitem"><div><header id="enableIpGeo"><h3>启用IP地理定位<span class="ls-permlink"><a href="#enableIpGeo"></a></span><span class="top"><a href="#top">&#8657;</a></span></h3></header></div><h4>Description</h4><p>指定是否启用IP地理定位查找。 可以在服务器级别，虚拟主机级别，或context级别设置。</p> <h4>Syntax</h4><p>布尔值</p> <h4>See Also</h4><p class="ls-text-small"><span class="tagl"><a href="ServGeneral_Help.html#useIpInProxyHeader">使用报头中的客户端IP</a></span>, <span class="tagl"><a href="ServGeneral_Help.html#geoipDBFile">数据库文件路径</a></span>, <span class="tagl"><a href="ServGeneral_Help.html#geoipDBCache">数据库缓存类型</a></span></p> </article> </div>
</section>
</article><div class="ls-col-1-1"><footer class="copyright">Copyright &copy; 2013-2018. <a href="https://www.litespeedtech.com">LiteSpeed Technologies Inc.</a> All rights reserved.</footer>
</div></div>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink