Spade
Mini Shell
<!DOCTYPE html>
<head>
<meta charset="utf-8" />
<meta http-equiv="X-UA-Compatible"
content="IE=edge,chrome=1" />
<title>LiteSpeed Web Server Users' Manual - Script
Handler</title>
<meta name="description" content="LiteSpeed Web Server
Users' Manual - Script Handler." />
<meta name="viewport" content="width=device-width,
initial-scale=1.0" />
<meta name="robots" content="noindex">
<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/lsws_logo.svg" alt="lightspeed web
server logo"
width="100px"/>
</figure>
<h2 class="ls-text-thin">
LiteSpeed Web Server
<br />
<span class="current"><a
href="index.html">Users' Manual</a></span>
</h2>
<h3 class="ls-text-muted">Version 6.3
— Rev. 0</h3>
<hr/>
<div>
<ul>
<li><a href="license.html">License
Enterprise</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="menu level2">
<li><a href="ServerStat_Help.html">Service
Manager</a></li>
<li><a
href="Real_Time_Stats_Help.html">Real-Time
Stats</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="Cache_Help.html">Page
Cache</a></li>
<li><a
href="PageSpeed_Config.html">PageSpeed
Config</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><span class="current"><a
href="ScriptHandler_Help.html">Script
Handler</a></span></li>
<li><a
href="PHP_Help.html">PHP</a></li>
<li><a href="App_Server_Help.html">App
Server Settings</a></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="VHPageSpeed_Config.html">Virtual Host
PageSpeed Config</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="App_Server_Context.html">App
Server Context</a></li>
<li><a
href="Rails_Context.html">Rack/Rails
Context</a></li>
</ul>
<li><a
href="VHAddOns_Help.html">Add-ons</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">« <a
href="ExtApp_Help.html">External
Apps</a></div><div class="center"><a
href="config.html">Configuration</a></div><div
class="next"><a
href="PHP_Help.html">PHP</a>
»</div></div>
<h1>Script Handler</h1><section
class="ls-spacer-small-bottom">LiteSpeed Web Server supports
all scripting languages including
Perl, PHP, Ruby, Python, Java, etc. Scripts written in these different
languages must be brought to the appropriate external application to be
processed.
LiteSpeed Web Server uses script handlers to decide which external
application a
script should go to. These script handlers map files to external
applications by
using the file suffix. (Actually, the suffix is used to determine a MIME
type which is then mapped to the external application.) External
applications
must be set up in the External Application tab before they can be selected
for
use in a script handler.
<br /><br />
You can set up script handler at the server or virtual host level.
Server-level
script handlers apply to all virtual hosts unless overridden in virtual
host level.
Virtual host-level script handlers only apply within that virtual
host.</section>
<h2 id="top">Table of Contents</h2><section
class="toc"><section
class="toc-row"><header>Script Handler
Definition</header><p>
<a href="#suffix">Suffix</a> | <a
href="#shType">Handler Type</a> | <a
href="#shHandlerName">Handler
Name</a></p></section>
</section>
<section><div class="helpitem"><article
class="ls-helpitem"><div><header
id="suffix"><h3>Suffix<span
class="ls-permlink"><a
href="#suffix"></a></span><span
class="top"><a
href="#top">⇑</a></span></h3></header></div><h4>Description</h4><p>Specifies
the script file suffixes that will be handled by this script handler.
Suffixes must be unique.</p>
<h4>Syntax</h4><p>Comma delimited list with period
"." character prohibited.</p>
<h4>Tips</h4><p><span title="Information"
class="ls-icon-info"></span> The server will
automatically add a special MIME type
("application/x-httpd-[suffix]") for the first suffix in the
list. For example, MIME type "application/x-httpd-php53" will be
added for suffix "php53". Suffixes after the first need to set
up in the <span class="tagl"><a
href="#mime">MIME Settings</a></span>
settings.<br/> Though we list suffixes in this field, the script
handlers use MIME types, not suffixes, to decide which scripts to handle.
You can thus use the Apache configuration directives "AddType"
and "ForceType" (which control file MIME types) in .htaccess
files to change which script handler certain files will use. For example,
with the directive <span class="cmd"> AddType
application/x-httpd-php53 .php</span> in a properly placed .htaccess
file, you can stipulate that php files in this directory have the MIME
type "application/x-httpd-php53" and thus will be handled by the
script handler that uses MIME type "application/x-httpd-php53"
(suffix "php53"). This then allows you to assign different script
handlers, not only for different file suffixes, but also based on the
locations of files.<br/> <span title="Performance"
class="ls-icon-performance"></span><span
title="Security"
class="ls-icon-security"></span> Only specify the
suffixes you really need.</p> </article> </div>
<div class="helpitem"><article
class="ls-helpitem"><div><header
id="shType"><h3>Handler Type<span
class="ls-permlink"><a
href="#shType"></a></span><span
class="top"><a
href="#top">⇑</a></span></h3></header></div><h4>Description</h4><p>Specifies
the type of external application that processes these script files.
Available types are: <span class="val">CGI</span>,
<span class="val">FastCGI</span>, <span
class="val">Web Server</span>, <span
class="val">LSAPI app</span>, <span
class="val">Load balancer</span>, or <span
class="val">Servlet Engine</span>. For FastCGI, Web
Server and Servlet Engine, a <span class="tagl"><a
href="#shHandlerName">Handler Name</a></span>
needs to be specified. This is an external application name as predefined
in the <span class="tagP"><a
href="#ExtApp_Help">External Apps</a></span>
section.</p> <h4>Syntax</h4><p>Select from drop
down list</p> </article> </div>
<div class="helpitem"><article
class="ls-helpitem"><div><header
id="shHandlerName"><h3>Handler Name<span
class="ls-permlink"><a
href="#shHandlerName"></a></span><span
class="top"><a
href="#top">⇑</a></span></h3></header></div><h4>Description</h4><p>Specifies
the name of the external application that processes the script files when
the handler type is FastCGI, Web Server, LSAPI, Load Balancer, or Servlet
Engine.</p> <h4>Syntax</h4><p>Select from drop down
list</p> </article> </div>
</section>
</article><div class="ls-col-1-1"><footer
class="copyright">Copyright © 2003-2020. <a
href="https://www.litespeedtech.com">LiteSpeed Technologies
Inc.</a> All rights reserved.</footer>
</div></div>
</body>
</html>