mirror of
https://github.com/apache/httpd.git
synced 2025-04-18 22:24:07 +03:00
55051c9dd9
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1921400 13f79535-47bb-0310-9956-ffa450edef68
5464 lines
310 KiB
XML
5464 lines
310 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
||
<!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>
|
||
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
|
||
<!--
|
||
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
||
This file is generated from xml source: DO NOT EDIT
|
||
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
||
-->
|
||
<title>core - Apache HTTP Server Version 2.5</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
|
||
<script src="../style/scripts/prettify.min.js" type="text/javascript">
|
||
</script>
|
||
|
||
<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/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
|
||
<p class="apache">Apache HTTP Server Version 2.5</p>
|
||
<img alt="" src="../images/feather.png" /></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.5</a> > <a href="./">Modules</a></div>
|
||
<div id="page-content">
|
||
<div id="preamble"><h1>Apache Core Features</h1>
|
||
<div class="toplang">
|
||
<p><span>Available Languages: </span><a href="../de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
|
||
<a href="../en/mod/core.html" title="English"> en </a> |
|
||
<a href="../es/mod/core.html" hreflang="es" rel="alternate" title="Español"> es </a> |
|
||
<a href="../fr/mod/core.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
|
||
<a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
|
||
<a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
|
||
</div>
|
||
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Core Apache HTTP Server features that are always
|
||
available</td></tr>
|
||
<tr><th><a href="module-dict.html#Status">Status:</a></th><td>Core</td></tr></table>
|
||
</div>
|
||
<div id="quickview"><h3 class="directives">Directives</h3>
|
||
<ul id="toc">
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#acceptfilter">AcceptFilter</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#acceptpathinfo">AcceptPathInfo</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#accessfilename">AccessFileName</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#adddefaultcharset">AddDefaultCharset</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#allowencodedslashes">AllowEncodedSlashes</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#allowoverride">AllowOverride</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#allowoverridelist">AllowOverrideList</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#asyncfilter">AsyncFilter</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#cgimapextension">CGIMapExtension</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#cgipassauth">CGIPassAuth</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#cgivar">CGIVar</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#defaultruntimedir">DefaultRuntimeDir</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#defaultstatedir">DefaultStateDir</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#defaulttype">DefaultType</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#define">Define</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#directory"><Directory></a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#directorymatch"><DirectoryMatch></a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#else"><Else></a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#elseif"><ElseIf></a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#enablemmap">EnableMMAP</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#enablesendfile">EnableSendfile</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#error">Error</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#errordocument">ErrorDocument</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#errorlog">ErrorLog</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#errorlogformat">ErrorLogFormat</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#extendedstatus">ExtendedStatus</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#fileetag">FileETag</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#files"><Files></a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#filesmatch"><FilesMatch></a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#flushmaxpipelined">FlushMaxPipelined</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#flushmaxthreshold">FlushMaxThreshold</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#forcetype">ForceType</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#gprofdir">GprofDir</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#hostnamelookups">HostnameLookups</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#httpprotocoloptions">HttpProtocolOptions</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#if"><If></a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#ifdefine"><IfDefine></a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#ifdirective"><IfDirective></a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#iffile"><IfFile></a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#ifmodule"><IfModule></a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#ifsection"><IfSection></a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#include">Include</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#includeoptional">IncludeOptional</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#keepalive">KeepAlive</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#keepalivetimeout">KeepAliveTimeout</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#limit"><Limit></a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#limitexcept"><LimitExcept></a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#limitinternalrecursion">LimitInternalRecursion</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#limitrequestbody">LimitRequestBody</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#limitrequestfields">LimitRequestFields</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#limitrequestfieldsize">LimitRequestFieldSize</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#limitrequestline">LimitRequestLine</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#limitxmlrequestbody">LimitXMLRequestBody</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#location"><Location></a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#locationmatch"><LocationMatch></a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#loglevel">LogLevel</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#logleveloverride">LogLevelOverride</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#maxrangeoverlaps">MaxRangeOverlaps</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#maxrangereversals">MaxRangeReversals</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#maxranges">MaxRanges</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#mergeslashes">MergeSlashes</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#mergetrailers">MergeTrailers</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#mutex">Mutex</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#namevirtualhost">NameVirtualHost</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#protocol">Protocol</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#protocols">Protocols</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#protocolshonororder">ProtocolsHonorOrder</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#qualifyredirecturl">QualifyRedirectURL</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#readbuffersize">ReadBufferSize</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#regexdefaultoptions">RegexDefaultOptions</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#registerhttpmethod">RegisterHttpMethod</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#rlimitcpu">RLimitCPU</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#rlimitmem">RLimitMEM</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#rlimitnproc">RLimitNPROC</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#scriptinterpretersource">ScriptInterpreterSource</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#seerequesttail">SeeRequestTail</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#serveradmin">ServerAdmin</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#serveralias">ServerAlias</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#servername">ServerName</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#serverpath">ServerPath</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#serverroot">ServerRoot</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#serversignature">ServerSignature</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#servertokens">ServerTokens</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#sethandler">SetHandler</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#setinputfilter">SetInputFilter</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#setoutputfilter">SetOutputFilter</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#stricthostcheck">StrictHostCheck</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#timeout">TimeOut</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#traceenable">TraceEnable</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#unclist">UNCList</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#undefine">UnDefine</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#usecanonicalname">UseCanonicalName</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#virtualhost"><VirtualHost></a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#warning">Warning</a></li>
|
||
</ul>
|
||
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=core">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=core">Report a bug</a></li></ul><h3>See also</h3>
|
||
<ul class="seealso">
|
||
<li><a href="#comments_section">Comments</a></li></ul></div>
|
||
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="AcceptFilter" id="AcceptFilter">AcceptFilter</a> <a name="acceptfilter" id="acceptfilter">Directive</a> <a title="Permanent link" href="#acceptfilter" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures optimizations for a Protocol's Listener Sockets</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AcceptFilter <var>protocol</var> <var>accept_filter</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>This directive enables operating system specific optimizations for a
|
||
listening socket by the <code class="directive">Protocol</code> type.
|
||
The basic premise is for the kernel to not send a socket to the server
|
||
process until either data is received or an entire HTTP Request is buffered.
|
||
Only <a href="http://www.freebsd.org/cgi/man.cgi?query=accept_filter&sektion=9">
|
||
FreeBSD's Accept Filters</a>, Linux's more primitive
|
||
<code>TCP_DEFER_ACCEPT</code>, and Windows' optimized AcceptEx()
|
||
are currently supported.</p>
|
||
|
||
<p>Using <code>none</code> for an argument will disable any accept filters
|
||
for that protocol. This is useful for protocols that require a server
|
||
send data first, such as <code>ftp:</code> or <code>nntp</code>:</p>
|
||
<pre class="prettyprint lang-config">AcceptFilter nntp none</pre>
|
||
|
||
|
||
<p>The default protocol names are <code>https</code> for port 443
|
||
and <code>http</code> for all other ports. To specify that another
|
||
protocol is being used with a listening port, add the <var>protocol</var>
|
||
argument to the <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>
|
||
directive.</p>
|
||
|
||
<p>The default values on FreeBSD are:</p>
|
||
<pre class="prettyprint lang-config">AcceptFilter http httpready
|
||
AcceptFilter https dataready</pre>
|
||
|
||
|
||
<p>The <code>httpready</code> accept filter buffers entire HTTP requests at
|
||
the kernel level. Once an entire request is received, the kernel then
|
||
sends it to the server. See the
|
||
<a href="http://www.freebsd.org/cgi/man.cgi?query=accf_http&sektion=9">
|
||
accf_http(9)</a> man page for more details. Since HTTPS requests are
|
||
encrypted, only the <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_data&sektion=9">
|
||
accf_data(9)</a> filter is used.</p>
|
||
|
||
<p>The default values on Linux are:</p>
|
||
<pre class="prettyprint lang-config">AcceptFilter http data
|
||
AcceptFilter https data</pre>
|
||
|
||
|
||
<p>Linux's <code>TCP_DEFER_ACCEPT</code> does not support buffering http
|
||
requests. Any value besides <code>none</code> will enable
|
||
<code>TCP_DEFER_ACCEPT</code> on that listener. For more details
|
||
see the Linux
|
||
<a href="http://man7.org/linux/man-pages/man7/tcp.7.html">
|
||
tcp(7)</a> man page.</p>
|
||
|
||
<p>The default values on Windows are:</p>
|
||
<pre class="prettyprint lang-config">AcceptFilter http connect
|
||
AcceptFilter https connect</pre>
|
||
|
||
|
||
<p>Window's mpm_winnt interprets the AcceptFilter to toggle the AcceptEx()
|
||
API, and does not support http protocol buffering. <code>connect</code>
|
||
will use the AcceptEx() API, also retrieve the network endpoint
|
||
addresses, but like <code>none</code> the <code>connect</code> option
|
||
does not wait for the initial data transmission.</p>
|
||
|
||
<p>On Windows, <code>none</code> uses accept() rather than AcceptEx()
|
||
and will not recycle sockets between connections. This is useful for
|
||
network adapters with broken driver support, as well as some virtual
|
||
network providers such as vpn drivers, or spam, virus or spyware
|
||
filters.</p>
|
||
|
||
<div class="warning">
|
||
<h3>The <code>data</code> AcceptFilter (Windows)</h3>
|
||
|
||
<p>For versions 2.4.23 and prior, the Windows <code>data</code> accept
|
||
filter waited until data had been transmitted and the initial data
|
||
buffer and network endpoint addresses had been retrieved from the
|
||
single AcceptEx() invocation. This implementation was subject to a
|
||
denial of service attack and has been disabled.</p>
|
||
|
||
<p>Current releases of httpd default to the <code>connect</code> filter
|
||
on Windows, and will fall back to <code>connect</code> if
|
||
<code>data</code> is specified. Users of prior releases are encouraged
|
||
to add an explicit setting of <code>connect</code> for their
|
||
AcceptFilter, as shown above.</p>
|
||
</div>
|
||
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#protocol">Protocol</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="AcceptPathInfo" id="AcceptPathInfo">AcceptPathInfo</a> <a name="acceptpathinfo" id="acceptpathinfo">Directive</a> <a title="Permanent link" href="#acceptpathinfo" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Resources accept trailing pathname information</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AcceptPathInfo On|Off|Default</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AcceptPathInfo Default</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
|
||
<p>This directive controls whether requests that contain trailing
|
||
pathname information that follows an actual filename (or
|
||
non-existent file in an existing directory) will be accepted or
|
||
rejected. The trailing pathname information can be made
|
||
available to scripts in the <code>PATH_INFO</code> environment
|
||
variable.</p>
|
||
|
||
<p>For example, assume the location <code>/test/</code> points to
|
||
a directory that contains only the single file
|
||
<code>here.html</code>. Then requests for
|
||
<code>/test/here.html/more</code> and
|
||
<code>/test/nothere.html/more</code> both collect
|
||
<code>/more</code> as <code>PATH_INFO</code>.</p>
|
||
|
||
<p>The three possible arguments for the
|
||
<code class="directive">AcceptPathInfo</code> directive are:</p>
|
||
<dl>
|
||
<dt><code>Off</code></dt><dd>A request will only be accepted if it
|
||
maps to a literal path that exists. Therefore a request with
|
||
trailing pathname information after the true filename such as
|
||
<code>/test/here.html/more</code> in the above example will return
|
||
a 404 NOT FOUND error.</dd>
|
||
|
||
<dt><code>On</code></dt><dd>A request will be accepted if a
|
||
leading path component maps to a file that exists. The above
|
||
example <code>/test/here.html/more</code> will be accepted if
|
||
<code>/test/here.html</code> maps to a valid file.</dd>
|
||
|
||
<dt><code>Default</code></dt><dd>The treatment of requests with
|
||
trailing pathname information is determined by the <a href="../handler.html">handler</a> responsible for the request.
|
||
The core handler for normal files defaults to rejecting
|
||
<code>PATH_INFO</code> requests. Handlers that serve scripts, such as <a href="mod_cgi.html">cgi-script</a> and <a href="mod_isapi.html">isapi-handler</a>, generally accept
|
||
<code>PATH_INFO</code> by default.</dd>
|
||
</dl>
|
||
|
||
<p>The primary purpose of the <code>AcceptPathInfo</code>
|
||
directive is to allow you to override the handler's choice of
|
||
accepting or rejecting <code>PATH_INFO</code>. This override is required,
|
||
for example, when you use a <a href="../filter.html">filter</a>, such
|
||
as <a href="mod_include.html">INCLUDES</a>, to generate content
|
||
based on <code>PATH_INFO</code>. The core handler would usually reject
|
||
the request, so you can use the following configuration to enable
|
||
such a script:</p>
|
||
|
||
<pre class="prettyprint lang-config"><Files "mypaths.shtml">
|
||
Options +Includes
|
||
SetOutputFilter INCLUDES
|
||
AcceptPathInfo On
|
||
</Files></pre>
|
||
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="AccessFileName" id="AccessFileName">AccessFileName</a> <a name="accessfilename" id="accessfilename">Directive</a> <a title="Permanent link" href="#accessfilename" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name of the distributed configuration file</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AccessFileName <var>filename</var> [<var>filename</var>] ...</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AccessFileName .htaccess</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>While processing a request, the server looks for
|
||
the first existing configuration file from this list of names in
|
||
every directory of the path to the document, if distributed
|
||
configuration files are <a href="#allowoverride">enabled for that
|
||
directory</a>. For example:</p>
|
||
|
||
<pre class="prettyprint lang-config">AccessFileName .acl</pre>
|
||
|
||
|
||
<p>Before returning the document
|
||
<code>/usr/local/web/index.html</code>, the server will read
|
||
<code>/.acl</code>, <code>/usr/.acl</code>,
|
||
<code>/usr/local/.acl</code> and <code>/usr/local/web/.acl</code>
|
||
for directives unless they have been disabled with:</p>
|
||
|
||
<pre class="prettyprint lang-config"><Directory "/">
|
||
AllowOverride None
|
||
</Directory></pre>
|
||
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li>
|
||
<li><a href="../configuring.html">Configuration Files</a></li>
|
||
<li><a href="../howto/htaccess.html">.htaccess Files</a></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="AddDefaultCharset" id="AddDefaultCharset">AddDefaultCharset</a> <a name="adddefaultcharset" id="adddefaultcharset">Directive</a> <a title="Permanent link" href="#adddefaultcharset" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Default charset parameter to be added when a response
|
||
content-type is <code>text/plain</code> or <code>text/html</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddDefaultCharset On|Off|<var>charset</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AddDefaultCharset Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>This directive specifies a default value for the media type
|
||
charset parameter (the name of a character encoding) to be added
|
||
to a response if and only if the response's content-type is either
|
||
<code>text/plain</code> or <code>text/html</code>. This should override
|
||
any charset specified in the body of the response via a <code>META</code>
|
||
element, though the exact behavior is often dependent on the user's client
|
||
configuration. A setting of <code>AddDefaultCharset Off</code>
|
||
disables this functionality. <code>AddDefaultCharset On</code> enables
|
||
a default charset of <code>iso-8859-1</code>. Any other value is assumed
|
||
to be the <var>charset</var> to be used, which should be one of the
|
||
<a href="http://www.iana.org/assignments/character-sets">IANA registered
|
||
charset values</a> for use in Internet media types (MIME types).
|
||
For example:</p>
|
||
|
||
<pre class="prettyprint lang-config">AddDefaultCharset utf-8</pre>
|
||
|
||
|
||
<p><code class="directive">AddDefaultCharset</code> should only be used when all
|
||
of the text resources to which it applies are known to be in that
|
||
character encoding and it is too inconvenient to label their charset
|
||
individually. One such example is to add the charset parameter
|
||
to resources containing generated content, such as legacy CGI
|
||
scripts, that might be vulnerable to cross-site scripting attacks
|
||
due to user-provided data being included in the output. Note, however,
|
||
that a better solution is to just fix (or delete) those scripts, since
|
||
setting a default charset does not protect users that have enabled
|
||
the "auto-detect character encoding" feature on their browser.</p>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="../mod/mod_mime.html#addcharset">AddCharset</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="AllowEncodedSlashes" id="AllowEncodedSlashes">AllowEncodedSlashes</a> <a name="allowencodedslashes" id="allowencodedslashes">Directive</a> <a title="Permanent link" href="#allowencodedslashes" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether encoded path separators in URLs are allowed to
|
||
be passed through</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowEncodedSlashes On|Off|NoDecode</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AllowEncodedSlashes Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>
|
||
NoDecode option available in 2.3.12 and later.</td></tr>
|
||
</table>
|
||
<p>The <code class="directive">AllowEncodedSlashes</code> directive allows URLs
|
||
which contain encoded path separators (<code>%2F</code> for <code>/</code>
|
||
and additionally <code>%5C</code> for <code>\</code> on accordant systems)
|
||
to be used in the path info.</p>
|
||
|
||
<p>With the default value, <code>Off</code>, such URLs are refused
|
||
with a 404 (Not found) error.</p>
|
||
|
||
<p>With the value <code>On</code>, such URLs are accepted, and encoded
|
||
slashes are decoded like all other encoded characters.</p>
|
||
|
||
<p>With the value <code>NoDecode</code>, such URLs are accepted, but
|
||
encoded slashes are not decoded but left in their encoded state.</p>
|
||
|
||
<p>Turning <code class="directive">AllowEncodedSlashes</code> <code>On</code> is
|
||
mostly useful when used in conjunction with <code>PATH_INFO</code>.</p>
|
||
|
||
<div class="note"><h3>Note</h3>
|
||
<p>If encoded slashes are needed in path info, use of <code>NoDecode</code> is
|
||
strongly recommended as a security measure. Allowing slashes
|
||
to be decoded could potentially allow unsafe paths.</p>
|
||
</div>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#acceptpathinfo">AcceptPathInfo</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="AllowOverride" id="AllowOverride">AllowOverride</a> <a name="allowoverride" id="allowoverride">Directive</a> <a title="Permanent link" href="#allowoverride" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Types of directives that are allowed in
|
||
<code>.htaccess</code> files</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowOverride All|None|<var>directive-type</var>
|
||
[<var>directive-type</var>] ...</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AllowOverride None (2.3.9 and later), AllowOverride All (2.3.8 and earlier)</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>When the server finds an <code>.htaccess</code> file (as
|
||
specified by <code class="directive"><a href="#accessfilename">AccessFileName</a></code>),
|
||
it needs to know which directives declared in that file can override
|
||
earlier configuration directives.</p>
|
||
|
||
<div class="note"><h3>Only available in <Directory> sections</h3>
|
||
<code class="directive">AllowOverride</code> is valid only in
|
||
<code class="directive"><a href="#directory"><Directory></a></code>
|
||
sections specified without regular expressions, not in <code class="directive"><a href="#location"><Location></a></code>, <code class="directive"><a href="#directorymatch"><DirectoryMatch></a></code> or
|
||
<code class="directive"><a href="#files"><Files></a></code> sections.
|
||
</div>
|
||
|
||
<p>When this directive is set to <code>None</code> and <code class="directive"><a href="#allowoverridelist">AllowOverrideList</a></code> is set to
|
||
<code>None</code>, <a href="#accessfilename">.htaccess</a> files are
|
||
completely ignored. In this case, the server will not even attempt
|
||
to read <code>.htaccess</code> files in the filesystem.</p>
|
||
|
||
<p>When this directive is set to <code>All</code>, then any
|
||
directive which has the .htaccess <a href="directive-dict.html#Context">Context</a> is allowed in
|
||
<code>.htaccess</code> files.</p>
|
||
|
||
<p>The <var>directive-type</var> can be one of the following
|
||
groupings of directives. (See the <a href="overrides.html">override class
|
||
index</a> for an up-to-date listing of which directives are enabled by each
|
||
<var>directive-type</var>.)</p>
|
||
|
||
<dl>
|
||
<dt><a href="overrides.html#override-authconfig">AuthConfig</a></dt>
|
||
|
||
<dd>
|
||
|
||
Allow use of the authorization directives (<code class="directive"><a href="../mod/mod_authz_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code>,
|
||
<code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>,
|
||
<code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>,
|
||
<code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code>,
|
||
<code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code>, <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>, <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>, <em>etc.</em>).</dd>
|
||
|
||
<dt><a href="overrides.html#override-fileinfo">FileInfo</a></dt>
|
||
|
||
<dd>
|
||
Allow use of the directives controlling document types
|
||
(<code class="directive"><a href="#errordocument">ErrorDocument</a></code>,
|
||
<code class="directive"><a href="#forcetype">ForceType</a></code>,
|
||
<code class="directive"><a href="../mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>,
|
||
<code class="directive"><a href="#sethandler">SetHandler</a></code>,
|
||
<code class="directive"><a href="#setinputfilter">SetInputFilter</a></code>,
|
||
<code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code>, and
|
||
<code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> Add* and Remove* directives),
|
||
document meta data (<code class="directive"><a href="../mod/mod_headers.html#header">Header</a></code>, <code class="directive"><a href="../mod/mod_headers.html#requestheader">RequestHeader</a></code>, <code class="directive"><a href="../mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>, <code class="directive"><a href="../mod/mod_setenvif.html#setenvifnocase">SetEnvIfNoCase</a></code>, <code class="directive"><a href="../mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookieexpires">CookieExpires</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookiedomain">CookieDomain</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookiestyle">CookieStyle</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookietracking">CookieTracking</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookiename">CookieName</a></code>),
|
||
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> directives (<code class="directive"><a href="../mod/mod_rewrite.html#rewriteengine">RewriteEngine</a></code>, <code class="directive"><a href="../mod/mod_rewrite.html#rewriteoptions">RewriteOptions</a></code>, <code class="directive"><a href="../mod/mod_rewrite.html#rewritebase">RewriteBase</a></code>, <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>, <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>),
|
||
<code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> directives (<code class="directive"><a href="../mod/mod_alias.html#redirect">Redirect</a></code>, <code class="directive"><a href="../mod/mod_alias.html#redirecttemp">RedirectTemp</a></code>, <code class="directive"><a href="../mod/mod_alias.html#redirectpermanent">RedirectPermanent</a></code>, <code class="directive"><a href="../mod/mod_alias.html#redirectmatch">RedirectMatch</a></code>), and
|
||
<code class="directive"><a href="../mod/mod_actions.html#action">Action</a></code> from
|
||
<code class="module"><a href="../mod/mod_actions.html">mod_actions</a></code>.
|
||
</dd>
|
||
|
||
<dt><a href="overrides.html#override-indexes">Indexes</a></dt>
|
||
|
||
<dd>
|
||
Allow use of the directives controlling directory indexing
|
||
(<code class="directive"><a href="../mod/mod_autoindex.html#adddescription">AddDescription</a></code>,
|
||
<code class="directive"><a href="../mod/mod_autoindex.html#addicon">AddIcon</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#addiconbyencoding">AddIconByEncoding</a></code>,
|
||
<code class="directive"><a href="../mod/mod_autoindex.html#addiconbytype">AddIconByType</a></code>,
|
||
<code class="directive"><a href="../mod/mod_autoindex.html#defaulticon">DefaultIcon</a></code>, <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>, <code class="directive"><a href="../mod/mod_dir.html#fallbackresource">FallbackResource</a></code>, <a href="mod_autoindex.html#indexoptions.fancyindexing"><code>FancyIndexing</code></a>, <code class="directive"><a href="../mod/mod_autoindex.html#headername">HeaderName</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#indexignore">IndexIgnore</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#indexoptions">IndexOptions</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#readmename">ReadmeName</a></code>,
|
||
<em>etc.</em>).</dd>
|
||
|
||
<dt><a href="overrides.html#override-limit">Limit</a></dt>
|
||
|
||
<dd>
|
||
Allow use of the directives controlling host access (<code class="directive"><a href="../mod/mod_access_compat.html#allow">Allow</a></code>, <code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code> and <code class="directive"><a href="../mod/mod_access_compat.html#order">Order</a></code>).</dd>
|
||
|
||
|
||
|
||
|
||
<dt>Nonfatal=[Override|Unknown|All]</dt>
|
||
|
||
<dd>
|
||
Allow use of AllowOverride option to treat invalid (unrecognized
|
||
or disallowed) directives in
|
||
.htaccess as nonfatal. Instead of causing an Internal Server
|
||
Error, disallowed or unrecognised directives will be ignored
|
||
and a warning logged:
|
||
<ul>
|
||
<li><strong>Nonfatal=Override</strong> treats directives
|
||
forbidden by AllowOverride as nonfatal.</li>
|
||
<li><strong>Nonfatal=Unknown</strong> treats unknown directives
|
||
as nonfatal. This covers typos and directives implemented
|
||
by a module that's not present.</li>
|
||
<li><strong>Nonfatal=All</strong> treats both the above as nonfatal.</li>
|
||
</ul>
|
||
<p>Note that a syntax error in a valid directive will still cause
|
||
an Internal Server Error.</p>
|
||
<div class="warning"><h3>Security</h3>
|
||
Nonfatal errors may have security implications for .htaccess users.
|
||
For example, if AllowOverride disallows AuthConfig, users'
|
||
configuration designed to restrict access to a site will be disabled.
|
||
</div>
|
||
</dd>
|
||
|
||
<dt><a href="overrides.html#override-options">Options</a>[=<var>Option</var>,...]</dt>
|
||
|
||
<dd>
|
||
Allow use of the directives controlling specific directory
|
||
features (<code class="directive"><a href="#options">Options</a></code> and
|
||
<code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>).
|
||
An equal sign may be given followed by a comma-separated list, without
|
||
spaces, of options that may be set using the <code class="directive"><a href="#options">Options</a></code> command.
|
||
|
||
<div class="note"><h3>Implicit disabling of Options</h3>
|
||
<p>Even though the list of options that may be used in .htaccess files
|
||
can be limited with this directive, as long as any <code class="directive"><a href="#options">Options</a></code> directive is allowed any
|
||
other inherited option can be disabled by using the non-relative
|
||
syntax. In other words, this mechanism cannot force a specific option
|
||
to remain <em>set</em> while allowing any others to be set.
|
||
</p></div>
|
||
|
||
<div class="example"><p><code>
|
||
AllowOverride Options=Indexes,MultiViews
|
||
</code></p></div>
|
||
</dd>
|
||
</dl>
|
||
|
||
<p>Example:</p>
|
||
|
||
<pre class="prettyprint lang-config">AllowOverride AuthConfig Indexes</pre>
|
||
|
||
|
||
<p>In the example above, all directives that are neither in the group
|
||
<code>AuthConfig</code> nor <code>Indexes</code> cause an internal
|
||
server error.</p>
|
||
|
||
<div class="note"><p>For security and performance reasons, do not set
|
||
<code>AllowOverride</code> to anything other than <code>None</code>
|
||
in your <code><Directory "/"></code> block. Instead, find (or
|
||
create) the <code><Directory></code> block that refers to the
|
||
directory where you're actually planning to place a
|
||
<code>.htaccess</code> file.</p>
|
||
</div>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li>
|
||
<li><code class="directive"><a href="#allowoverridelist">AllowOverrideList</a></code></li>
|
||
<li><a href="../configuring.html">Configuration Files</a></li>
|
||
<li><a href="../howto/htaccess.html">.htaccess Files</a></li>
|
||
<li><a href="overrides.html">Override Class Index for .htaccess</a></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="AllowOverrideList" id="AllowOverrideList">AllowOverrideList</a> <a name="allowoverridelist" id="allowoverridelist">Directive</a> <a title="Permanent link" href="#allowoverridelist" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Individual directives that are allowed in
|
||
<code>.htaccess</code> files</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowOverrideList None|<var>directive</var>
|
||
[<var>directive-type</var>] ...</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AllowOverrideList None</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>When the server finds an <code>.htaccess</code> file (as
|
||
specified by <code class="directive"><a href="#accessfilename">AccessFileName</a></code>),
|
||
it needs to know which directives declared in that file can override
|
||
earlier configuration directives.</p>
|
||
|
||
<div class="note"><h3>Only available in <Directory> sections</h3>
|
||
<code class="directive">AllowOverrideList</code> is valid only in
|
||
<code class="directive"><a href="#directory"><Directory></a></code>
|
||
sections specified without regular expressions, not in <code class="directive"><a href="#location"><Location></a></code>, <code class="directive"><a href="#directorymatch"><DirectoryMatch></a></code> or
|
||
<code class="directive"><a href="#files"><Files></a></code> sections.
|
||
</div>
|
||
|
||
<p>When this directive is set to <code>None</code> and <code class="directive"><a href="#allowoverride">AllowOverride</a></code> is set to <code>None</code>,
|
||
then <a href="#accessfilename">.htaccess</a> files are completely
|
||
ignored. In this case, the server will not even attempt to read
|
||
<code>.htaccess</code> files in the filesystem.</p>
|
||
|
||
<p>Example:</p>
|
||
|
||
<pre class="prettyprint lang-config">AllowOverride None
|
||
AllowOverrideList Redirect RedirectMatch</pre>
|
||
|
||
|
||
<p>In the example above, only the <code>Redirect</code> and
|
||
<code>RedirectMatch</code> directives are allowed. All others will
|
||
cause an Internal Server Error.</p>
|
||
|
||
<p>Example:</p>
|
||
|
||
<pre class="prettyprint lang-config">AllowOverride AuthConfig
|
||
AllowOverrideList CookieTracking CookieName</pre>
|
||
|
||
|
||
<p>In the example above, <code class="directive"><a href="#allowoverride">AllowOverride</a></code>
|
||
grants permission to the <code>AuthConfig</code>
|
||
directive grouping and <code class="directive">AllowOverrideList</code> grants
|
||
permission to only two directives from the <code>FileInfo</code> directive
|
||
grouping. All others will cause an Internal Server Error.</p>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li>
|
||
<li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li>
|
||
<li><a href="../configuring.html">Configuration Files</a></li>
|
||
<li><a href="../howto/htaccess.html">.htaccess Files</a></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="AsyncFilter" id="AsyncFilter">AsyncFilter</a> <a name="asyncfilter" id="asyncfilter">Directive</a> <a title="Permanent link" href="#asyncfilter" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the minimum filter type eligible for asynchronous handling</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AsyncFilter request|connection|network</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AsyncFilter request</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Only available from Apache 2.5.0 and later.</td></tr>
|
||
</table>
|
||
<p>This directive controls the minimum filter levels that are eligible
|
||
for asynchronous handling. This may be necessary to support legacy external
|
||
filters that did not handle meta buckets correctly.</p>
|
||
|
||
<p>If set to "network", asynchronous handling will be limited to the network
|
||
filter only. If set to "connection", all connection and network filters
|
||
will be eligible for asynchronous handling, including <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>.
|
||
If set to "request", all filters will be eligible for asynchronous handling.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="CGIMapExtension" id="CGIMapExtension">CGIMapExtension</a> <a name="cgimapextension" id="cgimapextension">Directive</a> <a title="Permanent link" href="#cgimapextension" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Technique for locating the interpreter for CGI
|
||
scripts</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CGIMapExtension <var>cgi-path</var> <var>.extension</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>NetWare only</td></tr>
|
||
</table>
|
||
<p>This directive is used to control how Apache httpd finds the
|
||
interpreter used to run CGI scripts. For example, setting
|
||
<code>CGIMapExtension sys:\foo.nlm .foo</code> will
|
||
cause all CGI script files with a <code>.foo</code> extension to
|
||
be passed to the FOO interpreter.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="CGIPassAuth" id="CGIPassAuth">CGIPassAuth</a> <a name="cgipassauth" id="cgipassauth">Directive</a> <a title="Permanent link" href="#cgipassauth" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables passing HTTP authorization headers to scripts as CGI
|
||
variables</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CGIPassAuth On|Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>CGIPassAuth Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>AuthConfig</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache HTTP Server 2.4.13 and later</td></tr>
|
||
</table>
|
||
<p><code class="directive">CGIPassAuth</code> allows scripts access to HTTP
|
||
authorization headers such as <code>Authorization</code>, which is
|
||
required for scripts that implement HTTP Basic authentication.
|
||
Normally these HTTP headers are hidden from scripts. This is to disallow
|
||
scripts from seeing user ids and passwords used to access the server when
|
||
HTTP Basic authentication is enabled in the web server. This directive
|
||
should be used when scripts are allowed to implement HTTP Basic
|
||
authentication.</p>
|
||
|
||
<p>This directive can be used instead of the compile-time setting
|
||
<code>SECURITY_HOLE_PASS_AUTHORIZATION</code> which has been available
|
||
in previous versions of Apache HTTP Server.</p>
|
||
|
||
<p>The setting is respected by any modules which use
|
||
<code>ap_add_common_vars()</code>, such as <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>,
|
||
<code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code>, <code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code>,
|
||
<code class="module"><a href="../mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code>, and so on. Notably, it affects
|
||
modules which don't handle the request in the usual sense but
|
||
still use this API; examples of this are <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>
|
||
and <code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code>. Third-party modules that don't
|
||
use <code>ap_add_common_vars()</code> may choose to respect the setting
|
||
as well.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="CGIVar" id="CGIVar">CGIVar</a> <a name="cgivar" id="cgivar">Directive</a> <a title="Permanent link" href="#cgivar" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls how some CGI variables are set</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CGIVar <var>variable</var> <var>rule</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache HTTP Server 2.4.21 and later</td></tr>
|
||
</table>
|
||
<p>This directive controls how some CGI variables are set.</p>
|
||
|
||
<p><strong>REQUEST_URI</strong> rules:</p>
|
||
<dl>
|
||
<dt><code>original-uri</code> (default)</dt>
|
||
<dd>The value is taken from the original request line, and will not
|
||
reflect internal redirects or subrequests which change the requested
|
||
resource.</dd>
|
||
<dt><code>current-uri</code></dt>
|
||
<dd>The value reflects the resource currently being processed,
|
||
which may be different than the original request from the client
|
||
due to internal redirects or subrequests.</dd>
|
||
</dl>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="DefaultRuntimeDir" id="DefaultRuntimeDir">DefaultRuntimeDir</a> <a name="defaultruntimedir" id="defaultruntimedir">Directive</a> <a title="Permanent link" href="#defaultruntimedir" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Base directory for the server run-time files</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DefaultRuntimeDir <var>directory-path</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DefaultRuntimeDir DEFAULT_REL_RUNTIMEDIR (logs/)</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.4.2 and later</td></tr>
|
||
</table>
|
||
<p>The <code class="directive">DefaultRuntimeDir</code> directive sets the
|
||
directory in which the server will create various run-time files
|
||
(shared memory, locks, etc.). If set as a relative path, the full path
|
||
will be relative to <code class="directive">ServerRoot</code>.</p>
|
||
|
||
<p><strong>Example</strong></p>
|
||
<pre class="prettyprint lang-config">DefaultRuntimeDir scratch/</pre>
|
||
|
||
|
||
<p>The default location of <code class="directive">DefaultRuntimeDir</code> may be
|
||
modified by changing the <code>DEFAULT_REL_RUNTIMEDIR</code> #define
|
||
at build time.</p>
|
||
|
||
<p>Note: <code class="directive">ServerRoot</code> should be specified before this
|
||
directive is used. Otherwise, the default value of <code class="directive">ServerRoot</code>
|
||
would be used to set the base directory.</p>
|
||
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><a href="../misc/security_tips.html#serverroot">the
|
||
security tips</a> for information on how to properly set
|
||
permissions on the <code class="directive">ServerRoot</code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="DefaultStateDir" id="DefaultStateDir">DefaultStateDir</a> <a name="defaultstatedir" id="defaultstatedir">Directive</a> <a title="Permanent link" href="#defaultstatedir" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Base directory for the persistent state files</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DefaultStateDir <var>directory-path</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DefaultStateDir DEFAULT_REL_STATEDIR (state/)</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.5.1 and later</td></tr>
|
||
</table>
|
||
<p>The <code class="directive">DefaultStateDir</code> directive sets the
|
||
directory in which the server will create various persistent state
|
||
files (databases, long-lived caches, etc.). If set as a relative
|
||
path, the full path will be relative to
|
||
<code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>
|
||
|
||
<p><strong>Example</strong></p>
|
||
<pre class="prettyprint lang-config">DefaultStateDir state/</pre>
|
||
|
||
|
||
<p>The default location of <code class="directive">DefaultStateDir</code> may be
|
||
modified by changing the <code>DEFAULT_REL_STATEDIR</code> #define
|
||
at build time.</p>
|
||
|
||
<p>Note: <code class="directive"><a href="#serverroot">ServerRoot</a></code> should be specified before this
|
||
directive is used. Otherwise, the default value of <code class="directive"><a href="#serverroot">ServerRoot</a></code>
|
||
would be used to set the base directory.</p>
|
||
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><a href="../misc/security_tips.html#serverroot">the
|
||
security tips</a> for information on how to properly set
|
||
permissions on the <code class="directive"><a href="#serverroot">ServerRoot</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="DefaultType" id="DefaultType">DefaultType</a> <a name="defaulttype" id="defaulttype">Directive</a> <a title="Permanent link" href="#defaulttype" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>This directive has no effect other than to emit warnings
|
||
if the value is not <code>none</code>. In prior versions, DefaultType
|
||
would specify a default media type to assign to response content for
|
||
which no other media type configuration could be found.
|
||
</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DefaultType <var>media-type|none</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DefaultType none</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>All choices except <code>none</code> are DISABLED for 2.3.x and later.
|
||
</td></tr>
|
||
</table>
|
||
<p>This directive has been disabled. For backwards compatibility
|
||
of configuration files, it may be specified with the value
|
||
<code>none</code>, meaning no default media type. For example:</p>
|
||
|
||
<pre class="prettyprint lang-config">DefaultType None</pre>
|
||
|
||
|
||
<p><code>DefaultType None</code> is only available in
|
||
httpd-2.2.7 and later.</p>
|
||
|
||
<p>Use the mime.types configuration file and the
|
||
<code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code> to configure media
|
||
type assignments via file extensions, or the
|
||
<code class="directive"><a href="#forcetype">ForceType</a></code> directive to configure
|
||
the media type for specific resources. Otherwise, the server will
|
||
send the response without a Content-Type header field and the
|
||
recipient may attempt to guess the media type.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="Define" id="Define">Define</a> <a name="define" id="define">Directive</a> <a title="Permanent link" href="#define" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define a variable</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Define <var>parameter-name</var> [<var>parameter-value</var>]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>In its one parameter form, <code class="directive">Define</code> is
|
||
equivalent to passing the <code>-D</code> argument to
|
||
<code class="program"><a href="../programs/httpd.html">httpd</a></code>. It can be used to toggle the use of
|
||
<code class="directive"><a href="#ifdefine"><IfDefine></a></code>
|
||
sections without needing to alter <code>-D</code> arguments in any
|
||
startup scripts.</p>
|
||
|
||
<p>In addition to that, if the second parameter is given, a config variable
|
||
is set to this value. The variable can be used in the configuration using
|
||
the <code>${VAR}</code> syntax. The variable is always globally defined
|
||
and not limited to the scope of the surrounding config section.</p>
|
||
|
||
<pre class="prettyprint lang-config"><IfDefine TEST>
|
||
Define servername test.example.com
|
||
</IfDefine>
|
||
<IfDefine !TEST>
|
||
Define servername www.example.com
|
||
Define SSL
|
||
</IfDefine>
|
||
|
||
DocumentRoot "/var/www/${servername}/htdocs"</pre>
|
||
|
||
|
||
<p>Variable names may not contain colon ":" characters, to avoid clashes
|
||
with <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>'s syntax.</p>
|
||
|
||
<div class="note"><h3>Virtual Host scope and pitfalls</h3>
|
||
<p>While this directive is supported in virtual host context,
|
||
the changes it makes are visible to any later configuration
|
||
directives, beyond any enclosing virtual host.</p>
|
||
</div>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#undefine">UnDefine</a></code></li>
|
||
<li><code class="directive"><a href="#ifdefine">IfDefine</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="Directory" id="Directory"><Directory></a> <a name="directory" id="directory">Directive</a> <a title="Permanent link" href="#directory" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose a group of directives that apply only to the
|
||
named file-system directory, sub-directories, and their contents.</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Directory <var>directory-path</var>>
|
||
... </Directory></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p><code class="directive"><Directory></code> and
|
||
<code></Directory></code> are used to enclose a group of
|
||
directives that will apply only to the named directory,
|
||
sub-directories of that directory, and the files within the respective
|
||
directories. Any directive that is allowed
|
||
in a directory context may be used. <var>Directory-path</var> is
|
||
either the full path to a directory, or a wild-card string using
|
||
Unix shell-style matching. In a wild-card string, <code>?</code> matches
|
||
any single character, and <code>*</code> matches any sequences of
|
||
characters. You may also use <code>[]</code> character ranges. None
|
||
of the wildcards match a `/' character, so <code><Directory
|
||
"/*/public_html"></code> will not match
|
||
<code>/home/user/public_html</code>, but <code><Directory
|
||
"/home/*/public_html"></code> will match. Example:</p>
|
||
|
||
<pre class="prettyprint lang-config"><Directory "/usr/local/httpd/htdocs">
|
||
Options Indexes FollowSymLinks
|
||
</Directory></pre>
|
||
|
||
|
||
<p>Directory paths <em>may</em> be quoted, if you like, however, it
|
||
<em>must</em> be quoted if the path contains spaces. This is because a
|
||
space would otherwise indicate the end of an argument.</p>
|
||
|
||
<div class="note">
|
||
<p>Be careful with the <var>directory-path</var> arguments:
|
||
They have to literally match the filesystem path which Apache httpd uses
|
||
to access the files. Directives applied to a particular
|
||
<code><Directory></code> will not apply to files accessed from
|
||
that same directory via a different path, such as via different symbolic
|
||
links.</p>
|
||
</div>
|
||
|
||
<p><a class="glossarylink" href="../glossary.html#regex" title="see glossary">Regular
|
||
expressions</a> can also be used, with the addition of the
|
||
<code>~</code> character. For example:</p>
|
||
|
||
<pre class="prettyprint lang-config"><Directory ~ "^/www/[0-9]{3}">
|
||
|
||
</Directory></pre>
|
||
|
||
|
||
<p>would match directories in <code>/www/</code> that consisted of
|
||
three numbers.</p>
|
||
|
||
<p>If multiple (non-regular expression) <code class="directive"><Directory></code> sections
|
||
match the directory (or one of its parents) containing a document,
|
||
then the directives are applied in the order of shortest match
|
||
first, interspersed with the directives from the <a href="#accessfilename">.htaccess</a> files. For example,
|
||
with</p>
|
||
|
||
<pre class="prettyprint lang-config"><Directory "/">
|
||
AllowOverride None
|
||
</Directory>
|
||
|
||
<Directory "/home">
|
||
AllowOverride FileInfo
|
||
</Directory></pre>
|
||
|
||
|
||
<p>for access to the document <code>/home/web/dir/doc.html</code>
|
||
the steps are:</p>
|
||
|
||
<ul>
|
||
<li>Apply directive <code>AllowOverride None</code>
|
||
(disabling <code>.htaccess</code> files).</li>
|
||
|
||
<li>Apply directive <code>AllowOverride FileInfo</code> (for
|
||
directory <code>/home</code>).</li>
|
||
|
||
<li>Apply any <code>FileInfo</code> directives in
|
||
<code>/home/.htaccess</code>, <code>/home/web/.htaccess</code> and
|
||
<code>/home/web/dir/.htaccess</code> in that order.</li>
|
||
</ul>
|
||
|
||
<p>Regular expressions are not considered until after all of the
|
||
normal sections have been applied. Then all of the regular
|
||
expressions are tested in the order they appeared in the
|
||
configuration file. For example, with</p>
|
||
|
||
<pre class="prettyprint lang-config"><Directory ~ "abc$">
|
||
# ... directives here ...
|
||
</Directory></pre>
|
||
|
||
|
||
<p>the regular expression section won't be considered until after
|
||
all normal <code class="directive"><Directory></code>s and
|
||
<code>.htaccess</code> files have been applied. Then the regular
|
||
expression will match on <code>/home/abc/public_html/abc</code> and
|
||
the corresponding <code class="directive"><Directory></code> will
|
||
be applied.</p>
|
||
|
||
<p><strong>Note that the default access for
|
||
<code><Directory "/"></code> is to permit all access.
|
||
This means that Apache httpd will serve any file mapped from an URL. It is
|
||
recommended that you change this with a block such
|
||
as</strong></p>
|
||
|
||
<pre class="prettyprint lang-config"><Directory "/">
|
||
Require all denied
|
||
</Directory></pre>
|
||
|
||
|
||
<p><strong>and then override this for directories you
|
||
<em>want</em> accessible. See the <a href="../misc/security_tips.html">Security Tips</a> page for more
|
||
details.</strong></p>
|
||
|
||
<p>The directory sections occur in the <code>httpd.conf</code> file.
|
||
<code class="directive"><Directory></code> directives
|
||
cannot nest, and cannot appear in a <code class="directive"><a href="#limit"><Limit></a></code> or <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> section.</p>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><a href="../sections.html">How <Directory>,
|
||
<Location> and <Files> sections work</a> for an
|
||
explanation of how these different sections are combined when a
|
||
request is received</li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="DirectoryMatch" id="DirectoryMatch"><DirectoryMatch></a> <a name="directorymatch" id="directorymatch">Directive</a> <a title="Permanent link" href="#directorymatch" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose directives that apply to
|
||
the contents of file-system directories matching a regular expression.</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><DirectoryMatch <var>regex</var>>
|
||
... </DirectoryMatch></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p><code class="directive"><DirectoryMatch></code> and
|
||
<code></DirectoryMatch></code> are used to enclose a group
|
||
of directives which will apply only to the named directory (and the files within),
|
||
the same as <code class="directive"><a href="#directory"><Directory></a></code>.
|
||
However, it takes as an argument a
|
||
<a class="glossarylink" href="../glossary.html#regex" title="see glossary">regular expression</a>. For example:</p>
|
||
|
||
<pre class="prettyprint lang-config"><DirectoryMatch "^/www/(.+/)?[0-9]{3}/">
|
||
# ...
|
||
</DirectoryMatch></pre>
|
||
|
||
|
||
<p>matches directories in <code>/www/</code> (or any subdirectory thereof)
|
||
that consist of three numbers.</p>
|
||
|
||
<div class="note"><h3>Compatibility</h3>
|
||
Prior to 2.3.9, this directive implicitly applied to sub-directories
|
||
(like <code class="directive"><a href="#directory"><Directory></a></code>) and
|
||
could not match the end of line symbol ($). In 2.3.9 and later,
|
||
only directories that match the expression are affected by the enclosed
|
||
directives.
|
||
</div>
|
||
|
||
<div class="note"><h3>Trailing Slash</h3>
|
||
This directive applies to requests for directories that may or may
|
||
not end in a trailing slash, so expressions that are anchored to the
|
||
end of line ($) must be written with care.
|
||
</div>
|
||
|
||
<p>From 2.4.8 onwards, named groups and backreferences are captured and
|
||
written to the environment with the corresponding name prefixed with
|
||
"MATCH_" and in upper case. This allows elements of paths to be referenced
|
||
from within <a href="../expr.html">expressions</a> and modules like
|
||
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. In order to prevent confusion, numbered
|
||
(unnamed) backreferences are ignored. Use named groups instead.</p>
|
||
|
||
<pre class="prettyprint lang-config"><DirectoryMatch "^/var/www/combined/(?<sitename>[^/]+)">
|
||
Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
|
||
</DirectoryMatch></pre>
|
||
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#directory"><Directory></a></code> for
|
||
a description of how regular expressions are mixed in with normal
|
||
<code class="directive"><Directory></code>s</li>
|
||
<li><a href="../sections.html">How <Directory>, <Location> and
|
||
<Files> sections work</a> for an explanation of how these different
|
||
sections are combined when a request is received</li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="DocumentRoot" id="DocumentRoot">DocumentRoot</a> <a name="documentroot" id="documentroot">Directive</a> <a title="Permanent link" href="#documentroot" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory that forms the main document tree visible
|
||
from the web</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DocumentRoot <var>directory-path</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DocumentRoot "/usr/local/apache/htdocs"</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>This directive sets the directory from which <code class="program"><a href="../programs/httpd.html">httpd</a></code>
|
||
will serve files. Unless matched by a directive like <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>, the server appends the
|
||
path from the requested URL to the document root to make the
|
||
path to the document. Example:</p>
|
||
|
||
<pre class="prettyprint lang-config">DocumentRoot "/usr/web"</pre>
|
||
|
||
|
||
<p>then an access to
|
||
<code>http://my.example.com/index.html</code> refers to
|
||
<code>/usr/web/index.html</code>. If the <var>directory-path</var> is
|
||
not absolute then it is assumed to be relative to the <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>
|
||
|
||
<p>The <code class="directive">DocumentRoot</code> should be specified without
|
||
a trailing slash.</p>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><a href="../urlmapping.html#documentroot">Mapping URLs to Filesystem
|
||
Locations</a></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="Else" id="Else"><Else></a> <a name="else" id="else">Directive</a> <a title="Permanent link" href="#else" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply only if the condition of a
|
||
previous <code class="directive"><a href="#if"><If></a></code> or
|
||
<code class="directive"><a href="#elseif"><ElseIf></a></code> section is not
|
||
satisfied by a request at runtime</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Else> ... </Else></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Nested conditions are evaluated in 2.4.26 and later</td></tr>
|
||
</table>
|
||
<p>The <code class="directive"><Else></code> applies the enclosed
|
||
directives if and only if the most recent
|
||
<code class="directive"><If></code> or
|
||
<code class="directive"><ElseIf></code> section
|
||
in the same scope has not been applied.
|
||
For example: In </p>
|
||
|
||
<pre class="prettyprint lang-config"><If "-z req('Host')">
|
||
# ...
|
||
</If>
|
||
<Else>
|
||
# ...
|
||
</Else></pre>
|
||
|
||
|
||
<p> The <code class="directive"><If></code> would match HTTP/1.0
|
||
requests without a <var>Host:</var> header and the
|
||
<code class="directive"><Else></code> would match requests
|
||
with a <var>Host:</var> header.</p>
|
||
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#if"><If></a></code></li>
|
||
<li><code class="directive"><a href="#elseif"><ElseIf></a></code></li>
|
||
<li><a href="../sections.html">How <Directory>, <Location>,
|
||
<Files> sections work</a> for an explanation of how these
|
||
different sections are combined when a request is received.
|
||
<code class="directive"><If></code>,
|
||
<code class="directive"><ElseIf></code>, and
|
||
<code class="directive"><Else></code> are applied last.</li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="ElseIf" id="ElseIf"><ElseIf></a> <a name="elseif" id="elseif">Directive</a> <a title="Permanent link" href="#elseif" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply only if a condition is satisfied
|
||
by a request at runtime while the condition of a previous
|
||
<code class="directive"><a href="#if"><If></a></code> or
|
||
<code class="directive"><ElseIf></code> section is not
|
||
satisfied</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><ElseIf <var>expression</var>> ... </ElseIf></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Nested conditions are evaluated in 2.4.26 and later</td></tr>
|
||
</table>
|
||
<p>The <code class="directive"><ElseIf></code> applies the enclosed
|
||
directives if and only if both the given condition evaluates to true and
|
||
the most recent <code class="directive"><If></code> or
|
||
<code class="directive"><ElseIf></code> section in the same scope has
|
||
not been applied. For example: In </p>
|
||
|
||
<pre class="prettyprint lang-config"><If "-R '10.1.0.0/16'">
|
||
#...
|
||
</If>
|
||
<ElseIf "-R '10.0.0.0/8'">
|
||
#...
|
||
</ElseIf>
|
||
<Else>
|
||
#...
|
||
</Else></pre>
|
||
|
||
|
||
<p>The <code class="directive"><ElseIf></code> would match if
|
||
the remote address of a request belongs to the subnet 10.0.0.0/8 but
|
||
not to the subnet 10.1.0.0/16.</p>
|
||
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><a href="../expr.html">Expressions in Apache HTTP Server</a>,
|
||
for a complete reference and more examples.</li>
|
||
<li><code class="directive"><a href="#if"><If></a></code></li>
|
||
<li><code class="directive"><a href="#else"><Else></a></code></li>
|
||
<li><a href="../sections.html">How <Directory>, <Location>,
|
||
<Files> sections work</a> for an explanation of how these
|
||
different sections are combined when a request is received.
|
||
<code class="directive"><If></code>,
|
||
<code class="directive"><ElseIf></code>, and
|
||
<code class="directive"><Else></code> are applied last.</li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="EnableMMAP" id="EnableMMAP">EnableMMAP</a> <a name="enablemmap" id="enablemmap">Directive</a> <a title="Permanent link" href="#enablemmap" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use memory-mapping to read files during delivery</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>EnableMMAP On|Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>EnableMMAP On</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>This directive controls whether the <code class="program"><a href="../programs/httpd.html">httpd</a></code> may use
|
||
memory-mapping if it needs to read the contents of a file during
|
||
delivery. By default, when the handling of a request requires
|
||
access to the data within a file -- for example, when delivering a
|
||
server-parsed file using <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> -- Apache httpd
|
||
memory-maps the file if the OS supports it.</p>
|
||
|
||
<p>This memory-mapping sometimes yields a performance improvement.
|
||
But in some environments, it is better to disable the memory-mapping
|
||
to prevent operational problems:</p>
|
||
|
||
<ul>
|
||
<li>On some multiprocessor systems, memory-mapping can reduce the
|
||
performance of the <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</li>
|
||
<li>Deleting or truncating a file while <code class="program"><a href="../programs/httpd.html">httpd</a></code>
|
||
has it memory-mapped can cause <code class="program"><a href="../programs/httpd.html">httpd</a></code> to
|
||
crash with a segmentation fault.
|
||
</li>
|
||
</ul>
|
||
|
||
<p>For server configurations that are vulnerable to these problems,
|
||
you should disable memory-mapping of delivered files by specifying:</p>
|
||
|
||
<pre class="prettyprint lang-config">EnableMMAP Off</pre>
|
||
|
||
|
||
<p>For NFS mounted files, this feature may be disabled explicitly for
|
||
the offending files by specifying:</p>
|
||
|
||
<pre class="prettyprint lang-config"><Directory "/path-to-nfs-files">
|
||
EnableMMAP Off
|
||
</Directory></pre>
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="EnableSendfile" id="EnableSendfile">EnableSendfile</a> <a name="enablesendfile" id="enablesendfile">Directive</a> <a title="Permanent link" href="#enablesendfile" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use the kernel sendfile support to deliver files to the client</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>EnableSendfile On|Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>EnableSendfile Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Default changed to Off in
|
||
version 2.3.9.</td></tr>
|
||
</table>
|
||
<p>This directive controls whether <code class="program"><a href="../programs/httpd.html">httpd</a></code> may use the
|
||
sendfile support from the kernel to transmit file contents to the client.
|
||
By default, when the handling of a request requires no access
|
||
to the data within a file -- for example, when delivering a
|
||
static file -- Apache httpd uses sendfile to deliver the file contents
|
||
without ever reading the file if the OS supports it.</p>
|
||
|
||
<p>This sendfile mechanism avoids separate read and send operations,
|
||
and buffer allocations. But on some platforms or within some
|
||
filesystems, it is better to disable this feature to avoid
|
||
operational problems:</p>
|
||
|
||
<ul>
|
||
<li>Some platforms may have broken sendfile support that the build
|
||
system did not detect, especially if the binaries were built on
|
||
another box and moved to such a machine with broken sendfile
|
||
support.</li>
|
||
<li>On Linux the use of sendfile triggers TCP-checksum
|
||
offloading bugs on certain networking cards when using IPv6.</li>
|
||
<li>On Linux on Itanium, <code>sendfile</code> may be unable to handle
|
||
files over 2GB in size.</li>
|
||
<li>With a network-mounted <code class="directive"><a href="#documentroot">DocumentRoot</a></code> (e.g., NFS, SMB, CIFS, FUSE),
|
||
the kernel may be unable to serve the network file through
|
||
its own cache.</li>
|
||
</ul>
|
||
|
||
<p>For server configurations that are not vulnerable to these problems,
|
||
you may enable this feature by specifying:</p>
|
||
|
||
<pre class="prettyprint lang-config">EnableSendfile On</pre>
|
||
|
||
|
||
<p>For network mounted files, this feature may be disabled explicitly
|
||
for the offending files by specifying:</p>
|
||
|
||
<pre class="prettyprint lang-config"><Directory "/path-to-nfs-files">
|
||
EnableSendfile Off
|
||
</Directory></pre>
|
||
|
||
<p>Please note that the per-directory and .htaccess configuration
|
||
of <code class="directive">EnableSendfile</code> is not supported by
|
||
<code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code>.
|
||
Only global definition of <code class="directive">EnableSendfile</code>
|
||
is taken into account by the module.
|
||
</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="Error" id="Error">Error</a> <a name="error" id="error">Directive</a> <a title="Permanent link" href="#error" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Abort configuration parsing with a custom error message</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Error <var>message</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>2.3.9 and later</td></tr>
|
||
</table>
|
||
<p>If an error can be detected within the configuration, this
|
||
directive can be used to generate a custom error message, and halt
|
||
configuration parsing. The typical use is for reporting required
|
||
modules which are missing from the configuration.</p>
|
||
|
||
<pre class="prettyprint lang-config"># Example
|
||
# ensure that mod_include is loaded
|
||
<IfModule !include_module>
|
||
Error "mod_include is required by mod_foo. Load it with LoadModule."
|
||
</IfModule>
|
||
|
||
# ensure that exactly one of SSL,NOSSL is defined
|
||
<IfDefine SSL>
|
||
<IfDefine NOSSL>
|
||
Error "Both SSL and NOSSL are defined. Define only one of them."
|
||
</IfDefine>
|
||
</IfDefine>
|
||
<IfDefine !SSL>
|
||
<IfDefine !NOSSL>
|
||
Error "Either SSL or NOSSL must be defined."
|
||
</IfDefine>
|
||
</IfDefine></pre>
|
||
|
||
|
||
<div class="warning"><h3>Note</h3>
|
||
<p> This directive is evaluated at configuration processing time,
|
||
not at runtime. As a result, this directive cannot be conditonally
|
||
evaluated by enclosing it in an <code class="directive"><a href="#if"><If></a></code> section.</p>
|
||
</div>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="ErrorDocument" id="ErrorDocument">ErrorDocument</a> <a name="errordocument" id="errordocument">Directive</a> <a title="Permanent link" href="#errordocument" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>What the server will return to the client
|
||
in case of an error</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ErrorDocument <var>error-code</var> <var>document</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>In the event of a problem or error, Apache httpd can be configured
|
||
to do one of four things,</p>
|
||
|
||
<ol>
|
||
<li>output a simple hardcoded error message</li>
|
||
|
||
<li>output a customized message</li>
|
||
|
||
<li>internally redirect to a local <var>URL-path</var> to handle the
|
||
problem/error</li>
|
||
|
||
<li>redirect to an external <var>URL</var> to handle the
|
||
problem/error</li>
|
||
</ol>
|
||
|
||
<p>The first option is the default, while options 2-4 are
|
||
configured using the <code class="directive">ErrorDocument</code>
|
||
directive, which is followed by the HTTP response code and a URL
|
||
or a message. Apache httpd will sometimes offer additional information
|
||
regarding the problem/error.</p>
|
||
|
||
<p>From 2.4.13, <a href="../expr.html">expression syntax</a> can be
|
||
used inside the directive to produce dynamic strings and URLs.</p>
|
||
|
||
<p>URLs can begin with a slash (/) for local web-paths (relative
|
||
to the <code class="directive"><a href="#documentroot">DocumentRoot</a></code>), or be a
|
||
full URL which the client can resolve. Alternatively, a message
|
||
can be provided to be displayed by the browser. Note that deciding
|
||
whether the parameter is an URL, a path or a message is performed
|
||
before any expression is parsed. Examples:</p>
|
||
|
||
<pre class="prettyprint lang-config">ErrorDocument 500 http://example.com/cgi-bin/server-error.cgi
|
||
ErrorDocument 404 /errors/bad_urls.php
|
||
ErrorDocument 401 /subscription_info.html
|
||
ErrorDocument 403 "Sorry, can't allow you access today"
|
||
ErrorDocument 403 Forbidden!
|
||
ErrorDocument 403 /errors/forbidden.py?referrer=%{escape:%{HTTP_REFERER}}</pre>
|
||
|
||
|
||
<p>Additionally, the special value <code>default</code> can be used
|
||
to specify Apache httpd's simple hardcoded message. While not required
|
||
under normal circumstances, <code>default</code> will restore
|
||
Apache httpd's simple hardcoded message for configurations that would
|
||
otherwise inherit an existing <code class="directive">ErrorDocument</code>.</p>
|
||
|
||
<pre class="prettyprint lang-config">ErrorDocument 404 /cgi-bin/bad_urls.pl
|
||
|
||
<Directory "/web/docs">
|
||
ErrorDocument 404 default
|
||
</Directory></pre>
|
||
|
||
|
||
<p>Note that when you specify an <code class="directive">ErrorDocument</code>
|
||
that points to a remote URL (ie. anything with a method such as
|
||
<code>http</code> in front of it), Apache HTTP Server will send a redirect to the
|
||
client to tell it where to find the document, even if the
|
||
document ends up being on the same server. This has several
|
||
implications, the most important being that the client will not
|
||
receive the original error status code, but instead will
|
||
receive a redirect status code. This in turn can confuse web
|
||
robots and other clients which try to determine if a URL is
|
||
valid using the status code. In addition, if you use a remote
|
||
URL in an <code>ErrorDocument 401</code>, the client will not
|
||
know to prompt the user for a password since it will not
|
||
receive the 401 status code. Therefore, <strong>if you use an
|
||
<code>ErrorDocument 401</code> directive, then it must refer to a local
|
||
document.</strong></p>
|
||
|
||
<p>Microsoft Internet Explorer (MSIE) will by default ignore
|
||
server-generated error messages when they are "too small" and substitute
|
||
its own "friendly" error messages. The size threshold varies depending on
|
||
the type of error, but in general, if you make your error document
|
||
greater than 512 bytes, then MSIE will show the server-generated
|
||
error rather than masking it. More information is available in
|
||
Microsoft Knowledge Base article <a href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807">Q294807</a>.</p>
|
||
|
||
<p>Although most error messages can be overridden, there are certain
|
||
circumstances where the internal messages are used regardless of the
|
||
setting of <code class="directive">ErrorDocument</code>. In
|
||
particular, if a malformed request is detected, normal request processing
|
||
will be immediately halted and the internal error message returned.
|
||
This is necessary to guard against security problems caused by
|
||
bad requests.</p>
|
||
|
||
<p>If you are using mod_proxy, you may wish to enable
|
||
<code class="directive"><a href="../mod/mod_proxy.html#proxyerroroverride">ProxyErrorOverride</a></code> so that you can provide
|
||
custom error messages on behalf of your Origin servers. If you don't enable ProxyErrorOverride,
|
||
Apache httpd will not generate custom error documents for proxied content.</p>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><a href="../custom-error.html">documentation of
|
||
customizable responses</a></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="ErrorLog" id="ErrorLog">ErrorLog</a> <a name="errorlog" id="errorlog">Directive</a> <a title="Permanent link" href="#errorlog" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Location where the server will log errors</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code> ErrorLog <var>file-path</var>|syslog[:[<var>facility</var>][:<var>tag</var>]]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows and OS/2)</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>The <code class="directive">ErrorLog</code> directive sets the name of
|
||
the file to which the server will log any errors it encounters. If
|
||
the <var>file-path</var> is not absolute then it is assumed to be
|
||
relative to the <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>
|
||
|
||
<pre class="prettyprint lang-config">ErrorLog "/var/log/httpd/error_log"</pre>
|
||
|
||
|
||
<p>If the <var>file-path</var>
|
||
begins with a pipe character "<code>|</code>" then it is assumed to be a
|
||
command to spawn to handle the error log.</p>
|
||
|
||
<pre class="prettyprint lang-config">ErrorLog "|/usr/local/bin/httpd_errors"</pre>
|
||
|
||
|
||
<p>See the notes on <a href="../logs.html#piped">piped logs</a> for
|
||
more information.</p>
|
||
|
||
<p>Using <code>syslog</code> instead of a filename enables logging
|
||
via syslogd(8) if the system supports it and if <code class="module"><a href="../mod/mod_syslog.html">mod_syslog</a></code>
|
||
is loaded. The default is to use syslog facility <code>local7</code>,
|
||
but you can override this by using the <code>syslog:<var>facility</var></code>
|
||
syntax where <var>facility</var> can be one of the names usually documented in
|
||
syslog(1). The facility is effectively global, and if it is changed
|
||
in individual virtual hosts, the final facility specified affects the
|
||
entire server. Same rules apply for the syslog tag, which by default
|
||
uses the Apache binary name, <code>httpd</code> in most cases. You can
|
||
also override this by using the <code>syslog::<var>tag</var></code>
|
||
syntax.</p>
|
||
|
||
<pre class="prettyprint lang-config">ErrorLog syslog:user
|
||
ErrorLog syslog:user:httpd.srv1
|
||
ErrorLog syslog::httpd.srv2</pre>
|
||
|
||
|
||
<p>Additional modules can provide their own ErrorLog providers. The syntax
|
||
is similar to the <code>syslog</code> example above.</p>
|
||
|
||
<p>SECURITY: See the <a href="../misc/security_tips.html#serverroot">security tips</a>
|
||
document for details on why your security could be compromised
|
||
if the directory where log files are stored is writable by
|
||
anyone other than the user that starts the server.</p>
|
||
<div class="warning"><h3>Note</h3>
|
||
<p>When entering a file path on non-Unix platforms, care should be taken
|
||
to make sure that only forward slashes are used even though the platform
|
||
may allow the use of back slashes. In general it is a good idea to always
|
||
use forward slashes throughout the configuration files.</p>
|
||
</div>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#loglevel">LogLevel</a></code></li>
|
||
<li><a href="../logs.html">Apache HTTP Server Log Files</a></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="ErrorLogFormat" id="ErrorLogFormat">ErrorLogFormat</a> <a name="errorlogformat" id="errorlogformat">Directive</a> <a title="Permanent link" href="#errorlogformat" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Format specification for error log entries</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code> ErrorLogFormat [connection|request] <var>format</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p><code class="directive">ErrorLogFormat</code> allows to specify what
|
||
supplementary information is logged in the error log in addition to the
|
||
actual log message.</p>
|
||
|
||
<pre class="prettyprint lang-config">#Simple example
|
||
ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M"</pre>
|
||
|
||
|
||
<p>Specifying <code>connection</code> or <code>request</code> as first
|
||
parameter allows to specify additional formats, causing additional
|
||
information to be logged when the first message is logged for a specific
|
||
connection or request, respectively. This additional information is only
|
||
logged once per connection/request. If a connection or request is processed
|
||
without causing any log message, the additional information is not logged
|
||
either.</p>
|
||
|
||
<p>It can happen that some format string items do not produce output. For
|
||
example, the Referer header is only present if the log message is
|
||
associated to a request and the log message happens at a time when the
|
||
Referer header has already been read from the client. If no output is
|
||
produced, the default behavior is to delete everything from the preceding
|
||
space character to the next space character. This means the log line is
|
||
implicitly divided into fields on non-whitespace to whitespace transitions.
|
||
If a format string item does not produce output, the whole field is
|
||
omitted. For example, if the remote address <code>%a</code> in the log
|
||
format <code>[%t] [%l] [%a] %M </code> is not available, the surrounding
|
||
brackets are not logged either. Space characters can be escaped with a
|
||
backslash to prevent them from delimiting a field. The combination '% '
|
||
(percent space) is a zero-width field delimiter that does not produce any
|
||
output.</p>
|
||
|
||
<p>The above behavior can be changed by adding modifiers to the format
|
||
string item. A <code>-</code> (minus) modifier causes a minus to be logged if the
|
||
respective item does not produce any output. In once-per-connection/request
|
||
formats, it is also possible to use the <code>+</code> (plus) modifier. If an
|
||
item with the plus modifier does not produce any output, the whole line is
|
||
omitted.</p>
|
||
|
||
<p>A number as modifier can be used to assign a log severity level to a
|
||
format item. The item will only be logged if the severity of the log
|
||
message is not higher than the specified log severity level. The number can
|
||
range from 1 (alert) over 4 (warn) and 7 (debug) to 15 (trace8).</p>
|
||
|
||
<p>For example, here's what would happen if you added modifiers to
|
||
the <code>%{Referer}i</code> token, which logs the
|
||
<code>Referer</code> request header.</p>
|
||
|
||
<table class="bordered"><tr class="header"><th>Modified Token</th><th>Meaning</th></tr>
|
||
<tr>
|
||
<td><code>%-{Referer}i</code></td>
|
||
<td>Logs a <code>-</code> if <code>Referer</code> is not set.</td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td><code>%+{Referer}i</code></td>
|
||
<td>Omits the entire line if <code>Referer</code> is not set.</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>%4{Referer}i</code></td>
|
||
<td>Logs the <code>Referer</code> only if the log message severity
|
||
is higher than 4.</td>
|
||
</tr>
|
||
</table>
|
||
|
||
<p>Some format string items accept additional parameters in braces.</p>
|
||
|
||
<table class="bordered"><tr class="header"><th>Format String</th> <th>Description</th></tr>
|
||
<tr><td><code>%%</code></td>
|
||
<td>The percent sign</td></tr>
|
||
<tr class="odd"><td><code>%a</code></td>
|
||
<td>Client IP address and port of the request</td></tr>
|
||
<tr><td><code>%{c}a</code></td>
|
||
<td>Underlying peer IP address and port of the connection (see the
|
||
<code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> module)</td></tr>
|
||
<tr class="odd"><td><code>%A</code></td>
|
||
<td>Local IP-address and port</td></tr>
|
||
<tr><td><code>%{<em>name</em>}e</code></td>
|
||
<td>Request environment variable <em>name</em></td></tr>
|
||
<tr class="odd"><td><code>%E</code></td>
|
||
<td>APR/OS error status code and string</td></tr>
|
||
<tr><td><code>%F</code></td>
|
||
<td>Source file name and line number of the log call</td></tr>
|
||
<tr class="odd"><td><code>%{<em>name</em>}i</code></td>
|
||
<td>Request header <em>name</em></td></tr>
|
||
<tr><td><code>%k</code></td>
|
||
<td>Number of keep-alive requests on this connection</td></tr>
|
||
<tr class="odd"><td><code>%l</code></td>
|
||
<td>Loglevel of the message</td></tr>
|
||
<tr><td><code>%L</code></td>
|
||
<td>Log ID of the request</td></tr>
|
||
<tr class="odd"><td><code>%{c}L</code></td>
|
||
<td>Log ID of the connection</td></tr>
|
||
<tr><td><code>%{C}L</code></td>
|
||
<td>Log ID of the connection if used in connection scope, empty otherwise</td></tr>
|
||
<tr class="odd"><td><code>%m</code></td>
|
||
<td>Name of the module logging the message</td></tr>
|
||
<tr><td><code>%M</code></td>
|
||
<td>The actual log message</td></tr>
|
||
<tr class="odd"><td><code>%{<em>name</em>}n</code></td>
|
||
<td>Request note <em>name</em></td></tr>
|
||
<tr><td><code>%P</code></td>
|
||
<td>Process ID of current process</td></tr>
|
||
<tr class="odd"><td><code>%T</code></td>
|
||
<td>Thread ID of current thread</td></tr>
|
||
<tr><td><code>%{g}T</code></td>
|
||
<td>System unique thread ID of current thread (the same ID as
|
||
displayed by e.g. <code>top</code>; currently Linux only)</td></tr>
|
||
<tr class="odd"><td><code>%t</code></td>
|
||
<td>The current time</td></tr>
|
||
<tr><td><code>%{u}t</code></td>
|
||
<td>The current time including micro-seconds</td></tr>
|
||
<tr class="odd"><td><code>%{cu}t</code></td>
|
||
<td>The current time in ISO 8601 extended format (compact), including
|
||
micro-seconds</td></tr>
|
||
<tr><td><code>%{cuz}t</code></td>
|
||
<td>The current time in ISO 8601 extended format (compact), including
|
||
micro-seconds and time zone in the ISO 8601:2000 standard format.
|
||
Available since 2.4.58 only</td></tr>
|
||
<tr class="odd"><td><code>%{%-format}t</code></td>
|
||
<td>The current time formatted per the <code>strftime(3)</code> function.
|
||
Available since 2.4.58 only</td></tr>
|
||
<tr><td><code>%v</code></td>
|
||
<td>The canonical <code class="directive"><a href="#servername">ServerName</a></code>
|
||
of the current server.</td></tr>
|
||
<tr class="odd"><td><code>%V</code></td>
|
||
<td>The server name of the server serving the request according to the
|
||
<code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code>
|
||
setting.</td></tr>
|
||
<tr><td><code>\ </code> (backslash space)</td>
|
||
<td>Non-field delimiting space</td></tr>
|
||
<tr class="odd"><td><code>% </code> (percent space)</td>
|
||
<td>Field delimiter (no output)</td></tr>
|
||
</table>
|
||
|
||
<p>The log ID format <code>%L</code> produces a unique id for a connection
|
||
or request. This can be used to correlate which log lines belong to the
|
||
same connection or request, which request happens on which connection.
|
||
A <code>%L</code> format string is also available in
|
||
<code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> to allow to correlate access log entries
|
||
with error log lines. If <code class="module"><a href="../mod/mod_unique_id.html">mod_unique_id</a></code> is loaded, its
|
||
unique id will be used as log ID for requests.</p>
|
||
|
||
<pre class="prettyprint lang-config">#Example (default format for threaded MPMs)
|
||
ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"</pre>
|
||
|
||
|
||
<p>This would result in error messages such as:</p>
|
||
|
||
<div class="example"><p><code>
|
||
[Thu May 12 08:28:57.652118 2011] [core:error] [pid 8777:tid 4326490112] [client ::1:58619] File does not exist: /usr/local/apache2/htdocs/favicon.ico
|
||
</code></p></div>
|
||
|
||
<p>Notice that, as discussed above, some fields are omitted
|
||
entirely because they are not defined.</p>
|
||
|
||
<pre class="prettyprint lang-config">#Example (similar to the 2.2.x format)
|
||
ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"</pre>
|
||
|
||
|
||
<pre class="prettyprint lang-config">#Advanced example with request/connection log IDs
|
||
ErrorLogFormat "[%{uc}t] [%-m:%-l] [R:%L] [C:%{C}L] %7F: %E: %M"
|
||
ErrorLogFormat request "[%{uc}t] [R:%L] Request %k on C:%{c}L pid:%P tid:%T"
|
||
ErrorLogFormat request "[%{uc}t] [R:%L] UA:'%+{User-Agent}i'"
|
||
ErrorLogFormat request "[%{uc}t] [R:%L] Referer:'%+{Referer}i'"
|
||
ErrorLogFormat connection "[%{uc}t] [C:%{c}L] remote\ %a local\ %A"</pre>
|
||
|
||
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#errorlog">ErrorLog</a></code></li>
|
||
<li><code class="directive"><a href="#loglevel">LogLevel</a></code></li>
|
||
<li><a href="../logs.html">Apache HTTP Server Log Files</a></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="ExtendedStatus" id="ExtendedStatus">ExtendedStatus</a> <a name="extendedstatus" id="extendedstatus">Directive</a> <a title="Permanent link" href="#extendedstatus" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Keep track of extended status information for each
|
||
request</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ExtendedStatus On|Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ExtendedStatus Off[*]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>This option tracks additional data per worker about the
|
||
currently executing request and creates a utilization summary.
|
||
You can see these variables during runtime by configuring
|
||
<code class="module"><a href="../mod/mod_status.html">mod_status</a></code>. Note that other modules may
|
||
rely on this scoreboard.</p>
|
||
|
||
<p>This setting applies to the entire server and cannot be
|
||
enabled or disabled on a virtualhost-by-virtualhost basis.
|
||
The collection of extended status information can slow down
|
||
the server. Also note that this setting cannot be changed
|
||
during a graceful restart.</p>
|
||
|
||
<div class="note">
|
||
<p>Note that loading <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> will change
|
||
the default behavior to ExtendedStatus On, while other
|
||
third party modules may do the same. Such modules rely on
|
||
collecting detailed information about the state of all workers.
|
||
The default is changed by <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> beginning
|
||
with version 2.3.6. The previous default was always Off.</p>
|
||
</div>
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="FileETag" id="FileETag">FileETag</a> <a name="fileetag" id="fileetag">Directive</a> <a title="Permanent link" href="#fileetag" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File attributes used to create the ETag
|
||
HTTP response header for static files</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FileETag <var>component</var> ...</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>FileETag MTime Size</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>The default used to be "INode MTime Size" in 2.3.14 and
|
||
earlier.</td></tr>
|
||
</table>
|
||
<p>
|
||
The <code class="directive">FileETag</code> directive configures the file
|
||
attributes that are used to create the <code>ETag</code> (entity
|
||
tag) response header field when the document is based on a static file.
|
||
(The <code>ETag</code> value is used in cache management to save
|
||
network bandwidth.) The
|
||
<code class="directive">FileETag</code> directive allows you to choose
|
||
which of these -- if any -- should be used. The recognized keywords are:
|
||
</p>
|
||
|
||
<dl>
|
||
<dt><strong>INode</strong></dt>
|
||
<dd>The file's i-node number will be included in the calculation</dd>
|
||
<dt><strong>MTime</strong></dt>
|
||
<dd>The date and time the file was last modified will be included</dd>
|
||
<dt><strong>Size</strong></dt>
|
||
<dd>The number of bytes in the file will be included</dd>
|
||
<dt><strong>All</strong></dt>
|
||
<dd>All available fields will be used. This is equivalent to:
|
||
<pre class="prettyprint lang-config">FileETag INode MTime Size</pre>
|
||
</dd>
|
||
<dt><strong>Digest</strong></dt>
|
||
<dd>If a document is file-based, the <code>ETag</code> field will be
|
||
calculated by taking the digest over the file.</dd>
|
||
<dt><strong>None</strong></dt>
|
||
<dd>If a document is file-based, no <code>ETag</code> field will be
|
||
included in the response</dd>
|
||
</dl>
|
||
|
||
<p>The <code>INode</code>, <code>MTime</code>, <code>Size</code> and
|
||
<code>Digest</code> keywords may be prefixed with either <code>+</code>
|
||
or <code>-</code>, which allow changes to be made to the default setting
|
||
inherited from a broader scope. Any keyword appearing without such a prefix
|
||
immediately and completely cancels the inherited setting.</p>
|
||
|
||
<p>If a directory's configuration includes
|
||
<code>FileETag INode MTime Size</code>, and a
|
||
subdirectory's includes <code>FileETag -INode</code>,
|
||
the setting for that subdirectory (which will be inherited by
|
||
any sub-subdirectories that don't override it) will be equivalent to
|
||
<code>FileETag MTime Size</code>.</p>
|
||
<div class="note"><h3>Server Side Includes</h3>
|
||
An ETag is not generated for responses parsed by <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>
|
||
since the response entity can change without a change of the INode, MTime,
|
||
Size or Digest of the static file with embedded SSI directives.
|
||
</div>
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="Files" id="Files"><Files></a> <a name="files" id="files">Directive</a> <a title="Permanent link" href="#files" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply to matched
|
||
filenames</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Files <var>filename</var>> ... </Files></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>The <code class="directive"><Files></code> directive
|
||
limits the scope of the enclosed directives by filename. It is comparable
|
||
to the <code class="directive"><a href="#directory"><Directory></a></code>
|
||
and <code class="directive"><a href="#location"><Location></a></code>
|
||
directives. It should be matched with a <code></Files></code>
|
||
directive. The directives given within this section will be applied to
|
||
any object with a basename (last component of filename) matching the
|
||
specified filename. <code class="directive"><Files></code>
|
||
sections are processed in the order they appear in the
|
||
configuration file, after the <code class="directive"><a href="#directory"><Directory></a></code> sections and
|
||
<code>.htaccess</code> files are read, but before <code class="directive"><a href="#location"><Location></a></code> sections. Note
|
||
that <code class="directive"><Files></code> can be nested
|
||
inside <code class="directive"><a href="#directory"><Directory></a></code> sections to restrict the
|
||
portion of the filesystem they apply to.</p>
|
||
|
||
<p>The <var>filename</var> argument should include a filename, or
|
||
a wild-card string, where <code>?</code> matches any single character,
|
||
and <code>*</code> matches any sequences of characters.</p>
|
||
<pre class="prettyprint lang-config"><Files "cat.html">
|
||
# Insert stuff that applies to cat.html here
|
||
</Files>
|
||
|
||
<Files "?at.*">
|
||
# This would apply to cat.html, bat.html, hat.php and so on.
|
||
</Files></pre>
|
||
|
||
<p><a class="glossarylink" href="../glossary.html#regex" title="see glossary">Regular expressions</a>
|
||
can also be used, with the addition of the
|
||
<code>~</code> character. For example:</p>
|
||
|
||
<pre class="prettyprint lang-config"><Files ~ "\.(gif|jpe?g|png)$">
|
||
#...
|
||
</Files></pre>
|
||
|
||
|
||
<p>would match most common Internet graphics formats. <code class="directive"><a href="#filesmatch"><FilesMatch></a></code> is preferred,
|
||
however.</p>
|
||
|
||
<p>Note that unlike <code class="directive"><a href="#directory"><Directory></a></code> and <code class="directive"><a href="#location"><Location></a></code> sections, <code class="directive"><Files></code> sections can be used inside
|
||
<code>.htaccess</code> files. This allows users to control access to
|
||
their own files, at a file-by-file level.</p>
|
||
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><a href="../sections.html">How <Directory>, <Location>
|
||
and <Files> sections work</a> for an explanation of how these
|
||
different sections are combined when a request is received</li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="FilesMatch" id="FilesMatch"><FilesMatch></a> <a name="filesmatch" id="filesmatch">Directive</a> <a title="Permanent link" href="#filesmatch" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply to regular-expression matched
|
||
filenames</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><FilesMatch <var>regex</var>> ... </FilesMatch></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>The <code class="directive"><FilesMatch></code> directive
|
||
limits the scope of the enclosed directives by filename, just as the
|
||
<code class="directive"><a href="#files"><Files></a></code> directive
|
||
does. However, it accepts a <a class="glossarylink" href="../glossary.html#regex" title="see glossary">regular
|
||
expression</a>. For example:</p>
|
||
|
||
<pre class="prettyprint lang-config"><FilesMatch ".+\.(gif|jpe?g|png)$">
|
||
# ...
|
||
</FilesMatch></pre>
|
||
|
||
|
||
<p>would match most common Internet graphics formats.</p>
|
||
|
||
<div class="note">The <code>.+</code> at the start of the regex ensures that
|
||
files named <code>.png</code>, or <code>.gif</code>, for example,
|
||
are not matched.</div>
|
||
|
||
<p>From 2.4.8 onwards, named groups and backreferences are captured and
|
||
written to the environment with the corresponding name prefixed with
|
||
"MATCH_" and in upper case. This allows elements of files to be referenced
|
||
from within <a href="../expr.html">expressions</a> and modules like
|
||
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. In order to prevent confusion, numbered
|
||
(unnamed) backreferences are ignored. Use named groups instead.</p>
|
||
|
||
<pre class="prettyprint lang-config"><FilesMatch "^(?<sitename>[^/]+)">
|
||
Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
|
||
</FilesMatch></pre>
|
||
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><a href="../sections.html">How <Directory>, <Location>
|
||
and <Files> sections work</a> for an explanation of how these
|
||
different sections are combined when a request is received</li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="FlushMaxPipelined" id="FlushMaxPipelined">FlushMaxPipelined</a> <a name="flushmaxpipelined" id="flushmaxpipelined">Directive</a> <a title="Permanent link" href="#flushmaxpipelined" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum number of pipelined responses above which they are flushed
|
||
to the network</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FlushMaxPipelined <var>number</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>FlushMaxPipelined 5</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>2.5 and later</td></tr>
|
||
</table>
|
||
<p>This directive allows to configure the maximum number of pipelined
|
||
responses, which remain pending so long as pipelined request are received.
|
||
When the limit is reached, responses are forcibly flushed to the network in
|
||
blocking mode, until passing under the limit again.</p>
|
||
|
||
<p><code class="directive">FlushMaxPipelined</code> helps constraining memory
|
||
usage. When set to <code>0</code> pipelining is disabled, when set to
|
||
<code>-1</code> there is no limit (<code class="directive"><a href="#flushmaxthreshold">FlushMaxThreshold</a></code>
|
||
still applies).</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="FlushMaxThreshold" id="FlushMaxThreshold">FlushMaxThreshold</a> <a name="flushmaxthreshold" id="flushmaxthreshold">Directive</a> <a title="Permanent link" href="#flushmaxthreshold" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Threshold above which pending data are flushed to the
|
||
network</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FlushMaxThreshold <var>number-of-bytes</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>FlushMaxThreshold 65535</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>2.5 and later</td></tr>
|
||
</table>
|
||
<p>This directive allows to configure the threshold for pending output
|
||
data (in bytes). When the limit is reached, data are forcibly flushed to
|
||
the network in blocking mode, until passing under the limit again.</p>
|
||
|
||
<p><code class="directive">FlushMaxThreshold</code> helps constraining memory
|
||
usage. When set to <code>0</code> or a too small value there are actually
|
||
no pending data, but for threaded MPMs there can be more threads busy
|
||
waiting for the network thus less ones available to handle the other
|
||
simultaneous connections.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="ForceType" id="ForceType">ForceType</a> <a name="forcetype" id="forcetype">Directive</a> <a title="Permanent link" href="#forcetype" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Forces all matching files to be served with the specified
|
||
media type in the HTTP Content-Type header field</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ForceType <var>media-type</var>|None</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>When placed into an <code>.htaccess</code> file or a
|
||
<code class="directive"><a href="#directory"><Directory></a></code>, or
|
||
<code class="directive"><a href="#location"><Location></a></code> or
|
||
<code class="directive"><a href="#files"><Files></a></code>
|
||
section, this directive forces all matching files to be served
|
||
with the content type identification given by
|
||
<var>media-type</var>. For example, if you had a directory full of
|
||
GIF files, but did not want to label them all with <code>.gif</code>,
|
||
you might want to use:</p>
|
||
|
||
<pre class="prettyprint lang-config">ForceType image/gif</pre>
|
||
|
||
|
||
<p>Note that this directive overrides other indirect media type
|
||
associations defined in mime.types or via the
|
||
<code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code>.</p>
|
||
|
||
<p>You can also override more general
|
||
<code class="directive">ForceType</code> settings
|
||
by using the value of <code>None</code>:</p>
|
||
|
||
<pre class="prettyprint lang-config"># force all files to be image/gif:
|
||
<Location "/images">
|
||
ForceType image/gif
|
||
</Location>
|
||
|
||
# but normal mime-type associations here:
|
||
<Location "/images/mixed">
|
||
ForceType None
|
||
</Location></pre>
|
||
|
||
|
||
<p>This directive primarily overrides the content types generated for
|
||
static files served out of the filesystem. For resources other than
|
||
static files, where the generator of the response typically specifies
|
||
a Content-Type, this directive has no effect.</p>
|
||
|
||
|
||
<div class="note"><h3>Note</h3>
|
||
<p>If no handler is explicitly set for a request, the specified content
|
||
type will also be used as the handler name. </p>
|
||
|
||
<p>When explicit directives such as
|
||
<code class="directive"><a href="#sethandler">SetHandler</a></code> or
|
||
<code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> do not apply
|
||
to the current request, the internal handler name normally set by those
|
||
directives is instead set to the content type specified by this directive.
|
||
</p>
|
||
<p>
|
||
This is a historical behavior that some third-party modules
|
||
(such as mod_php) may look for a "synthetic" content type used only to
|
||
signal the module to take responsibility for the matching request.
|
||
</p>
|
||
|
||
<p>Configurations that rely on such "synthetic" types should be avoided.
|
||
Additionally, configurations that restrict access to
|
||
<code class="directive"><a href="#sethandler">SetHandler</a></code> or
|
||
<code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> should
|
||
restrict access to this directive as well.</p>
|
||
</div>
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="GprofDir" id="GprofDir">GprofDir</a> <a name="gprofdir" id="gprofdir">Directive</a> <a title="Permanent link" href="#gprofdir" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory to write gmon.out profiling data to. </td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>GprofDir <var>/tmp/gprof/</var>|<var>/tmp/gprof/</var>%</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>When the server has been compiled with gprof profiling support,
|
||
<code class="directive">GprofDir</code> causes <code>gmon.out</code> files to
|
||
be written to the specified directory when the process exits. If the
|
||
argument ends with a percent symbol ('%'), subdirectories are created
|
||
for each process id.</p>
|
||
|
||
<p>This directive currently only works with the <code class="module"><a href="../mod/prefork.html">prefork</a></code>
|
||
MPM.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="HostnameLookups" id="HostnameLookups">HostnameLookups</a> <a name="hostnamelookups" id="hostnamelookups">Directive</a> <a title="Permanent link" href="#hostnamelookups" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables DNS lookups on client IP addresses</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>HostnameLookups On|Off|Double</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>HostnameLookups Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>This directive enables DNS lookups so that host names can be
|
||
logged (and passed to CGIs/SSIs in <code>REMOTE_HOST</code>).
|
||
The value <code>Double</code> refers to doing double-reverse
|
||
DNS lookup. That is, after a reverse lookup is performed, a forward
|
||
lookup is then performed on that result. At least one of the IP
|
||
addresses in the forward lookup must match the original
|
||
address. (In "tcpwrappers" terminology this is called
|
||
<code>PARANOID</code>.)</p>
|
||
|
||
<p>Regardless of the setting, when <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> is
|
||
used for controlling access by hostname, a double reverse lookup
|
||
will be performed. This is necessary for security. Note that the
|
||
result of this double-reverse isn't generally available unless you
|
||
set <code>HostnameLookups Double</code>. For example, if only
|
||
<code>HostnameLookups On</code> and a request is made to an object
|
||
that is protected by hostname restrictions, regardless of whether
|
||
the double-reverse fails or not, CGIs will still be passed the
|
||
single-reverse result in <code>REMOTE_HOST</code>.</p>
|
||
|
||
<p>The default is <code>Off</code> in order to save the network
|
||
traffic for those sites that don't truly need the reverse
|
||
lookups done. It is also better for the end users because they
|
||
don't have to suffer the extra latency that a lookup entails.
|
||
Heavily loaded sites should leave this directive
|
||
<code>Off</code>, since DNS lookups can take considerable
|
||
amounts of time. The utility <code class="program"><a href="../programs/logresolve.html">logresolve</a></code>, compiled by
|
||
default to the <code>bin</code> subdirectory of your installation
|
||
directory, can be used to look up host names from logged IP addresses
|
||
offline.</p>
|
||
|
||
<p>Finally, if you have <a href="mod_authz_host.html#reqhost">hostname-based Require
|
||
directives</a>, a hostname lookup will be performed regardless of
|
||
the setting of <code class="directive">HostnameLookups</code>.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="HttpProtocolOptions" id="HttpProtocolOptions">HttpProtocolOptions</a> <a name="httpprotocoloptions" id="httpprotocoloptions">Directive</a> <a title="Permanent link" href="#httpprotocoloptions" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Modify restrictions on HTTP Request Messages</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods]
|
||
[Allow0.9|Require1.0]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>HttpProtocolOptions Strict LenientMethods Allow0.9</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>2.2.32 or 2.4.24 and later</td></tr>
|
||
</table>
|
||
<p>This directive changes the rules applied to the HTTP Request Line
|
||
(<a href="https://tools.ietf.org/html/rfc7230#section-3.1.1">RFC 7230 §3.1.1</a>) and the HTTP Request Header Fields
|
||
(<a href="https://tools.ietf.org/html/rfc7230#section-3.2">RFC 7230 §3.2</a>), which are now applied by default or using
|
||
the <code>Strict</code> option. Due to legacy modules, applications or
|
||
custom user-agents which must be deprecated the <code>Unsafe</code>
|
||
option has been added to revert to the legacy behaviors.</p>
|
||
|
||
<p>These rules are applied prior to request processing,
|
||
so must be configured at the global or default (first) matching
|
||
virtual host section, by IP/port interface (and not by name)
|
||
to be honored.</p>
|
||
|
||
<p>The directive accepts three parameters from the following list
|
||
of choices, applying the default to the ones not specified:</p>
|
||
|
||
<dl>
|
||
<dt>Strict|Unsafe</dt>
|
||
<dd>
|
||
<p>Prior to the introduction of this directive, the Apache HTTP Server
|
||
request message parsers were tolerant of a number of forms of input
|
||
which did not conform to the protocol.
|
||
<a href="https://tools.ietf.org/html/rfc7230#section-9.4">RFC 7230 §9.4 Request Splitting</a> and
|
||
<a href="https://tools.ietf.org/html/rfc7230#section-9.5">§9.5 Response Smuggling</a> call out only two of the potential
|
||
risks of accepting non-conformant request messages, while
|
||
<a href="https://tools.ietf.org/html/rfc7230#section-3.5">RFC 7230 §3.5</a> "Message Parsing Robustness" identify the
|
||
risks of accepting obscure whitespace and request message formatting.
|
||
As of the introduction of this directive, all grammar rules of the
|
||
specification are enforced in the default <code>Strict</code> operating
|
||
mode, and the strict whitespace suggested by section 3.5 is enforced
|
||
and cannot be relaxed.</p>
|
||
|
||
<div class="warning"><h3>Security risks of Unsafe</h3>
|
||
<p>Users are strongly cautioned against toggling the <code>Unsafe</code>
|
||
mode of operation, particularly on outward-facing, publicly accessible
|
||
server deployments. If an interface is required for faulty monitoring
|
||
or other custom service consumers running on an intranet, users should
|
||
toggle the Unsafe option only on a specific virtual host configured
|
||
to service their internal private network.</p>
|
||
</div>
|
||
|
||
<div class="example"><h3>Example of a request leading to HTTP 400 with Strict mode</h3><p><code>
|
||
|
||
# Missing CRLF<br />
|
||
GET / HTTP/1.0\n\n
|
||
</code></p></div>
|
||
<div class="warning"><h3>Command line tools and CRLF</h3>
|
||
<p>Some tools need to be forced to use CRLF, otherwise httpd will return
|
||
a HTTP 400 response like described in the above use case. For example,
|
||
the <strong>OpenSSL s_client needs the -crlf parameter to work
|
||
properly</strong>.</p>
|
||
<p>The <code class="directive"><a href="../mod/mod_dumpio.html#dumpioinput">DumpIOInput</a></code> directive
|
||
can help while reviewing the HTTP request to identify issues like the
|
||
absence of CRLF.</p>
|
||
</div>
|
||
</dd>
|
||
<dt>RegisteredMethods|LenientMethods</dt>
|
||
<dd>
|
||
<p><a href="https://tools.ietf.org/html/rfc7231#section-4.1">RFC 7231 §4.1</a> "Request Methods" "Overview" requires that
|
||
origin servers shall respond with a HTTP 501 status code when an
|
||
unsupported method is encountered in the request line.
|
||
This already happens when the <code>LenientMethods</code> option is used,
|
||
but administrators may wish to toggle the <code>RegisteredMethods</code>
|
||
option and register any non-standard methods using the
|
||
<code class="directive"><a href="#registerhttpmethod">RegisterHttpMethod</a></code>
|
||
directive, particularly if the <code>Unsafe</code>
|
||
option has been toggled.</p>
|
||
|
||
<div class="warning"><h3>Forward Proxy compatibility</h3>
|
||
<p>The <code>RegisteredMethods</code> option should <strong>not</strong>
|
||
be toggled for forward proxy hosts, as the methods supported by the
|
||
origin servers are unknown to the proxy server.</p>
|
||
</div>
|
||
|
||
<div class="example"><h3>Example of a request leading to HTTP 501 with LenientMethods mode</h3><p><code>
|
||
|
||
# Unknown HTTP method<br />
|
||
WOW / HTTP/1.0\r\n\r\n<br /><br />
|
||
# Lowercase HTTP method<br />
|
||
get / HTTP/1.0\r\n\r\n<br />
|
||
</code></p></div>
|
||
</dd>
|
||
<dt>Allow0.9|Require1.0</dt>
|
||
<dd>
|
||
<p><a href="https://tools.ietf.org/html/rfc2616#section-19.6">RFC 2616 §19.6</a> "Compatibility With Previous Versions" had
|
||
encouraged HTTP servers to support legacy HTTP/0.9 requests. RFC 7230
|
||
supersedes this with "The expectation to support HTTP/0.9 requests has
|
||
been removed" and offers additional comments in
|
||
<a href="https://tools.ietf.org/html/rfc7230#appendix-A">RFC 7230 Appendix A</a>. The <code>Require1.0</code> option allows
|
||
the user to remove support of the default <code>Allow0.9</code> option's
|
||
behavior.</p>
|
||
|
||
<div class="example"><h3>Example of a request leading to HTTP 400 with Require1.0 mode</h3><p><code>
|
||
|
||
# Unsupported HTTP version<br />
|
||
GET /\r\n\r\n
|
||
</code></p></div>
|
||
</dd>
|
||
</dl>
|
||
<p>Reviewing the messages logged to the
|
||
<code class="directive"><a href="#errorlog">ErrorLog</a></code>, configured with
|
||
<code class="directive"><a href="#loglevel">LogLevel</a></code> <code>debug</code> level,
|
||
can help identify such faulty requests along with their origin.
|
||
Users should pay particular attention to the 400 responses in the access
|
||
log for invalid requests which were unexpectedly rejected.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="If" id="If"><If></a> <a name="if" id="if">Directive</a> <a title="Permanent link" href="#if" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply only if a condition is
|
||
satisfied by a request at runtime</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><If <var>expression</var>> ... </If></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Nested conditions are evaluated in 2.4.26 and later</td></tr>
|
||
</table>
|
||
<p>The <code class="directive"><If></code> directive
|
||
evaluates an expression at runtime, and applies the enclosed
|
||
directives if and only if the expression evaluates to true.
|
||
For example:</p>
|
||
|
||
<pre class="prettyprint lang-config"><If "-z req('Host')"></pre>
|
||
|
||
|
||
<p>would match HTTP/1.0 requests without a <var>Host:</var> header.
|
||
Expressions may contain various shell-like operators for string
|
||
comparison (<code>==</code>, <code>!=</code>, <code><</code>, ...),
|
||
integer comparison (<code>-eq</code>, <code>-ne</code>, ...),
|
||
and others (<code>-n</code>, <code>-z</code>, <code>-f</code>, ...).
|
||
It is also possible to use regular expressions, </p>
|
||
|
||
<pre class="prettyprint lang-config"><If "%{QUERY_STRING} =~ /(delete|commit)=.*?elem/"></pre>
|
||
|
||
|
||
<p>shell-like pattern matches and many other operations. These operations
|
||
can be done on request headers (<code>req</code>), environment variables
|
||
(<code>env</code>), and a large number of other properties. The full
|
||
documentation is available in <a href="../expr.html">Expressions in
|
||
Apache HTTP Server</a>.</p>
|
||
|
||
<p>Only directives that support the <a href="directive-dict.html#Context">directory context</a> can be used within this configuration section.</p>
|
||
|
||
<div class="warning">
|
||
Certain variables, such as <code>CONTENT_TYPE</code> and other
|
||
response headers, are set after <If> conditions have already
|
||
been evaluated, and so will not be available to use in this
|
||
directive.
|
||
</div>
|
||
|
||
<div class="warning">
|
||
Directives that take affect during configuration parsing, such as
|
||
<code class="directive">Define</code>, <code class="directive">Include</code>, and
|
||
<code class="directive">Error</code> cannot be made conditional by enclosing
|
||
them in an if <code class="directive"><If></code> configuration
|
||
section. These sections are always part of the configuration,
|
||
regardless of how they evaluate at runtime.
|
||
</div>
|
||
|
||
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><a href="../expr.html">Expressions in Apache HTTP Server</a>,
|
||
for a complete reference and more examples.</li>
|
||
<li><code class="directive"><a href="#elseif"><ElseIf></a></code></li>
|
||
<li><code class="directive"><a href="#else"><Else></a></code></li>
|
||
<li><a href="../sections.html">How <Directory>, <Location>,
|
||
<Files> sections work</a> for an explanation of how these
|
||
different sections are combined when a request is received.
|
||
<code class="directive"><If></code>,
|
||
<code class="directive"><ElseIf></code>, and
|
||
<code class="directive"><Else></code> are applied last.</li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="IfDefine" id="IfDefine"><IfDefine></a> <a name="ifdefine" id="ifdefine">Directive</a> <a title="Permanent link" href="#ifdefine" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Encloses directives that will be processed only
|
||
if a test is true at startup</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><IfDefine [!]<var>parameter-name</var>> ...
|
||
</IfDefine></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>The <code><IfDefine <var>test</var>>...</IfDefine>
|
||
</code> section is used to mark directives that are conditional. The
|
||
directives within an <code class="directive"><IfDefine></code>
|
||
section are only processed if the <var>test</var> is true. If <var>
|
||
test</var> is false, everything between the start and end markers is
|
||
ignored.</p>
|
||
|
||
<p>The <var>test</var> in the <code class="directive"><IfDefine></code> section directive can be one of two forms:</p>
|
||
|
||
<ul>
|
||
<li><var>parameter-name</var></li>
|
||
|
||
<li><code>!</code><var>parameter-name</var></li>
|
||
</ul>
|
||
|
||
<p>In the former case, the directives between the start and end
|
||
markers are only processed if the parameter named
|
||
<var>parameter-name</var> is defined. The second format reverses
|
||
the test, and only processes the directives if
|
||
<var>parameter-name</var> is <strong>not</strong> defined.</p>
|
||
|
||
<p>The <var>parameter-name</var> argument is a define as given on the
|
||
<code class="program"><a href="../programs/httpd.html">httpd</a></code> command line via <code>-D<var>parameter</var>
|
||
</code> at the time the server was started or by the <code class="directive"><a href="#define">Define</a></code> directive.</p>
|
||
|
||
<p><code class="directive"><IfDefine></code> sections are
|
||
nest-able, which can be used to implement simple
|
||
multiple-parameter tests. Example:</p>
|
||
|
||
<div class="example"><p><code>httpd -DReverseProxy -DUseCache -DMemCache ...</code></p></div>
|
||
<pre class="prettyprint lang-config"><IfDefine ReverseProxy>
|
||
LoadModule proxy_module modules/mod_proxy.so
|
||
LoadModule proxy_http_module modules/mod_proxy_http.so
|
||
<IfDefine UseCache>
|
||
LoadModule cache_module modules/mod_cache.so
|
||
<IfDefine MemCache>
|
||
LoadModule mem_cache_module modules/mod_mem_cache.so
|
||
</IfDefine>
|
||
<IfDefine !MemCache>
|
||
LoadModule cache_disk_module modules/mod_cache_disk.so
|
||
</IfDefine>
|
||
</IfDefine>
|
||
</IfDefine></pre>
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="IfDirective" id="IfDirective"><IfDirective></a> <a name="ifdirective" id="ifdirective">Directive</a> <a title="Permanent link" href="#ifdirective" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Encloses directives that are processed conditional on the
|
||
presence or absence of a specific directive</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><IfDirective [!]<var>directive-name</var>> ...
|
||
</IfDirective></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in 2.4.34 and later</td></tr>
|
||
</table>
|
||
<p>The <code><IfDirective <var>test</var>>...</IfDirective></code>
|
||
section is used to mark directives that are conditional on the presence of
|
||
a specific directive. The directives within an <code class="directive"><IfDirective></code> section are only processed if the <var>test</var>
|
||
is true. If <var>test</var> is false, everything between the start and
|
||
end markers is ignored.</p>
|
||
|
||
<p>The <var>test</var> in the <code class="directive"><IfDirective></code> section can be one of two forms:</p>
|
||
|
||
<ul>
|
||
<li><var>directive-name</var></li>
|
||
|
||
<li>!<var>directive-name</var></li>
|
||
</ul>
|
||
|
||
<p>In the former case, the directives between the start and end
|
||
markers are only processed if a directive of the given name is
|
||
available at the time of processing. The second format reverses the test,
|
||
and only processes the directives if <var>directive-name</var> is
|
||
<strong>not</strong> available.</p>
|
||
|
||
<div class="note">This section should only be used if you need to have one
|
||
configuration file that works across multiple versions of
|
||
<code class="program"><a href="../programs/httpd.html">httpd</a></code>, regardless of whether a particular
|
||
directive is available. In normal operation, directives need not
|
||
be placed in <code class="directive"><IfDirective></code>
|
||
sections.</div>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#ifsection"><IfSection></a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="IfFile" id="IfFile"><IfFile></a> <a name="iffile" id="iffile">Directive</a> <a title="Permanent link" href="#iffile" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Encloses directives that will be processed only
|
||
if file exists at startup</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><IfFile [!]<var>parameter-name</var>> ...
|
||
</IfFile></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in 2.4.34 and later</td></tr>
|
||
</table>
|
||
<p>The <code><IfFile <var>filename</var>>...</IfFile>
|
||
</code> section is used to mark directives that are conditional on
|
||
the existence of a file on disk. The directives within an
|
||
<code class="directive"><IfFile></code> section are only
|
||
processed if <var>filename</var> exists. If <var>filename</var>
|
||
doesn't exist, everything between the start and end markers is
|
||
ignored. <var>filename</var> can be an absolute path or a path
|
||
relative to the server root.</p>
|
||
|
||
<p>The <var>filename</var> in the <code class="directive"><IfFile></code> section directive can take the same forms as the
|
||
<var>test</var> variable in the <code class="directive"><a href="#ifdefine"><IfDefine></a></code> section, i.e. the test can be negated if the <code>
|
||
!</code> character is placed directly before <var>filename</var>.
|
||
</p>
|
||
|
||
<p>If a relative <var>filename</var> is supplied, the check is
|
||
<code class="directive"><a href="#serverroot">ServerRoot</a></code> relative. In the case where
|
||
this directive occurs before the <code class="directive"><a href="#serverroot">ServerRoot</a></code>,
|
||
the path will be checked relative to the compiled-in server root or
|
||
the server root passed in on the command line via the <code>-d</code>
|
||
parameter.</p>
|
||
|
||
<div class="warning"><h3>Warning</h3>
|
||
In 2.4.34, it is not possible to specify a <var>filename</var>
|
||
with surrounding quotes. This would generate a parsing error at start-up.
|
||
The main impact is that filenames with spaces can't be used.
|
||
This behavior is fixed in 2.4.35.</div>
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="IfModule" id="IfModule"><IfModule></a> <a name="ifmodule" id="ifmodule">Directive</a> <a title="Permanent link" href="#ifmodule" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Encloses directives that are processed conditional on the
|
||
presence or absence of a specific module</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><IfModule [!]<var>module-file</var>|<var>module-identifier</var>> ...
|
||
</IfModule></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>The <code><IfModule <var>test</var>>...</IfModule></code>
|
||
section is used to mark directives that are conditional on the presence of
|
||
a specific module. The directives within an <code class="directive"><IfModule></code> section are only processed if the <var>test</var>
|
||
is true. If <var>test</var> is false, everything between the start and
|
||
end markers is ignored.</p>
|
||
|
||
<p>The <var>test</var> in the <code class="directive"><IfModule></code> section directive can be one of two forms:</p>
|
||
|
||
<ul>
|
||
<li><var>module</var></li>
|
||
|
||
<li>!<var>module</var></li>
|
||
</ul>
|
||
|
||
<p>In the former case, the directives between the start and end
|
||
markers are only processed if the module named <var>module</var>
|
||
is included in Apache httpd -- either compiled in or
|
||
dynamically loaded using <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>. The second format reverses the test,
|
||
and only processes the directives if <var>module</var> is
|
||
<strong>not</strong> included.</p>
|
||
|
||
<p>The <var>module</var> argument can be either the module identifier or
|
||
the file name of the module, at the time it was compiled. For example,
|
||
<code>rewrite_module</code> is the identifier and
|
||
<code>mod_rewrite.c</code> is the file name. If a module consists of
|
||
several source files, use the name of the file containing the string
|
||
<code>STANDARD20_MODULE_STUFF</code>.</p>
|
||
|
||
<p><code class="directive"><IfModule></code> sections are
|
||
nest-able, which can be used to implement simple multiple-module
|
||
tests.</p>
|
||
|
||
<div class="note">This section should only be used if you need to have one
|
||
configuration file that works whether or not a specific module
|
||
is available. In normal operation, directives need not be
|
||
placed in <code class="directive"><IfModule></code>
|
||
sections.</div>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="IfSection" id="IfSection"><IfSection></a> <a name="ifsection" id="ifsection">Directive</a> <a title="Permanent link" href="#ifsection" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Encloses directives that are processed conditional on the
|
||
presence or absence of a specific section directive</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><IfSection [!]<var>section-name</var>> ...
|
||
</IfSection></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in 2.4.34 and later</td></tr>
|
||
</table>
|
||
<p>The <code><IfSection
|
||
<var>test</var>>...</IfSection></code> section is used
|
||
to mark directives that are conditional on the presence of a
|
||
specific section directive. A section directive is any directive
|
||
such as <code class="directive"><VirtualHost></code> which
|
||
encloses other directives, and has a directive name with a leading
|
||
"<".</p>
|
||
|
||
<p>The directives within an <code class="directive"><IfSection></code> section are only processed if the <var>test</var>
|
||
is true. If <var>test</var> is false, everything between the start and
|
||
end markers is ignored.</p>
|
||
|
||
<p>The <var>section-name</var> must be specified without either
|
||
the leading "<" or closing ">". The <var>test</var> in the
|
||
<code class="directive"><IfSection></code> section can be one
|
||
of two forms:</p>
|
||
|
||
<ul>
|
||
<li><var>section-name</var></li>
|
||
<li>!<var>section-name</var></li>
|
||
</ul>
|
||
|
||
<p>In the former case, the directives between the start and end
|
||
markers are only processed if a section directive of the given
|
||
name is available at the time of processing. The second format
|
||
reverses the test, and only processes the directives if
|
||
<var>section-name</var> is <strong>not</strong> an available
|
||
section directive.</p>
|
||
|
||
<p>For example:</p>
|
||
|
||
<pre class="prettyprint lang-config"><IfSection VirtualHost>
|
||
...
|
||
</IfSection></pre>
|
||
|
||
|
||
<div class="note">This section should only be used if you need to have one
|
||
configuration file that works across multiple versions of <code class="program"><a href="../programs/httpd.html">httpd</a></code>,
|
||
regardless of whether a particular section directive is
|
||
available. In normal operation, directives need not be placed in
|
||
<code class="directive"><IfSection></code> sections.</div>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#ifdirective"><IfDirective></a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="Include" id="Include">Include</a> <a name="include" id="include">Directive</a> <a title="Permanent link" href="#include" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Includes other configuration files from within
|
||
the server configuration files</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Include <var>file-path</var>|<var>directory-path</var>|<var>wildcard</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Directory
|
||
wildcard matching available in 2.3.6 and later</td></tr>
|
||
</table>
|
||
<p>This directive allows inclusion of other configuration files
|
||
from within the server configuration files.</p>
|
||
|
||
<p>Shell-style (<code>fnmatch()</code>) wildcard characters can be used
|
||
in the filename or directory parts of the path to include several files
|
||
at once, in alphabetical order. In addition, if
|
||
<code class="directive">Include</code> points to a directory, rather than a file,
|
||
Apache httpd will read all files in that directory and any subdirectory.
|
||
However, including entire directories is not recommended, because it is
|
||
easy to accidentally leave temporary files in a directory that can cause
|
||
<code class="program"><a href="../programs/httpd.html">httpd</a></code> to fail. Instead, we encourage you to use the
|
||
wildcard syntax shown below, to include files that match a particular
|
||
pattern, such as *.conf, for example.</p>
|
||
|
||
<p>The <code class="directive">Include</code> directive will
|
||
<strong>fail with an error</strong> if a wildcard expression does not
|
||
match any file. The <code class="directive"><a href="#includeoptional">IncludeOptional</a></code>
|
||
directive can be used if non-matching wildcards should be ignored.</p>
|
||
|
||
<p>The file path specified may be an absolute path, or may be relative
|
||
to the <code class="directive"><a href="#serverroot">ServerRoot</a></code> directory.</p>
|
||
|
||
<p>Examples:</p>
|
||
|
||
<pre class="prettyprint lang-config">Include /usr/local/apache2/conf/ssl.conf
|
||
Include /usr/local/apache2/conf/vhosts/*.conf</pre>
|
||
|
||
|
||
<p>Or, providing paths relative to your <code class="directive"><a href="#serverroot">ServerRoot</a></code> directory:</p>
|
||
|
||
<pre class="prettyprint lang-config">Include conf/ssl.conf
|
||
Include conf/vhosts/*.conf</pre>
|
||
|
||
|
||
<p>Wildcards may be included in the directory or file portion of the
|
||
path. This example will fail if there is no subdirectory in conf/vhosts
|
||
that contains at least one *.conf file:</p>
|
||
|
||
<pre class="prettyprint lang-config">Include conf/vhosts/*/*.conf</pre>
|
||
|
||
|
||
<p>Alternatively, the following command will just be ignored in case of
|
||
missing files or directories:</p>
|
||
|
||
<pre class="prettyprint lang-config">IncludeOptional conf/vhosts/*/*.conf</pre>
|
||
|
||
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#includeoptional">IncludeOptional</a></code></li>
|
||
<li><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="IncludeOptional" id="IncludeOptional">IncludeOptional</a> <a name="includeoptional" id="includeoptional">Directive</a> <a title="Permanent link" href="#includeoptional" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Includes other configuration files from within
|
||
the server configuration files</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>IncludeOptional <var>file-path</var>|<var>directory-path</var>|<var>wildcard</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in 2.3.6 and later. Not existent file paths without wildcards
|
||
do not cause SyntaxError after 2.4.30</td></tr>
|
||
</table>
|
||
<p>This directive allows inclusion of other configuration files
|
||
from within the server configuration files. It works identically to the
|
||
<code class="directive"><a href="#include">Include</a></code> directive, but it will be
|
||
silently ignored (instead of causing an error) if wildcards are used and
|
||
they do not match any file or directory or if a file path does not exist
|
||
on the file system.</p>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#include">Include</a></code></li>
|
||
<li><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="KeepAlive" id="KeepAlive">KeepAlive</a> <a name="keepalive" id="keepalive">Directive</a> <a title="Permanent link" href="#keepalive" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables HTTP persistent connections</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>KeepAlive On|Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>KeepAlive On</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>The Keep-Alive extension to HTTP/1.0 and the persistent
|
||
connection feature of HTTP/1.1 provide long-lived HTTP sessions
|
||
which allow multiple requests to be sent over the same TCP
|
||
connection. In some cases this has been shown to result in an
|
||
almost 50% speedup in latency times for HTML documents with
|
||
many images. To enable Keep-Alive connections, set
|
||
<code>KeepAlive On</code>.</p>
|
||
|
||
<p>For HTTP/1.0 clients, Keep-Alive connections will only be
|
||
used if they are specifically requested by a client. In
|
||
addition, a Keep-Alive connection with an HTTP/1.0 client can
|
||
only be used when the length of the content is known in
|
||
advance. This implies that dynamic content such as CGI output,
|
||
SSI pages, and server-generated directory listings will
|
||
generally not use Keep-Alive connections to HTTP/1.0 clients.
|
||
For HTTP/1.1 clients, persistent connections are the default
|
||
unless otherwise specified. If the client requests it, chunked
|
||
encoding will be used in order to send content of unknown
|
||
length over persistent connections.</p>
|
||
|
||
<p>When a client uses a Keep-Alive connection, it will be counted
|
||
as a single "request" for the <code class="directive"><a href="../mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code> directive, regardless
|
||
of how many requests are sent using the connection.</p>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="KeepAliveTimeout" id="KeepAliveTimeout">KeepAliveTimeout</a> <a name="keepalivetimeout" id="keepalivetimeout">Directive</a> <a title="Permanent link" href="#keepalivetimeout" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Amount of time the server will wait for subsequent
|
||
requests on a persistent connection</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>KeepAliveTimeout <var>num-seconds</var>|<var>num-milliseconds</var>ms</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>KeepAliveTimeout 5</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>The number of seconds Apache httpd will wait for a subsequent
|
||
request before closing the connection. By adding a postfix of 'ms' the
|
||
timeout can be also set in milliseconds. Once a request has been
|
||
received, the timeout value specified by the
|
||
<code class="directive"><a href="#timeout">Timeout</a></code> directive applies.</p>
|
||
|
||
<p>Setting <code class="directive">KeepAliveTimeout</code> to a high value
|
||
may cause performance problems in heavily loaded servers. The
|
||
higher the timeout, the more server processes will be kept
|
||
occupied waiting on connections with idle clients.</p>
|
||
|
||
<p>If <code class="directive">KeepAliveTimeout</code> is <strong>not</strong>
|
||
set for a name-based virtual host, the value of the first defined
|
||
virtual host best matching the local IP and port will be used.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="Limit" id="Limit"><Limit></a> <a name="limit" id="limit">Directive</a> <a title="Permanent link" href="#limit" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict enclosed access controls to only certain HTTP
|
||
methods</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Limit <var>method</var> [<var>method</var>] ... > ...
|
||
</Limit></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>AuthConfig, Limit</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>Access controls are normally effective for
|
||
<strong>all</strong> access methods, and this is the usual
|
||
desired behavior. <strong>In the general case, access control
|
||
directives should not be placed within a
|
||
<code class="directive"><Limit></code> section.</strong></p>
|
||
|
||
<p>The purpose of the <code class="directive"><Limit></code>
|
||
directive is to restrict the effect of the access controls to the
|
||
nominated HTTP methods. For all other methods, the access
|
||
restrictions that are enclosed in the <code class="directive"><Limit></code> bracket <strong>will have no
|
||
effect</strong>. The following example applies the access control
|
||
only to the methods <code>POST</code>, <code>PUT</code>, and
|
||
<code>DELETE</code>, leaving all other methods unprotected:</p>
|
||
|
||
<pre class="prettyprint lang-config"><Limit POST PUT DELETE>
|
||
Require valid-user
|
||
</Limit></pre>
|
||
|
||
|
||
<p>The method names listed can be one or more of: <code>GET</code>,
|
||
<code>POST</code>, <code>PUT</code>, <code>DELETE</code>,
|
||
<code>CONNECT</code>, <code>OPTIONS</code>,
|
||
<code>PATCH</code>, <code>PROPFIND</code>, <code>PROPPATCH</code>,
|
||
<code>MKCOL</code>, <code>COPY</code>, <code>MOVE</code>,
|
||
<code>LOCK</code>, and <code>UNLOCK</code>. <strong>The method name is
|
||
case-sensitive.</strong> If <code>GET</code> is used, it will also
|
||
restrict <code>HEAD</code> requests. The <code>TRACE</code> method
|
||
cannot be limited (see <code class="directive"><a href="#traceenable">TraceEnable</a></code>).</p>
|
||
|
||
<div class="warning">A <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> section should always be
|
||
used in preference to a <code class="directive"><Limit></code>
|
||
section when restricting access, since a <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> section provides protection
|
||
against arbitrary methods.</div>
|
||
|
||
<p>The <code class="directive"><Limit></code> and
|
||
<code class="directive"><a href="#limitexcept"><LimitExcept></a></code>
|
||
directives may be nested. In this case, each successive level of
|
||
<code class="directive"><Limit></code> or <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> directives must
|
||
further restrict the set of methods to which access controls apply.</p>
|
||
|
||
<div class="warning">When using
|
||
<code class="directive"><Limit></code> or
|
||
<code class="directive"><LimitExcept></code> directives with
|
||
the <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> directive,
|
||
note that the first <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>
|
||
to succeed authorizes the request, regardless of the presence of other
|
||
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> directives.</div>
|
||
|
||
<p>For example, given the following configuration, all users will
|
||
be authorized for <code>POST</code> requests, and the
|
||
<code>Require group editors</code> directive will be ignored
|
||
in all cases:</p>
|
||
|
||
<pre class="prettyprint lang-config"><LimitExcept GET>
|
||
Require valid-user
|
||
</LimitExcept>
|
||
<Limit POST>
|
||
Require group editors
|
||
</Limit></pre>
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LimitExcept" id="LimitExcept"><LimitExcept></a> <a name="limitexcept" id="limitexcept">Directive</a> <a title="Permanent link" href="#limitexcept" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict access controls to all HTTP methods
|
||
except the named ones</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><LimitExcept <var>method</var> [<var>method</var>] ... > ...
|
||
</LimitExcept></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>AuthConfig, Limit</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p><code class="directive"><LimitExcept></code> and
|
||
<code></LimitExcept></code> are used to enclose
|
||
a group of access control directives which will then apply to any
|
||
HTTP access method <strong>not</strong> listed in the arguments;
|
||
i.e., it is the opposite of a <code class="directive"><a href="#limit"><Limit></a></code> section and can be used to control
|
||
both standard and nonstandard/unrecognized methods. See the
|
||
documentation for <code class="directive"><a href="#limit"><Limit></a></code> for more details.</p>
|
||
|
||
<p>For example:</p>
|
||
|
||
<pre class="prettyprint lang-config"><LimitExcept POST GET>
|
||
Require valid-user
|
||
</LimitExcept></pre>
|
||
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LimitInternalRecursion" id="LimitInternalRecursion">LimitInternalRecursion</a> <a name="limitinternalrecursion" id="limitinternalrecursion">Directive</a> <a title="Permanent link" href="#limitinternalrecursion" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determine maximum number of internal redirects and nested
|
||
subrequests</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitInternalRecursion <var>number</var> [<var>number</var>]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitInternalRecursion 10</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>An internal redirect happens, for example, when using the <code class="directive"><a href="../mod/mod_actions.html#action">Action</a></code> directive, which internally
|
||
redirects the original request to a CGI script. A subrequest is Apache httpd's
|
||
mechanism to find out what would happen for some URI if it were requested.
|
||
For example, <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> uses subrequests to look for the
|
||
files listed in the <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>
|
||
directive.</p>
|
||
|
||
<p><code class="directive">LimitInternalRecursion</code> prevents the server
|
||
from crashing when entering an infinite loop of internal redirects or
|
||
subrequests. Such loops are usually caused by misconfigurations.</p>
|
||
|
||
<p>The directive stores two different limits, which are evaluated on
|
||
per-request basis. The first <var>number</var> is the maximum number of
|
||
internal redirects that may follow each other. The second <var>number</var>
|
||
determines how deeply subrequests may be nested. If you specify only one
|
||
<var>number</var>, it will be assigned to both limits.</p>
|
||
|
||
<pre class="prettyprint lang-config">LimitInternalRecursion 5</pre>
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LimitRequestBody" id="LimitRequestBody">LimitRequestBody</a> <a name="limitrequestbody" id="limitrequestbody">Directive</a> <a title="Permanent link" href="#limitrequestbody" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restricts the total size of the HTTP request body sent
|
||
from the client</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestBody <var>bytes</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitRequestBody 1073741824</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>In Apache HTTP Server 2.4.53 and earlier, the default value
|
||
was 0 (unlimited)</td></tr>
|
||
</table>
|
||
<p>This directive specifies the number of <var>bytes</var>
|
||
that are allowed in a request body. A value of <var>0</var> means unlimited.</p>
|
||
|
||
<p>The <code class="directive">LimitRequestBody</code> directive allows
|
||
the user to set a limit on the allowed size of an HTTP request
|
||
message body within the context in which the directive is given
|
||
(server, per-directory, per-file or per-location). If the client
|
||
request exceeds that limit, the server will return an error
|
||
response instead of servicing the request. The size of a normal
|
||
request message body will vary greatly depending on the nature of
|
||
the resource and the methods allowed on that resource. CGI scripts
|
||
typically use the message body for retrieving form information.
|
||
Implementations of the <code>PUT</code> method will require
|
||
a value at least as large as any representation that the server
|
||
wishes to accept for that resource.</p>
|
||
|
||
<p>This directive gives the server administrator greater
|
||
control over abnormal client request behavior, which may be
|
||
useful for avoiding some forms of denial-of-service
|
||
attacks.</p>
|
||
|
||
<p>If, for example, you are permitting file upload to a particular
|
||
location and wish to limit the size of the uploaded file to 100K,
|
||
you might use the following directive:</p>
|
||
|
||
<pre class="prettyprint lang-config">LimitRequestBody 102400</pre>
|
||
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LimitRequestFields" id="LimitRequestFields">LimitRequestFields</a> <a name="limitrequestfields" id="limitrequestfields">Directive</a> <a title="Permanent link" href="#limitrequestfields" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the number of HTTP request header fields that
|
||
will be accepted from the client</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestFields <var>number</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitRequestFields 100</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>Setting <var>number</var> at 0 means unlimited.
|
||
The default value is defined by the compile-time
|
||
constant <code>DEFAULT_LIMIT_REQUEST_FIELDS</code> (100 as
|
||
distributed).</p>
|
||
|
||
<p>The <code class="directive">LimitRequestFields</code> directive allows
|
||
the server administrator to modify the limit on the number of
|
||
request header fields allowed in an HTTP request. A server needs
|
||
this value to be larger than the number of fields that a normal
|
||
client request might include. The number of request header fields
|
||
used by a client rarely exceeds 20, but this may vary among
|
||
different client implementations, often depending upon the extent
|
||
to which a user has configured their browser to support detailed
|
||
content negotiation. Optional HTTP extensions are often expressed
|
||
using request header fields.</p>
|
||
|
||
<p>This directive gives the server administrator greater
|
||
control over abnormal client request behavior, which may be
|
||
useful for avoiding some forms of denial-of-service attacks.
|
||
The value should be increased if normal clients see an error
|
||
response from the server that indicates too many fields were
|
||
sent in the request.</p>
|
||
|
||
<p>For example:</p>
|
||
|
||
<pre class="prettyprint lang-config">LimitRequestFields 50</pre>
|
||
|
||
|
||
<div class="warning"><h3>Warning</h3>
|
||
<p> When name-based virtual hosting is used, the value for this
|
||
directive is taken from the default (first-listed) virtual host for the
|
||
local IP and port combination.</p>
|
||
</div>
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LimitRequestFieldSize" id="LimitRequestFieldSize">LimitRequestFieldSize</a> <a name="limitrequestfieldsize" id="limitrequestfieldsize">Directive</a> <a title="Permanent link" href="#limitrequestfieldsize" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the size of the HTTP request header allowed from the
|
||
client</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestFieldSize <var>bytes</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitRequestFieldSize 8190</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>This directive specifies the number of <var>bytes</var>
|
||
that will be allowed in an HTTP request header.</p>
|
||
|
||
<p>The <code class="directive">LimitRequestFieldSize</code> directive
|
||
allows the server administrator to set the limit
|
||
on the allowed size of an HTTP request header field. A server
|
||
needs this value to be large enough to hold any one header field
|
||
from a normal client request. The size of a normal request header
|
||
field will vary greatly among different client implementations,
|
||
often depending upon the extent to which a user has configured
|
||
their browser to support detailed content negotiation. SPNEGO
|
||
authentication headers can be up to 12392 bytes.</p>
|
||
|
||
<p>This directive gives the server administrator greater
|
||
control over abnormal client request behavior, which may be
|
||
useful for avoiding some forms of denial-of-service attacks.</p>
|
||
|
||
<p>For example:</p>
|
||
|
||
<pre class="prettyprint lang-config">LimitRequestFieldSize 4094</pre>
|
||
|
||
|
||
<div class="note">Under normal conditions, the value should not be changed from
|
||
the default.</div>
|
||
|
||
<div class="warning"><h3>Warning</h3>
|
||
<p> When name-based virtual hosting is used, the value for this
|
||
directive is taken from the default (first-listed) virtual host best
|
||
matching the current IP address and port combination.</p>
|
||
</div>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LimitRequestLine" id="LimitRequestLine">LimitRequestLine</a> <a name="limitrequestline" id="limitrequestline">Directive</a> <a title="Permanent link" href="#limitrequestline" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limit the size of the HTTP request line that will be accepted
|
||
from the client</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestLine <var>bytes</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitRequestLine 8190</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>This directive sets the number of <var>bytes</var> that will be
|
||
allowed on the HTTP request-line.</p>
|
||
|
||
<p>The <code class="directive">LimitRequestLine</code> directive allows
|
||
the server administrator to set the limit on the allowed size
|
||
of a client's HTTP request-line. Since the request-line consists of the
|
||
HTTP method, URI, and protocol version, the
|
||
<code class="directive">LimitRequestLine</code> directive places a
|
||
restriction on the length of a request-URI allowed for a request
|
||
on the server. A server needs this value to be large enough to
|
||
hold any of its resource names, including any information that
|
||
might be passed in the query part of a <code>GET</code> request.</p>
|
||
|
||
<p>This directive gives the server administrator greater
|
||
control over abnormal client request behavior, which may be
|
||
useful for avoiding some forms of denial-of-service attacks.</p>
|
||
|
||
<p>For example:</p>
|
||
|
||
<pre class="prettyprint lang-config">LimitRequestLine 4094</pre>
|
||
|
||
|
||
<div class="note">Under normal conditions, the value should not be changed from
|
||
the default.</div>
|
||
|
||
<div class="warning"><h3>Warning</h3>
|
||
<p> When name-based virtual hosting is used, the value for this
|
||
directive is taken from the default (first-listed) virtual host best
|
||
matching the current IP address and port combination.</p>
|
||
</div>
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LimitXMLRequestBody" id="LimitXMLRequestBody">LimitXMLRequestBody</a> <a name="limitxmlrequestbody" id="limitxmlrequestbody">Directive</a> <a title="Permanent link" href="#limitxmlrequestbody" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the size of an XML-based request body</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitXMLRequestBody <var>bytes</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LimitXMLRequestBody 1000000</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>Limit (in bytes) on the maximum size of an XML-based request
|
||
body. A value of <code>0</code> will apply a hard limit (depending on
|
||
32bit vs 64bit system) allowing for XML escaping within the bounds of
|
||
the system addressable memory, but it exists for compatibility only
|
||
and is not recommended since it does not account for memory consumed
|
||
elsewhere or concurrent requests, which might result in an overall
|
||
system out-of-memory.
|
||
</p>
|
||
<p>Example:</p>
|
||
|
||
<pre class="prettyprint lang-config"># Limit of 1 MiB
|
||
LimitXMLRequestBody 1073741824</pre>
|
||
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="Location" id="Location"><Location></a> <a name="location" id="location">Directive</a> <a title="Permanent link" href="#location" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Applies the enclosed directives only to matching
|
||
URLs</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Location
|
||
<var>URL-path</var>|<var>URL</var>> ... </Location></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>The <code class="directive"><Location></code> directive
|
||
limits the scope of the enclosed directives by URL. It is similar to the
|
||
<code class="directive"><a href="#directory"><Directory></a></code>
|
||
directive, and starts a subsection which is terminated with a
|
||
<code></Location></code> directive. <code class="directive"><Location></code> sections are processed in the
|
||
order they appear in the configuration file, after the <code class="directive"><a href="#directory"><Directory></a></code> sections and
|
||
<code>.htaccess</code> files are read, and after the <code class="directive"><a href="#files"><Files></a></code> sections.</p>
|
||
|
||
<p><code class="directive"><Location></code> sections operate
|
||
completely outside the filesystem. This has several consequences.
|
||
Most importantly, <code class="directive"><Location></code>
|
||
directives should not be used to control access to filesystem
|
||
locations. Since several different URLs may map to the same
|
||
filesystem location, such access controls may by circumvented.</p>
|
||
|
||
<p>The enclosed directives will be applied to the request if the path component
|
||
of the URL meets <em>any</em> of the following criteria:
|
||
</p>
|
||
<ul>
|
||
<li>The specified location matches exactly the path component of the URL.
|
||
</li>
|
||
<li>The specified location, which ends in a forward slash, is a prefix
|
||
of the path component of the URL (treated as a context root).
|
||
</li>
|
||
<li>The specified location, with the addition of a trailing slash, is a
|
||
prefix of the path component of the URL (also treated as a context root).
|
||
</li>
|
||
</ul>
|
||
<p>
|
||
In the example below, where no trailing slash is used, requests to
|
||
/private1, /private1/ and /private1/file.txt will have the enclosed
|
||
directives applied, but /private1other would not.
|
||
</p>
|
||
<pre class="prettyprint lang-config"><Location "/private1">
|
||
# ...
|
||
</Location></pre>
|
||
|
||
<p>
|
||
In the example below, where a trailing slash is used, requests to
|
||
/private2/ and /private2/file.txt will have the enclosed
|
||
directives applied, but /private2 and /private2other would not.
|
||
</p>
|
||
<pre class="prettyprint lang-config"><Location "/private2<em>/</em>">
|
||
# ...
|
||
</Location></pre>
|
||
|
||
|
||
<div class="note"><h3>When to use <code class="directive"><Location></code></h3>
|
||
|
||
<p>Use <code class="directive"><Location></code> to apply
|
||
directives to content that lives outside the filesystem. For
|
||
content that lives in the filesystem, use <code class="directive"><a href="#directory"><Directory></a></code> and <code class="directive"><a href="#files"><Files></a></code>. An exception is
|
||
<code><Location "/"></code>, which is an easy way to
|
||
apply a configuration to the entire server.</p>
|
||
</div>
|
||
|
||
<p>For all origin (non-proxy) requests, the URL to be matched is a
|
||
URL-path of the form <code>/path/</code>. <em>No scheme, hostname,
|
||
port, or query string may be included.</em> For proxy requests, the
|
||
URL to be matched is of the form
|
||
<code>scheme://servername/path</code>, and you must include the
|
||
prefix.</p>
|
||
|
||
<p>The URL may use wildcards. In a wild-card string, <code>?</code> matches
|
||
any single character, and <code>*</code> matches any sequences of
|
||
characters. Neither wildcard character matches a / in the URL-path.</p>
|
||
|
||
<p><a class="glossarylink" href="../glossary.html#regex" title="see glossary">Regular expressions</a>
|
||
can also be used, with the addition of the <code>~</code>
|
||
character. For example:</p>
|
||
|
||
<pre class="prettyprint lang-config"><Location ~ "/(extra|special)/data">
|
||
#...
|
||
</Location></pre>
|
||
|
||
|
||
<p>would match URLs that contained the substring <code>/extra/data</code>
|
||
or <code>/special/data</code>. The directive <code class="directive"><a href="#locationmatch"><LocationMatch></a></code> behaves
|
||
identical to the regex version of <code class="directive"><Location></code>, and is preferred, for the
|
||
simple reason that <code>~</code> is hard to distinguish from
|
||
<code>-</code> in many fonts.</p>
|
||
|
||
<p>The <code class="directive"><Location></code>
|
||
functionality is especially useful when combined with the
|
||
<code class="directive"><a href="#sethandler">SetHandler</a></code>
|
||
directive. For example, to enable status requests but allow them
|
||
only from browsers at <code>example.com</code>, you might use:</p>
|
||
|
||
<pre class="prettyprint lang-config"><Location "/status">
|
||
SetHandler server-status
|
||
Require host example.com
|
||
</Location></pre>
|
||
|
||
|
||
<div class="note"><h3>Note about / (slash)</h3>
|
||
<p>The slash character has special meaning depending on where in a
|
||
URL it appears. People may be used to its behavior in the filesystem
|
||
where multiple adjacent slashes are frequently collapsed to a single
|
||
slash (<em>i.e.</em>, <code>/home///foo</code> is the same as
|
||
<code>/home/foo</code>). In URL-space this is not necessarily true if
|
||
directive <code class="directive"><a href="#mergeslashes">MergeSlashes</a></code> has been set
|
||
to "OFF".
|
||
The <code class="directive"><a href="#locationmatch"><LocationMatch></a></code>
|
||
directive and the regex version of <code class="directive"><Location></code> require you to explicitly specify multiple
|
||
slashes if the slashes are not being merged.</p>
|
||
|
||
<p>For example, <code><LocationMatch "^/abc"></code> would match
|
||
the request URL <code>/abc</code> but not the request URL <code>
|
||
//abc</code>. The (non-regex) <code class="directive"><Location></code> directive behaves similarly when used for
|
||
proxy requests. But when (non-regex) <code class="directive"><Location></code> is used for non-proxy requests it will
|
||
implicitly match multiple slashes with a single slash. For example,
|
||
if you specify <code><Location "/abc/def"></code> and the
|
||
request is to <code>/abc//def</code> then it will match.</p>
|
||
</div>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><a href="../sections.html">How <Directory>, <Location>
|
||
and <Files> sections work</a> for an explanation of how these
|
||
different sections are combined when a request is received.</li>
|
||
<li><code class="directive"><a href="#locationmatch">LocationMatch</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LocationMatch" id="LocationMatch"><LocationMatch></a> <a name="locationmatch" id="locationmatch">Directive</a> <a title="Permanent link" href="#locationmatch" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Applies the enclosed directives only to regular-expression
|
||
matching URLs</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><LocationMatch
|
||
<var>regex</var>> ... </LocationMatch></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>The <code class="directive"><LocationMatch></code> directive
|
||
limits the scope of the enclosed directives by URL, in an identical manner
|
||
to <code class="directive"><a href="#location"><Location></a></code>. However,
|
||
it takes a <a class="glossarylink" href="../glossary.html#regex" title="see glossary">regular expression</a>
|
||
as an argument instead of a simple string. For example:</p>
|
||
|
||
<pre class="prettyprint lang-config"><LocationMatch "/(extra|special)/data">
|
||
# ...
|
||
</LocationMatch></pre>
|
||
|
||
|
||
<p>would match URLs that contained the substring <code>/extra/data</code>
|
||
or <code>/special/data</code>.</p>
|
||
|
||
<div class="note"><p>If the intent is that a URL <strong>starts with</strong>
|
||
<code>/extra/data</code>, rather than merely
|
||
<strong>contains</strong> <code>/extra/data</code>, prefix the
|
||
regular expression with a <code>^</code> to require this.</p>
|
||
|
||
<pre class="prettyprint lang-config"><LocationMatch "^/(extra|special)/data"></pre>
|
||
|
||
</div>
|
||
|
||
<p>From 2.4.8 onwards, named groups and backreferences are captured and
|
||
written to the environment with the corresponding name prefixed with
|
||
"MATCH_" and in upper case. This allows elements of URLs to be referenced
|
||
from within <a href="../expr.html">expressions</a> and modules like
|
||
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. In order to prevent confusion, numbered
|
||
(unnamed) backreferences are ignored. Use named groups instead.</p>
|
||
|
||
<pre class="prettyprint lang-config"><LocationMatch "^/combined/(?<sitename>[^/]+)">
|
||
Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
|
||
</LocationMatch></pre>
|
||
|
||
|
||
<div class="note"><h3>Note about / (slash)</h3>
|
||
<p>The slash character has special meaning depending on where in a
|
||
URL it appears. People may be used to its behavior in the filesystem
|
||
where multiple adjacent slashes are frequently collapsed to a single
|
||
slash (<em>i.e.</em>, <code>/home///foo</code> is the same as
|
||
<code>/home/foo</code>). In URL-space this is not necessarily true if
|
||
directive <code class="directive"><a href="#mergeslashes">MergeSlashes</a></code> has been set
|
||
to "OFF".
|
||
The <code class="directive"><LocationMatch></code>
|
||
directive and the regex version of <code class="directive"><Location></code> require you to explicitly specify multiple
|
||
slashes if the slashes are not being merged.</p>
|
||
|
||
<p>For example, <code><LocationMatch "^/abc"></code> would match
|
||
the request URL <code>/abc</code> but not the request URL <code>
|
||
//abc</code>. The (non-regex) <code class="directive"><Location></code> directive behaves similarly when used for
|
||
proxy requests. But when (non-regex) <code class="directive"><Location></code> is used for non-proxy requests it will
|
||
implicitly match multiple slashes with a single slash. For example,
|
||
if you specify <code><Location "/abc/def"></code> and the
|
||
request is to <code>/abc//def</code> then it will match.</p>
|
||
</div>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><a href="../sections.html">How <Directory>, <Location>
|
||
and <Files> sections work</a> for an explanation of how these
|
||
different sections are combined when a request is received</li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LogLevel" id="LogLevel">LogLevel</a> <a name="loglevel" id="loglevel">Directive</a> <a title="Permanent link" href="#loglevel" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls the verbosity of the ErrorLog</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LogLevel [<var>module</var>:]<var>level</var>
|
||
[<var>module</var>:<var>level</var>] ...
|
||
</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LogLevel warn</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Per-module and per-directory configuration is available in
|
||
Apache HTTP Server 2.3.6 and later</td></tr>
|
||
</table>
|
||
<p><code class="directive">LogLevel</code> adjusts the verbosity of the
|
||
messages recorded in the error logs (see <code class="directive"><a href="#errorlog">ErrorLog</a></code> directive). The following
|
||
<var>level</var>s are available, in order of decreasing
|
||
significance:</p>
|
||
|
||
<table class="bordered">
|
||
|
||
<tr>
|
||
<th><strong>Level</strong> </th>
|
||
|
||
<th><strong>Description</strong> </th>
|
||
|
||
<th><strong>Example</strong> </th>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td><code>emerg</code> </td>
|
||
|
||
<td>Emergencies - system is unusable.</td>
|
||
|
||
<td>"Child cannot open lock file. Exiting"</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td><code>alert</code> </td>
|
||
|
||
<td>Action must be taken immediately.</td>
|
||
|
||
<td>"getpwuid: couldn't determine user name from uid"</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td><code>crit</code> </td>
|
||
|
||
<td>Critical Conditions.</td>
|
||
|
||
<td>"socket: Failed to get a socket, exiting child"</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td><code>error</code> </td>
|
||
|
||
<td>Error conditions.</td>
|
||
|
||
<td>"Premature end of script headers"</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td><code>warn</code> </td>
|
||
|
||
<td>Warning conditions.</td>
|
||
|
||
<td>"child process 1234 did not exit, sending another
|
||
SIGHUP"</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td><code>notice</code> </td>
|
||
|
||
<td>Normal but significant condition.</td>
|
||
|
||
<td>"httpd: caught SIGBUS, attempting to dump core in
|
||
..."</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td><code>info</code> </td>
|
||
|
||
<td>Informational.</td>
|
||
|
||
<td>"Server seems busy, (you may need to increase
|
||
StartServers, or Min/MaxSpareServers)..."</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td><code>debug</code> </td>
|
||
|
||
<td>Debug-level messages</td>
|
||
|
||
<td>"Opening config file ..."</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>trace1</code> </td>
|
||
|
||
<td>Trace messages</td>
|
||
|
||
<td>"proxy: FTP: control connection complete"</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>trace2</code> </td>
|
||
|
||
<td>Trace messages</td>
|
||
|
||
<td>"proxy: CONNECT: sending the CONNECT request to the remote proxy"</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>trace3</code> </td>
|
||
|
||
<td>Trace messages</td>
|
||
|
||
<td>"openssl: Handshake: start"</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>trace4</code> </td>
|
||
|
||
<td>Trace messages</td>
|
||
|
||
<td>"read from buffered SSL brigade, mode 0, 17 bytes"</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>trace5</code> </td>
|
||
|
||
<td>Trace messages</td>
|
||
|
||
<td>"map lookup FAILED: map=rewritemap key=keyname"</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>trace6</code> </td>
|
||
|
||
<td>Trace messages</td>
|
||
|
||
<td>"cache lookup FAILED, forcing new map lookup"</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>trace7</code> </td>
|
||
|
||
<td>Trace messages, dumping large amounts of data</td>
|
||
|
||
<td>"| 0000: 02 23 44 30 13 40 ac 34 df 3d bf 9a 19 49 39 15 |"</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>trace8</code> </td>
|
||
|
||
<td>Trace messages, dumping large amounts of data</td>
|
||
|
||
<td>"| 0000: 02 23 44 30 13 40 ac 34 df 3d bf 9a 19 49 39 15 |"</td>
|
||
</tr>
|
||
</table>
|
||
|
||
<p>When a particular level is specified, messages from all
|
||
other levels of higher significance will be reported as well.
|
||
<em>E.g.</em>, when <code>LogLevel info</code> is specified,
|
||
then messages with log levels of <code>notice</code> and
|
||
<code>warn</code> will also be posted.</p>
|
||
|
||
<p>Using a level of at least <code>crit</code> is
|
||
recommended.</p>
|
||
|
||
<p>For example:</p>
|
||
|
||
<pre class="prettyprint lang-config">LogLevel notice</pre>
|
||
|
||
|
||
<div class="note"><h3>Note</h3>
|
||
<p>When logging to a regular file, messages of the level
|
||
<code>notice</code> cannot be suppressed and thus are always
|
||
logged. However, this doesn't apply when logging is done
|
||
using <code>syslog</code>.</p>
|
||
</div>
|
||
|
||
<p>Specifying a level without a module name will reset the level
|
||
for all modules to that level. Specifying a level with a module
|
||
name will set the level for that module only. It is possible to
|
||
use the module source file name, the module identifier, or the
|
||
module identifier with the trailing <code>_module</code> omitted
|
||
as module specification. This means the following three specifications
|
||
are equivalent:</p>
|
||
|
||
<pre class="prettyprint lang-config">LogLevel info ssl:warn
|
||
LogLevel info mod_ssl.c:warn
|
||
LogLevel info ssl_module:warn</pre>
|
||
|
||
|
||
<p>It is also possible to change the level per directory:</p>
|
||
|
||
<pre class="prettyprint lang-config">LogLevel info
|
||
<Directory "/usr/local/apache/htdocs/app">
|
||
LogLevel debug
|
||
</Directory></pre>
|
||
|
||
|
||
<div class="note">
|
||
Per directory loglevel configuration only affects messages that are
|
||
logged after the request has been parsed and that are associated with
|
||
the request. Log messages which are associated with the server or
|
||
the connection are not affected. The latter can be influenced by the
|
||
<code class="directive"><a href="#logleveloverride">LogLevelOverride</a></code> directive,
|
||
though.
|
||
</div>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#errorlog">ErrorLog</a></code></li>
|
||
<li><code class="directive"><a href="#errorlogformat">ErrorLogFormat</a></code></li>
|
||
<li><code class="directive"><a href="#logleveloverride">LogLevelOverride</a></code></li>
|
||
<li><a href="../logs.html">Apache HTTP Server Log Files</a></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LogLevelOverride" id="LogLevelOverride">LogLevelOverride</a> <a name="logleveloverride" id="logleveloverride">Directive</a> <a title="Permanent link" href="#logleveloverride" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Override the verbosity of the ErrorLog for certain clients</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LogLevel <var>ipaddress</var>[/<var>prefixlen</var>]
|
||
[<var>module</var>:]<var>level</var> [<var>module</var>:<var>level</var>] ...
|
||
</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>unset</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache HTTP Server 2.5.0 and later</td></tr>
|
||
</table>
|
||
<p><code class="directive">LogLevelOverride</code> adjusts the
|
||
<code class="directive"><a href="#loglevel">LogLevel</a></code> for requests coming from
|
||
certain client IP addresses.
|
||
This allows to enable verbose logging only for certain test clients.
|
||
The IP address is checked at a very early state in the connection
|
||
processing. Therefore, <code class="directive">LogLevelOverride</code> allows to
|
||
change the log level for things like the SSL handshake which happen before
|
||
a <code class="directive"><a href="#loglevel">LogLevel</a></code> directive in an
|
||
<code class="directive"><a href="#if"><If></a></code> container would
|
||
be evaluated.</p>
|
||
|
||
<p><code class="directive">LogLevelOverride</code> accepts either a single
|
||
IP-address or a CIDR IP-address/len subnet specification.
|
||
For the syntax of the loglevel specification, see the
|
||
<code class="directive"><a href="#loglevel">LogLevel</a></code> directive.</p>
|
||
|
||
<p>For requests that match a <code class="directive">LogLevelOverride</code>
|
||
directive, per-directory specifications of
|
||
<code class="directive"><a href="#loglevel">LogLevel</a></code> are ignored.</p>
|
||
|
||
<p>Examples:</p>
|
||
|
||
<pre class="prettyprint lang-config"> LogLevelOverride 192.0.2.0/24 ssl:trace6
|
||
LogLevelOverride 192.0.2.7 ssl:trace8</pre>
|
||
|
||
|
||
<div class="note">
|
||
<code class="directive">LogLevelOverride</code> only affects
|
||
log messages that are associated with the request or the connection.
|
||
Log messages which are associated with the server are not affected.
|
||
</div>
|
||
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#loglevel">LogLevel</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="MaxKeepAliveRequests" id="MaxKeepAliveRequests">MaxKeepAliveRequests</a> <a name="maxkeepaliverequests" id="maxkeepaliverequests">Directive</a> <a title="Permanent link" href="#maxkeepaliverequests" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of requests allowed on a persistent
|
||
connection</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MaxKeepAliveRequests <var>number</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>MaxKeepAliveRequests 100</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>The <code class="directive">MaxKeepAliveRequests</code> directive
|
||
limits the number of requests allowed per connection when
|
||
<code class="directive"><a href="#keepalive">KeepAlive</a></code> is on. If it is
|
||
set to <code>0</code>, unlimited requests will be allowed. We
|
||
recommend that this setting be kept to a high value for maximum
|
||
server performance.</p>
|
||
|
||
<p>For example:</p>
|
||
|
||
<pre class="prettyprint lang-config">MaxKeepAliveRequests 500</pre>
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="MaxRangeOverlaps" id="MaxRangeOverlaps">MaxRangeOverlaps</a> <a name="maxrangeoverlaps" id="maxrangeoverlaps">Directive</a> <a title="Permanent link" href="#maxrangeoverlaps" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of overlapping ranges (eg: <code>100-200,150-300</code>) allowed before returning the complete
|
||
resource </td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MaxRangeOverlaps default | unlimited | none | <var>number-of-ranges</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>MaxRangeOverlaps 20</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache HTTP Server 2.3.15 and later</td></tr>
|
||
</table>
|
||
<p>The <code class="directive">MaxRangeOverlaps</code> directive
|
||
limits the number of overlapping HTTP ranges the server is willing to
|
||
return to the client. If more overlapping ranges than permitted are requested,
|
||
the complete resource is returned instead.</p>
|
||
|
||
<dl>
|
||
<dt><strong>default</strong></dt>
|
||
<dd>Limits the number of overlapping ranges to a compile-time default of 20.</dd>
|
||
|
||
<dt><strong>none</strong></dt>
|
||
<dd>No overlapping Range headers are allowed.</dd>
|
||
|
||
<dt><strong>unlimited</strong></dt>
|
||
<dd>The server does not limit the number of overlapping ranges it is
|
||
willing to satisfy.</dd>
|
||
|
||
<dt><var>number-of-ranges</var></dt>
|
||
<dd>A positive number representing the maximum number of overlapping ranges the
|
||
server is willing to satisfy.</dd>
|
||
</dl>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="MaxRangeReversals" id="MaxRangeReversals">MaxRangeReversals</a> <a name="maxrangereversals" id="maxrangereversals">Directive</a> <a title="Permanent link" href="#maxrangereversals" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of range reversals (eg: <code>100-200,50-70</code>) allowed before returning the complete
|
||
resource </td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MaxRangeReversals default | unlimited | none | <var>number-of-ranges</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>MaxRangeReversals 20</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache HTTP Server 2.3.15 and later</td></tr>
|
||
</table>
|
||
<p>The <code class="directive">MaxRangeReversals</code> directive
|
||
limits the number of HTTP Range reversals the server is willing to
|
||
return to the client. If more ranges reversals than permitted are requested,
|
||
the complete resource is returned instead.</p>
|
||
|
||
<dl>
|
||
<dt><strong>default</strong></dt>
|
||
<dd>Limits the number of range reversals to a compile-time default of 20.</dd>
|
||
|
||
<dt><strong>none</strong></dt>
|
||
<dd>No Range reversals headers are allowed.</dd>
|
||
|
||
<dt><strong>unlimited</strong></dt>
|
||
<dd>The server does not limit the number of range reversals it is
|
||
willing to satisfy.</dd>
|
||
|
||
<dt><var>number-of-ranges</var></dt>
|
||
<dd>A positive number representing the maximum number of range reversals the
|
||
server is willing to satisfy.</dd>
|
||
</dl>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="MaxRanges" id="MaxRanges">MaxRanges</a> <a name="maxranges" id="maxranges">Directive</a> <a title="Permanent link" href="#maxranges" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of ranges allowed before returning the complete
|
||
resource </td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MaxRanges default | unlimited | none | <var>number-of-ranges</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>MaxRanges 200</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache HTTP Server 2.3.15 and later</td></tr>
|
||
</table>
|
||
<p>The <code class="directive">MaxRanges</code> directive
|
||
limits the number of HTTP ranges the server is willing to
|
||
return to the client. If more ranges than permitted are requested,
|
||
the complete resource is returned instead.</p>
|
||
|
||
<dl>
|
||
<dt><strong>default</strong></dt>
|
||
<dd>Limits the number of ranges to a compile-time default of 200.</dd>
|
||
|
||
<dt><strong>none</strong></dt>
|
||
<dd>Range headers are ignored.</dd>
|
||
|
||
<dt><strong>unlimited</strong></dt>
|
||
<dd>The server does not limit the number of ranges it is
|
||
willing to satisfy.</dd>
|
||
|
||
<dt><var>number-of-ranges</var></dt>
|
||
<dd>A positive number representing the maximum number of ranges the
|
||
server is willing to satisfy.</dd>
|
||
</dl>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="MergeSlashes" id="MergeSlashes">MergeSlashes</a> <a name="mergeslashes" id="mergeslashes">Directive</a> <a title="Permanent link" href="#mergeslashes" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls whether the server merges consecutive slashes in URLs.
|
||
</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MergeSlashes ON|OFF</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>MergeSlashes ON</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Added in 2.5.1</td></tr>
|
||
</table>
|
||
<p>By default, the server merges (or collapses) multiple consecutive slash
|
||
('/') characters in the path component of the request URL.</p>
|
||
|
||
<p>When mapping URL's to the filesystem, these multiple slashes are not
|
||
significant. However, URL's handled other ways, such as by CGI or proxy,
|
||
might prefer to retain the significance of multiple consecutive slashes.
|
||
In these cases <code class="directive">MergeSlashes</code> can be set to
|
||
<em>OFF</em> to retain the multiple consecutive slashes, which is the legacy behavior.</p>
|
||
<p>
|
||
When set to "OFF", regular expressions used in the configuration file that match
|
||
the path component of the URL (<code class="directive">LocationMatch</code>,
|
||
<code class="directive">RewriteRule</code>, ...) need to take into account multiple
|
||
consecutive slashes. Non regular expression based <code class="directive">Location</code> always
|
||
operate against a URL with merged slashes and cannot differentiate between multiple slashes.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="MergeTrailers" id="MergeTrailers">MergeTrailers</a> <a name="mergetrailers" id="mergetrailers">Directive</a> <a title="Permanent link" href="#mergetrailers" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether trailers are merged into headers</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MergeTrailers [on|off]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>MergeTrailers off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>2.4.11 and later</td></tr>
|
||
</table>
|
||
<p>This directive controls whether HTTP trailers are copied into the
|
||
internal representation of HTTP headers. This merging occurs when the
|
||
request body has been completely consumed, long after most header
|
||
processing would have a chance to examine or modify request headers.</p>
|
||
<p>This option is provided for compatibility with releases prior to 2.4.11,
|
||
where trailers were always merged.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="Mutex" id="Mutex">Mutex</a> <a name="mutex" id="mutex">Directive</a> <a title="Permanent link" href="#mutex" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures mutex mechanism and lock file directory for all
|
||
or specified mutexes</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Mutex <var>mechanism</var> [default|<var>mutex-name</var>] ... [OmitPID]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Mutex default</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache HTTP Server 2.3.4 and later</td></tr>
|
||
</table>
|
||
<p>The <code class="directive">Mutex</code> directive sets the mechanism,
|
||
and optionally the lock file location, that httpd and modules use
|
||
to serialize access to resources. Specify <code>default</code> as
|
||
the second argument to change the settings for all mutexes; specify
|
||
a mutex name (see table below) as the second argument to override
|
||
defaults only for that mutex.</p>
|
||
|
||
<p>The <code class="directive">Mutex</code> directive is typically used in
|
||
the following exceptional situations:</p>
|
||
|
||
<ul>
|
||
<li>change the mutex mechanism when the default mechanism selected
|
||
by <a class="glossarylink" href="../glossary.html#apr" title="see glossary">APR</a> has a functional or performance
|
||
problem</li>
|
||
|
||
<li>change the directory used by file-based mutexes when the
|
||
default directory does not support locking</li>
|
||
</ul>
|
||
|
||
<div class="note"><h3>Supported modules</h3>
|
||
<p>This directive only configures mutexes which have been registered
|
||
with the core server using the <code>ap_mutex_register()</code> API.
|
||
All modules bundled with httpd support the <code class="directive">Mutex</code>
|
||
directive, but third-party modules may not. Consult the documentation
|
||
of the third-party module, which must indicate the mutex name(s) which
|
||
can be configured if this directive is supported.</p>
|
||
</div>
|
||
|
||
<p>The following mutex <em>mechanisms</em> are available:</p>
|
||
<ul>
|
||
<li><code>default | yes</code>
|
||
<p>This selects the default locking implementation, as determined by
|
||
<a class="glossarylink" href="../glossary.html#apr" title="see glossary">APR</a>. The default locking implementation can
|
||
be displayed by running <code class="program"><a href="../programs/httpd.html">httpd</a></code> with the
|
||
<code>-V</code> option.</p></li>
|
||
|
||
<li><code>none | no</code>
|
||
<p>This effectively disables the mutex, and is only allowed for a
|
||
mutex if the module indicates that it is a valid choice. Consult the
|
||
module documentation for more information.</p></li>
|
||
|
||
<li><code>posixsem</code>
|
||
<p>This is a mutex variant based on a Posix semaphore.</p>
|
||
|
||
<div class="warning"><h3>Warning</h3>
|
||
<p>The semaphore ownership is not recovered if a thread in the process
|
||
holding the mutex segfaults, resulting in a hang of the web server.</p>
|
||
</div>
|
||
</li>
|
||
|
||
<li><code>sysvsem</code>
|
||
<p>This is a mutex variant based on a SystemV IPC semaphore.</p>
|
||
|
||
<div class="warning"><h3>Warning</h3>
|
||
<p>It is possible to "leak" SysV semaphores if processes crash
|
||
before the semaphore is removed.</p>
|
||
</div>
|
||
|
||
<div class="warning"><h3>Security</h3>
|
||
<p>The semaphore API allows for a denial of service attack by any
|
||
CGIs running under the same uid as the webserver (<em>i.e.</em>,
|
||
all CGIs, unless you use something like <code class="program"><a href="../programs/suexec.html">suexec</a></code>
|
||
or <code>cgiwrapper</code>).</p>
|
||
</div>
|
||
</li>
|
||
|
||
<li><code>sem</code>
|
||
<p>This selects the "best" available semaphore implementation, choosing
|
||
between Posix and SystemV IPC semaphores, in that order.</p></li>
|
||
|
||
<li><code>pthread</code>
|
||
<p>This is a mutex variant based on cross-process Posix thread
|
||
mutexes.</p>
|
||
|
||
<div class="warning"><h3>Warning</h3>
|
||
<p>On most systems, if a child process terminates abnormally while
|
||
holding a mutex that uses this implementation, the server will deadlock
|
||
and stop responding to requests. When this occurs, the server will
|
||
require a manual restart to recover.</p>
|
||
<p>Solaris and Linux are notable exceptions as they provide a mechanism which
|
||
usually allows the mutex to be recovered after a child process
|
||
terminates abnormally while holding a mutex.</p>
|
||
<p>If your system is POSIX compliant or if it implements the
|
||
<code>pthread_mutexattr_setrobust_np()</code> function, you may be able
|
||
to use the <code>pthread</code> option safely.</p>
|
||
</div>
|
||
</li>
|
||
|
||
<li><code>fcntl:/path/to/mutex</code>
|
||
<p>This is a mutex variant where a physical (lock-)file and the
|
||
<code>fcntl()</code> function are used as the mutex.</p>
|
||
|
||
<div class="warning"><h3>Warning</h3>
|
||
<p>When multiple mutexes based on this mechanism are used within
|
||
multi-threaded, multi-process environments, deadlock errors (EDEADLK)
|
||
can be reported for valid mutex operations if <code>fcntl()</code>
|
||
is not thread-aware, such as on Solaris.</p>
|
||
</div>
|
||
</li>
|
||
|
||
<li><code>flock:/path/to/mutex</code>
|
||
<p>This is similar to the <code>fcntl:/path/to/mutex</code> method
|
||
with the exception that the <code>flock()</code> function is used to
|
||
provide file locking.</p></li>
|
||
|
||
<li><code>file:/path/to/mutex</code>
|
||
<p>This selects the "best" available file locking implementation,
|
||
choosing between <code>fcntl</code> and <code>flock</code>, in that
|
||
order.</p></li>
|
||
</ul>
|
||
|
||
<p>Most mechanisms are only available on selected platforms, where the
|
||
underlying platform and <a class="glossarylink" href="../glossary.html#apr" title="see glossary">APR</a> support it. Mechanisms
|
||
which aren't available on all platforms are <em>posixsem</em>,
|
||
<em>sysvsem</em>, <em>sem</em>, <em>pthread</em>, <em>fcntl</em>,
|
||
<em>flock</em>, and <em>file</em>.</p>
|
||
|
||
<p>With the file-based mechanisms <em>fcntl</em> and <em>flock</em>,
|
||
the path, if provided, is a directory where the lock file will be created.
|
||
The default directory is httpd's run-time file directory,
|
||
<code class="directive"><a href="#defaultruntimedir">DefaultRuntimeDir</a></code>. If a relative
|
||
path is provided, it is relative to
|
||
<code class="directive"><a href="#defaultruntimedir">DefaultRuntimeDir</a></code>. Always use a local
|
||
disk filesystem for <code>/path/to/mutex</code> and never a directory residing
|
||
on a NFS- or AFS-filesystem. The basename of the file will be the mutex
|
||
type, an optional instance string provided by the module, and unless the
|
||
<code>OmitPID</code> keyword is specified, the process id of the httpd
|
||
parent process will be appended to make the file name unique, avoiding
|
||
conflicts when multiple httpd instances share a lock file directory. For
|
||
example, if the mutex name is <code>mpm-accept</code> and the lock file
|
||
directory is <code>/var/httpd/locks</code>, the lock file name for the
|
||
httpd instance with parent process id 12345 would be
|
||
<code>/var/httpd/locks/mpm-accept.12345</code>.</p>
|
||
|
||
<div class="warning"><h3>Security</h3>
|
||
<p>It is best to <em>avoid</em> putting mutex files in a world-writable
|
||
directory such as <code>/var/tmp</code> because someone could create
|
||
a denial of service attack and prevent the server from starting by
|
||
creating a lockfile with the same name as the one the server will try
|
||
to create.</p>
|
||
</div>
|
||
|
||
<p>The following table documents the names of mutexes used by httpd
|
||
and bundled modules.</p>
|
||
|
||
<table class="bordered"><tr class="header">
|
||
<th>Mutex name</th>
|
||
<th>Module(s)</th>
|
||
<th>Protected resource</th>
|
||
</tr>
|
||
<tr>
|
||
<td><code>mpm-accept</code></td>
|
||
<td><code class="module"><a href="../mod/prefork.html">prefork</a></code> and <code class="module"><a href="../mod/worker.html">worker</a></code> MPMs</td>
|
||
<td>incoming connections, to avoid the thundering herd problem;
|
||
for more information, refer to the
|
||
<a href="../misc/perf-tuning.html">performance tuning</a>
|
||
documentation</td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td><code>authdigest-client</code></td>
|
||
<td><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code></td>
|
||
<td>client list in shared memory</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>authdigest-opaque</code></td>
|
||
<td><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code></td>
|
||
<td>counter in shared memory</td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td><code>ldap-cache</code></td>
|
||
<td><code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code></td>
|
||
<td>LDAP result cache</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>rewrite-map</code></td>
|
||
<td><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></td>
|
||
<td>communication with external mapping programs, to avoid
|
||
intermixed I/O from multiple requests</td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td><code>ssl-cache</code></td>
|
||
<td><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code></td>
|
||
<td>SSL session cache</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>ssl-stapling</code></td>
|
||
<td><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code></td>
|
||
<td>OCSP stapling response cache</td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td><code>watchdog-callback</code></td>
|
||
<td><code class="module"><a href="../mod/mod_watchdog.html">mod_watchdog</a></code></td>
|
||
<td>callback function of a particular client module</td>
|
||
</tr>
|
||
</table>
|
||
|
||
<p>The <code>OmitPID</code> keyword suppresses the addition of the httpd
|
||
parent process id from the lock file name.</p>
|
||
|
||
<p>In the following example, the mutex mechanism for the MPM accept
|
||
mutex will be changed from the compiled-in default to <code>fcntl</code>,
|
||
with the associated lock file created in directory
|
||
<code>/var/httpd/locks</code>. The mutex mechanism for all other mutexes
|
||
will be changed from the compiled-in default to <code>sysvsem</code>.</p>
|
||
|
||
<pre class="prettyprint lang-config">Mutex sysvsem default
|
||
Mutex fcntl:/var/httpd/locks mpm-accept</pre>
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="NameVirtualHost" id="NameVirtualHost">NameVirtualHost</a> <a name="namevirtualhost" id="namevirtualhost">Directive</a> <a title="Permanent link" href="#namevirtualhost" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>DEPRECATED: Designates an IP address for name-virtual
|
||
hosting</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>NameVirtualHost <var>addr</var>[:<var>port</var>]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
|
||
<p>Prior to 2.3.11, <code class="directive">NameVirtualHost</code> was required
|
||
to instruct the server that a particular IP address and port combination
|
||
was usable as a name-based virtual host. In 2.3.11 and later,
|
||
any time an IP address and port combination is used in multiple virtual
|
||
hosts, name-based virtual hosting is automatically enabled for that address.</p>
|
||
|
||
<p>This directive currently has no effect.</p>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><a href="../vhosts/">Virtual Hosts
|
||
documentation</a></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="Options" id="Options">Options</a> <a name="options" id="options">Directive</a> <a title="Permanent link" href="#options" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures what features are available in a particular
|
||
directory</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Options
|
||
[+|-]<var>option</var> [[+|-]<var>option</var>] ...</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Options FollowSymlinks</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>Options</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>The default was changed from All to FollowSymlinks in 2.3.11</td></tr>
|
||
</table>
|
||
<p>The <code class="directive">Options</code> directive controls which
|
||
server features are available in a particular directory.</p>
|
||
|
||
<p><var>option</var> can be set to <code>None</code>, in which
|
||
case none of the extra features are enabled, or one or more of
|
||
the following:</p>
|
||
|
||
<dl>
|
||
<dt><code>All</code></dt>
|
||
|
||
<dd>All options except for <code>MultiViews</code>.</dd>
|
||
|
||
<dt><code>ExecCGI</code></dt>
|
||
|
||
<dd>
|
||
Execution of CGI scripts using <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>
|
||
is permitted.</dd>
|
||
|
||
<dt><code>FollowSymLinks</code></dt>
|
||
|
||
<dd>
|
||
The server will follow symbolic links in this directory. This is
|
||
the default setting.
|
||
<div class="note">
|
||
<p>Even though the server follows the symlink it does <em>not</em>
|
||
change the pathname used to match against <code class="directive"><a href="#directory"><Directory></a></code> sections.</p>
|
||
|
||
<p>The <code>FollowSymLinks</code> and
|
||
<code>SymLinksIfOwnerMatch</code> <code class="directive">Options</code> work only in <code class="directive"><a href="#directory"><Directory></a></code> sections or
|
||
<code>.htaccess</code> files.</p>
|
||
|
||
<p>Omitting this option should not be considered a security restriction,
|
||
since symlink testing is subject to race conditions that make it
|
||
circumventable.</p>
|
||
</div></dd>
|
||
|
||
<dt><code>Includes</code></dt>
|
||
|
||
<dd>
|
||
Server-side includes provided by <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>
|
||
are permitted.</dd>
|
||
|
||
<dt><code>IncludesNOEXEC</code></dt>
|
||
|
||
<dd>
|
||
|
||
Server-side includes are permitted, but the <code>#exec
|
||
cmd</code> and <code>#exec cgi</code> are disabled. It is still
|
||
possible to <code>#include virtual</code> CGI scripts from
|
||
<code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>ed
|
||
directories.</dd>
|
||
|
||
<dt><code>Indexes</code></dt>
|
||
|
||
<dd>
|
||
If a URL which maps to a directory is requested and there
|
||
is no <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>
|
||
(<em>e.g.</em>, <code>index.html</code>) in that directory, then
|
||
<code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> will return a formatted listing
|
||
of the directory.</dd>
|
||
|
||
<dt><code>MultiViews</code></dt>
|
||
|
||
<dd>
|
||
<a href="../content-negotiation.html">Content negotiated</a>
|
||
"MultiViews" are allowed using
|
||
<code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code>.
|
||
<div class="note"><h3>Note</h3> <p>This option gets ignored if set
|
||
anywhere other than <code class="directive"><a href="#directory"><Directory></a></code>, as <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code>
|
||
needs real resources to compare against and evaluate from.</p></div>
|
||
</dd>
|
||
|
||
<dt><code>SymLinksIfOwnerMatch</code></dt>
|
||
|
||
<dd>The server will only follow symbolic links for which the
|
||
target file or directory is owned by the same user id as the
|
||
link.
|
||
|
||
<div class="note"><h3>Note</h3>
|
||
<p>The <code>FollowSymLinks</code> and
|
||
<code>SymLinksIfOwnerMatch</code> <code class="directive">Options</code> work only in <code class="directive"><a href="#directory"><Directory></a></code> sections or
|
||
<code>.htaccess</code> files.</p>
|
||
|
||
<p>This option should not be considered a security restriction,
|
||
since symlink testing is subject to race conditions that make it
|
||
circumventable.</p>
|
||
</div> </dd>
|
||
</dl>
|
||
|
||
<p>Normally, if multiple <code class="directive">Options</code> could
|
||
apply to a directory, then the most specific one is used and
|
||
others are ignored; the options are not merged. (See <a href="../sections.html#merging">how sections are merged</a>.)
|
||
However if <em>all</em> the options on the
|
||
<code class="directive">Options</code> directive are preceded by a
|
||
<code>+</code> or <code>-</code> symbol, the options are
|
||
merged. Any options preceded by a <code>+</code> are added to the
|
||
options currently in force, and any options preceded by a
|
||
<code>-</code> are removed from the options currently in
|
||
force. </p>
|
||
|
||
<div class="note"><h3>Note</h3>
|
||
<p>Mixing <code class="directive">Options</code> with a <code>+</code> or
|
||
<code>-</code> with those without is not valid syntax and will be
|
||
rejected during server startup by the syntax check with an abort.</p>
|
||
</div>
|
||
|
||
<p>For example, without any <code>+</code> and <code>-</code> symbols:</p>
|
||
|
||
<pre class="prettyprint lang-config"><Directory "/web/docs">
|
||
Options Indexes FollowSymLinks
|
||
</Directory>
|
||
|
||
<Directory "/web/docs/spec">
|
||
Options Includes
|
||
</Directory></pre>
|
||
|
||
|
||
<p>then only <code>Includes</code> will be set for the
|
||
<code>/web/docs/spec</code> directory. However if the second
|
||
<code class="directive">Options</code> directive uses the <code>+</code> and
|
||
<code>-</code> symbols:</p>
|
||
|
||
<pre class="prettyprint lang-config"><Directory "/web/docs">
|
||
Options Indexes FollowSymLinks
|
||
</Directory>
|
||
|
||
<Directory "/web/docs/spec">
|
||
Options +Includes -Indexes
|
||
</Directory></pre>
|
||
|
||
|
||
<p>then the options <code>FollowSymLinks</code> and
|
||
<code>Includes</code> are set for the <code>/web/docs/spec</code>
|
||
directory.</p>
|
||
|
||
<div class="note"><h3>Note</h3>
|
||
<p>Using <code>-IncludesNOEXEC</code> or
|
||
<code>-Includes</code> disables server-side includes completely
|
||
regardless of the previous setting.</p>
|
||
</div>
|
||
|
||
<p>The default in the absence of any other settings is
|
||
<code>FollowSymlinks</code>.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="Protocol" id="Protocol">Protocol</a> <a name="protocol" id="protocol">Directive</a> <a title="Permanent link" href="#protocol" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Protocol for a listening socket</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Protocol <var>protocol</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>On Windows, only available from Apache 2.3.3 and later.</td></tr>
|
||
</table>
|
||
<p>This directive specifies the protocol used for a specific listening socket.
|
||
The protocol is used to determine which module should handle a request and
|
||
to apply protocol specific optimizations with the <code class="directive">AcceptFilter</code>
|
||
directive.</p>
|
||
|
||
<p>This directive not required for most
|
||
configurations. If not specified, <code>https</code> is the default for
|
||
port 443 and <code>http</code> the default for all other ports. The
|
||
protocol is used to determine which module should handle a request, and
|
||
to apply protocol specific optimizations with the
|
||
<code class="directive"><a href="#acceptfilter">AcceptFilter</a></code> directive.</p>
|
||
|
||
<p>For example, if you are running <code>https</code> on a non-standard port,
|
||
specify the protocol explicitly:</p>
|
||
|
||
<pre class="prettyprint lang-config">Protocol https</pre>
|
||
|
||
|
||
<p>You can also specify the protocol using the <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> directive.</p>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#acceptfilter">AcceptFilter</a></code></li>
|
||
<li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="Protocols" id="Protocols">Protocols</a> <a name="protocols" id="protocols">Directive</a> <a title="Permanent link" href="#protocols" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Protocols available for a server/virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Protocols <var>protocol</var> ...</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Protocols http/1.1</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Only available from Apache 2.4.17 and later.</td></tr>
|
||
</table>
|
||
<p>This directive specifies the list of protocols supported for a
|
||
server/virtual host. The list determines the allowed protocols
|
||
a client may negotiate for this server/host.</p>
|
||
|
||
<p>You need to set protocols if you want to extend the available
|
||
protocols for a server/host. By default, only the http/1.1 protocol
|
||
(which includes the compatibility with 1.0 and 0.9 clients) is
|
||
allowed.</p>
|
||
|
||
<p>For example, if you want to support HTTP/2 for a server with TLS,
|
||
specify:</p>
|
||
|
||
<pre class="prettyprint lang-config">Protocols h2 http/1.1</pre>
|
||
|
||
|
||
<p>Valid protocols are <code>http/1.1</code> for http and https connections,
|
||
<code>h2</code> on https connections and <code>h2c</code> for http
|
||
connections. Modules may enable more protocols.</p>
|
||
|
||
<p>It is safe to specify protocols that are unavailable/disabled. Such
|
||
protocol names will simply be ignored.</p>
|
||
|
||
<p>Protocols specified in base servers are inherited for virtual hosts
|
||
only if the virtual host has no own Protocols directive. Or, the other
|
||
way around, Protocols directives in virtual hosts replace any
|
||
such directive in the base server.
|
||
</p>
|
||
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#protocolshonororder">ProtocolsHonorOrder</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="ProtocolsHonorOrder" id="ProtocolsHonorOrder">ProtocolsHonorOrder</a> <a name="protocolshonororder" id="protocolshonororder">Directive</a> <a title="Permanent link" href="#protocolshonororder" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines if order of Protocols determines precedence during negotiation</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProtocolsHonorOrder On|Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ProtocolsHonorOrder On</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Only available from Apache 2.4.17 and later.</td></tr>
|
||
</table>
|
||
<p>This directive specifies if the server should honor the order in which
|
||
the <code class="directive">Protocols</code> directive lists protocols.</p>
|
||
|
||
<p>If configured Off, the client supplied list order of protocols has
|
||
precedence over the order in the server configuration.</p>
|
||
|
||
<p>With <code class="directive">ProtocolsHonorOrder</code> set to <code>on</code>
|
||
(default), the client ordering does not matter and only the ordering
|
||
in the server settings influences the outcome of the protocol
|
||
negotiation.</p>
|
||
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#protocols">Protocols</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="QualifyRedirectURL" id="QualifyRedirectURL">QualifyRedirectURL</a> <a name="qualifyredirecturl" id="qualifyredirecturl">Directive</a> <a title="Permanent link" href="#qualifyredirecturl" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls whether the REDIRECT_URL environment variable is
|
||
fully qualified</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>QualifyRedirectURL On|Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>QualifyRedirectURL Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Directive supported in 2.4.18 and later. 2.4.17 acted
|
||
as if 'QualifyRedirectURL On' was configured.</td></tr>
|
||
</table>
|
||
<p>This directive controls whether the server will ensure that the
|
||
REDIRECT_URL environment variable is fully qualified. By default,
|
||
the variable contains the verbatim URL requested by the client,
|
||
such as "/index.html". With <code class="directive">QualifyRedirectURL On</code>, the same request would result in a
|
||
value such as "http://www.example.com/index.html".</p>
|
||
<p>Even without this directive set, when a request is issued against a
|
||
fully qualified URL, REDIRECT_URL will remain fully qualified.
|
||
</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="ReadBufferSize" id="ReadBufferSize">ReadBufferSize</a> <a name="readbuffersize" id="readbuffersize">Directive</a> <a title="Permanent link" href="#readbuffersize" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Size of the buffers used to read data</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ReadBufferSize <var>bytes</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ReadBufferSize 8192</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>2.5 and later</td></tr>
|
||
</table>
|
||
<p>This directive allows to configure the size (in bytes) of the memory
|
||
buffer used to read data from the network or files.</p>
|
||
|
||
<p>A larger buffer can increase peformances with larger data, but consumes
|
||
more memory per connection. The minimum configurable size is
|
||
<var>1024</var>.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="RegexDefaultOptions" id="RegexDefaultOptions">RegexDefaultOptions</a> <a name="regexdefaultoptions" id="regexdefaultoptions">Directive</a> <a title="Permanent link" href="#regexdefaultoptions" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Allow to configure global/default options for regexes</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RegexDefaultOptions [none] [+|-]<var>option</var> [[+|-]<var>option</var>] ...</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>RegexDefaultOptions DOTALL DOLLAR_ENDONLY</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Only available from Apache 2.4.30 and later.</td></tr>
|
||
</table>
|
||
<p>This directive adds some default behavior to ANY regular expression
|
||
used afterwards.</p>
|
||
|
||
<p>Any option preceded by a '+' is added to the already set options.<br />
|
||
Any option preceded by a '-' is removed from the already set options.<br />
|
||
Any option without a '+' or a '-' will be set, removing any other
|
||
already set option.<br />
|
||
The <code>none</code> keyword resets any already set options.</p>
|
||
|
||
<p><var>option</var> can be:</p>
|
||
<dl>
|
||
<dt><code>ICASE</code></dt>
|
||
<dd>Use a case-insensitive match.</dd>
|
||
|
||
<dt><code>EXTENDED</code></dt>
|
||
<dd>Perl's /x flag, ignore (unescaped-)spaces and comments in the pattern.</dd>
|
||
|
||
<dt><code>DOTALL</code></dt>
|
||
<dd>Perl's /s flag, '.' matches newline characters.</dd>
|
||
|
||
<dt><code>DOLLAR_ENDONLY</code></dt>
|
||
<dd>'$' matches at end of subject string only.</dd>
|
||
</dl>
|
||
<pre class="prettyprint lang-config"># Reset all default/defined options
|
||
RegexDefaultOptions none
|
||
# Add the ICASE option for all regexes by default
|
||
RegexDefaultOptions +ICASE
|
||
...
|
||
# Add the ICASE option to the already applicable ones
|
||
RegexDefaultOptions +ICASE
|
||
# Remove the default DOLLAR_ENDONLY option, but keep any other one
|
||
RegexDefaultOptions -DOLLAR_ENDONLY
|
||
...
|
||
# Set the DOTALL option only, resetting any other one
|
||
RegexDefaultOptions DOTALL
|
||
...
|
||
# Set the DOTALL and ICASE options only
|
||
# Options are applied in order and blindly, so:
|
||
# RegexDefaultOptions DOTALL ICASE
|
||
# would not work as possibly expected (ICASE clears DOTALL)
|
||
RegexDefaultOptions none +DOTALL +ICASE
|
||
# or "simply"
|
||
RegexDefaultOptions DOTALL +ICASE
|
||
...</pre>
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="RegisterHttpMethod" id="RegisterHttpMethod">RegisterHttpMethod</a> <a name="registerhttpmethod" id="registerhttpmethod">Directive</a> <a title="Permanent link" href="#registerhttpmethod" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Register non-standard HTTP methods</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RegisterHttpMethod <var>method</var> [<var>method</var> [...]]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache HTTP Server 2.4.24 and later</td></tr>
|
||
</table>
|
||
<p>This directive may be used to register additional HTTP methods. This is
|
||
necessary if non-standard methods need to be used with directives that accept
|
||
method names as parameters, or to allow particular non-standard methods to be
|
||
used via proxy or CGI script when the server has been configured to only pass
|
||
recognized methods to modules.</p>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#httpprotocoloptions">HTTPProtocolOptions</a></code></li>
|
||
<li><code class="directive"><a href="../mod/mod_allowmethods.html#allowmethods">AllowMethods</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="RLimitCPU" id="RLimitCPU">RLimitCPU</a> <a name="rlimitcpu" id="rlimitcpu">Directive</a> <a title="Permanent link" href="#rlimitcpu" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the CPU consumption of processes launched
|
||
by Apache httpd children</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RLimitCPU <var>seconds</var>|max [<var>seconds</var>|max]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Unset; uses operating system defaults</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>Takes 1 or 2 parameters. The first parameter sets the soft
|
||
resource limit for all processes and the second parameter sets
|
||
the maximum resource limit. Either parameter can be a number,
|
||
or <code>max</code> to indicate to the server that the limit should
|
||
be set to the maximum allowed by the operating system
|
||
configuration. Raising the maximum resource limit requires that
|
||
the server is running as <code>root</code> or in the initial startup
|
||
phase.</p>
|
||
|
||
<p>This applies to processes forked from Apache httpd children
|
||
servicing requests, not the Apache httpd children themselves. This
|
||
includes CGI scripts and SSI exec commands, but not any
|
||
processes forked from the Apache httpd parent, such as piped
|
||
logs.</p>
|
||
|
||
<p>CPU resource limits are expressed in seconds per
|
||
process.</p>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
|
||
<li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="RLimitMEM" id="RLimitMEM">RLimitMEM</a> <a name="rlimitmem" id="rlimitmem">Directive</a> <a title="Permanent link" href="#rlimitmem" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the memory consumption of processes launched
|
||
by Apache httpd children</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RLimitMEM <var>bytes</var>|max [<var>bytes</var>|max]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Unset; uses operating system defaults</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>Takes 1 or 2 parameters. The first parameter sets the soft
|
||
resource limit for all processes and the second parameter sets
|
||
the maximum resource limit. Either parameter can be a number,
|
||
or <code>max</code> to indicate to the server that the limit should
|
||
be set to the maximum allowed by the operating system
|
||
configuration. Raising the maximum resource limit requires that
|
||
the server is running as <code>root</code> or in the initial startup
|
||
phase.</p>
|
||
|
||
<p>This applies to processes forked from Apache httpd children
|
||
servicing requests, not the Apache httpd children themselves. This
|
||
includes CGI scripts and SSI exec commands, but not any
|
||
processes forked from the Apache httpd parent, such as piped
|
||
logs.</p>
|
||
|
||
<p>Memory resource limits are expressed in bytes per
|
||
process.</p>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
|
||
<li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="RLimitNPROC" id="RLimitNPROC">RLimitNPROC</a> <a name="rlimitnproc" id="rlimitnproc">Directive</a> <a title="Permanent link" href="#rlimitnproc" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the number of processes that can be launched by
|
||
processes launched by Apache httpd children</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RLimitNPROC <var>number</var>|max [<var>number</var>|max]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Unset; uses operating system defaults</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>Takes 1 or 2 parameters. The first parameter sets the soft
|
||
resource limit for all processes, and the second parameter sets
|
||
the maximum resource limit. Either parameter can be a number,
|
||
or <code>max</code> to indicate to the server that the limit
|
||
should be set to the maximum allowed by the operating system
|
||
configuration. Raising the maximum resource limit requires that
|
||
the server is running as <code>root</code> or in the initial startup
|
||
phase.</p>
|
||
|
||
<p>This applies to processes forked from Apache httpd children
|
||
servicing requests, not the Apache httpd children themselves. This
|
||
includes CGI scripts and SSI exec commands, but not any
|
||
processes forked from the Apache httpd parent, such as piped
|
||
logs.</p>
|
||
|
||
<p>Process limits control the number of processes per user.</p>
|
||
|
||
<div class="note"><h3>Note</h3>
|
||
<p>If CGI processes are <strong>not</strong> running
|
||
under user ids other than the web server user id, this directive
|
||
will limit the number of processes that the server itself can
|
||
create. Evidence of this situation will be indicated by
|
||
<strong><code>cannot fork</code></strong> messages in the
|
||
<code>error_log</code>.</p>
|
||
</div>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
|
||
<li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="ScriptInterpreterSource" id="ScriptInterpreterSource">ScriptInterpreterSource</a> <a name="scriptinterpretersource" id="scriptinterpretersource">Directive</a> <a title="Permanent link" href="#scriptinterpretersource" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Technique for locating the interpreter for CGI
|
||
scripts</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ScriptInterpreterSource Registry|Registry-Strict|Script</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ScriptInterpreterSource Script</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Win32 only.</td></tr>
|
||
</table>
|
||
<p>This directive is used to control how Apache httpd finds the
|
||
interpreter used to run CGI scripts. The default setting is
|
||
<code>Script</code>. This causes Apache httpd to use the interpreter pointed to
|
||
by the shebang line (first line, starting with <code>#!</code>) in the
|
||
script. On Win32 systems this line usually looks like:</p>
|
||
|
||
<pre class="prettyprint lang-perl">#!C:/Perl/bin/perl.exe</pre>
|
||
|
||
|
||
<p>or, if <code>perl</code> is in the <code>PATH</code>, simply:</p>
|
||
|
||
<pre class="prettyprint lang-perl">#!perl</pre>
|
||
|
||
|
||
<p>Setting <code>ScriptInterpreterSource Registry</code> will
|
||
cause the Windows Registry tree <code>HKEY_CLASSES_ROOT</code> to be
|
||
searched using the script file extension (e.g., <code>.pl</code>) as a
|
||
search key. The command defined by the registry subkey
|
||
<code>Shell\ExecCGI\Command</code> or, if it does not exist, by the subkey
|
||
<code>Shell\Open\Command</code> is used to open the script file. If the
|
||
registry keys cannot be found, Apache httpd falls back to the behavior of the
|
||
<code>Script</code> option.</p>
|
||
|
||
<div class="warning"><h3>Security</h3>
|
||
<p>Be careful when using <code>ScriptInterpreterSource
|
||
Registry</code> with <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>'ed directories, because
|
||
Apache httpd will try to execute <strong>every</strong> file within this
|
||
directory. The <code>Registry</code> setting may cause undesired
|
||
program calls on files which are typically not executed. For
|
||
example, the default open command on <code>.htm</code> files on
|
||
most Windows systems will execute Microsoft Internet Explorer, so
|
||
any HTTP request for an <code>.htm</code> file existing within the
|
||
script directory would start the browser in the background on the
|
||
server. This is a good way to crash your system within a minute or
|
||
so.</p>
|
||
</div>
|
||
|
||
<p>The option <code>Registry-Strict</code>
|
||
does the same thing as <code>Registry</code> but uses only the
|
||
subkey <code>Shell\ExecCGI\Command</code>. The
|
||
<code>ExecCGI</code> key is not a common one. It must be
|
||
configured manually in the windows registry and hence prevents
|
||
accidental program calls on your system.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="SeeRequestTail" id="SeeRequestTail">SeeRequestTail</a> <a name="seerequesttail" id="seerequesttail">Directive</a> <a title="Permanent link" href="#seerequesttail" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determine if mod_status displays the first 63 characters
|
||
of a request or the last 63, assuming the request itself is greater than
|
||
63 chars.</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SeeRequestTail On|Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>SeeRequestTail Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p><code class="module"><a href="../mod/mod_status.html">mod_status</a></code> with <code>ExtendedStatus On</code>
|
||
displays the actual request being handled.
|
||
For historical purposes, only 63 characters of the request
|
||
are actually stored for display purposes. This directive
|
||
controls whether the first 63 characters are stored (the previous
|
||
behavior and the default) or if the last 63 characters are. This
|
||
is only applicable, of course, if the length of the request is
|
||
64 characters or greater.</p>
|
||
|
||
<p>If Apache httpd is handling <code>GET /disk1/storage/apache/htdocs/images/imagestore1/food/apples.jpg HTTP/1.1</code> <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> displays as follows:
|
||
</p>
|
||
|
||
<table class="bordered">
|
||
<tr>
|
||
<th>Off (default)</th>
|
||
<td>GET /disk1/storage/apache/htdocs/images/imagestore1/food/apples</td>
|
||
</tr>
|
||
<tr>
|
||
<th>On</th>
|
||
<td>orage/apache/htdocs/images/imagestore1/food/apples.jpg HTTP/1.1</td>
|
||
</tr>
|
||
</table>
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="ServerAdmin" id="ServerAdmin">ServerAdmin</a> <a name="serveradmin" id="serveradmin">Directive</a> <a title="Permanent link" href="#serveradmin" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Email address that the server includes in error
|
||
messages sent to the client</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerAdmin <var>email-address</var>|<var>URL</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>The <code class="directive">ServerAdmin</code> sets the contact address
|
||
that the server includes in any error messages it returns to the
|
||
client. If the <code>httpd</code> doesn't recognize the supplied argument
|
||
as an URL, it
|
||
assumes, that it's an <var>email-address</var> and prepends it with
|
||
<code>mailto:</code> in hyperlink targets. However, it's recommended to
|
||
actually use an email address, since there are a lot of CGI scripts that
|
||
make that assumption. If you want to use an URL, it should point to another
|
||
server under your control. Otherwise users may not be able to contact you in
|
||
case of errors.</p>
|
||
|
||
<p>It may be worth setting up a dedicated address for this, e.g.</p>
|
||
|
||
<pre class="prettyprint lang-config">ServerAdmin www-admin@foo.example.com</pre>
|
||
|
||
<p>as users do not always mention that they are talking about the
|
||
server!</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="ServerAlias" id="ServerAlias">ServerAlias</a> <a name="serveralias" id="serveralias">Directive</a> <a title="Permanent link" href="#serveralias" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Alternate names for a host used when matching requests
|
||
to name-virtual hosts</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerAlias <var>hostname</var> [<var>hostname</var>] ...</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>The <code class="directive">ServerAlias</code> directive sets the
|
||
alternate names for a host, for use with <a href="../vhosts/name-based.html">name-based virtual hosts</a>. The
|
||
<code class="directive">ServerAlias</code> may include wildcards, if appropriate.</p>
|
||
|
||
<pre class="prettyprint lang-config"><VirtualHost *:80>
|
||
ServerName server.example.com
|
||
ServerAlias server server2.example.com server2
|
||
ServerAlias *.example.com
|
||
UseCanonicalName Off
|
||
# ...
|
||
</VirtualHost></pre>
|
||
|
||
|
||
<p>Name-based virtual hosts for the best-matching set of <code class="directive"><a href="#virtualhost"><virtualhost></a></code>s are processed
|
||
in the order they appear in the configuration. The first matching <code class="directive"><a href="#servername">ServerName</a></code> or <code class="directive">ServerAlias</code> is used, with no different precedence for wildcards
|
||
(nor for ServerName vs. ServerAlias). </p>
|
||
|
||
<p>The complete list of names in the <code class="directive"><a href="#virtualhost"><VirtualHost></a></code>
|
||
directive are treated just like a (non wildcard)
|
||
<code class="directive">ServerAlias</code>.</p>
|
||
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
|
||
<li><a href="../vhosts/">Apache HTTP Server Virtual Host documentation</a></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="ServerName" id="ServerName">ServerName</a> <a name="servername" id="servername">Directive</a> <a title="Permanent link" href="#servername" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Hostname and port that the server uses to identify
|
||
itself</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerName [<var>scheme</var>://]<var>domain-name</var>|<var>ip-address</var>[:<var>port</var>]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>The <code class="directive">ServerName</code> directive sets the
|
||
request scheme, hostname and port that the server uses to identify itself.
|
||
</p>
|
||
|
||
<p><code class="directive">ServerName</code> is used (possibly
|
||
in conjunction with <code class="directive"><a href="#serveralias">ServerAlias</a></code>) to uniquely
|
||
identify a virtual host, when using <a href="../vhosts/name-based.html">name-based virtual hosts</a>.</p>
|
||
|
||
<p>Additionally, this is used when
|
||
creating self-referential redirection URLs when
|
||
<code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> is set to a non-default
|
||
value.</p>
|
||
|
||
<p>For example, if the name of the
|
||
machine hosting the web server is <code>simple.example.com</code>,
|
||
but the machine also has the DNS alias <code>www.example.com</code>
|
||
and you wish the web server to be so identified, the following
|
||
directive should be used:</p>
|
||
|
||
<pre class="prettyprint lang-config">ServerName www.example.com</pre>
|
||
|
||
|
||
<p>The <code class="directive">ServerName</code> directive
|
||
may appear anywhere within the definition of a server. However,
|
||
each appearance overrides the previous appearance (within that
|
||
server).</p>
|
||
|
||
<p>If no <code class="directive">ServerName</code> is specified, the
|
||
server attempts to deduce the client visible hostname by first asking
|
||
the operating system for the system hostname, and if that fails,
|
||
performing a reverse lookup on an IP address present on the system.</p>
|
||
|
||
<p>If no port is specified in the
|
||
<code class="directive">ServerName</code>, then the server will use the
|
||
port from the incoming request. For optimal reliability and
|
||
predictability, you should specify an explicit hostname and port
|
||
using the <code class="directive">ServerName</code> directive.</p>
|
||
|
||
<p>If you are using <a href="../vhosts/name-based.html">name-based virtual hosts</a>,
|
||
the <code class="directive">ServerName</code> inside a
|
||
<code class="directive"><a href="#virtualhost"><VirtualHost></a></code>
|
||
section specifies what hostname must appear in the request's
|
||
<code>Host:</code> header to match this virtual host.</p>
|
||
|
||
<p>Sometimes, the server runs behind a device that processes SSL,
|
||
such as a reverse proxy, load balancer or SSL offload
|
||
appliance. When this is the case, specify the
|
||
<code>https://</code> scheme and the port number to which the
|
||
clients connect in the <code class="directive">ServerName</code> directive
|
||
to make sure that the server generates the correct
|
||
self-referential URLs.
|
||
</p>
|
||
|
||
<p>See the description of the
|
||
<code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> and
|
||
<code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code> directives for
|
||
settings which determine whether self-referential URLs (e.g., by the
|
||
<code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> module) will refer to the
|
||
specified port, or to the port number given in the client's request.
|
||
</p>
|
||
|
||
<div class="warning">
|
||
<p>Failure to set <code class="directive">ServerName</code> to a name that
|
||
your server can resolve to an IP address will result in a startup
|
||
warning. <code>httpd</code> will then use whatever hostname it can
|
||
determine, using the system's <code>hostname</code> command. This
|
||
will almost never be the hostname you actually want.</p>
|
||
<div class="example"><p><code>
|
||
httpd: Could not reliably determine the server's fully qualified domain name, using rocinante.local for ServerName
|
||
</code></p></div>
|
||
</div>
|
||
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><a href="../dns-caveats.html">Issues Regarding DNS and
|
||
Apache HTTP Server</a></li>
|
||
<li><a href="../vhosts/">Apache HTTP Server virtual host
|
||
documentation</a></li>
|
||
<li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
|
||
<li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li>
|
||
<li><code class="directive"><a href="#serveralias">ServerAlias</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="ServerPath" id="ServerPath">ServerPath</a> <a name="serverpath" id="serverpath">Directive</a> <a title="Permanent link" href="#serverpath" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Legacy URL pathname for a name-based virtual host that
|
||
is accessed by an incompatible browser</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerPath <var>URL-path</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>The <code class="directive">ServerPath</code> directive sets the legacy
|
||
URL pathname for a host, for use with <a href="../vhosts/">name-based virtual hosts</a>.</p>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><a href="../vhosts/">Apache HTTP Server Virtual Host documentation</a></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="ServerRoot" id="ServerRoot">ServerRoot</a> <a name="serverroot" id="serverroot">Directive</a> <a title="Permanent link" href="#serverroot" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Base directory for the server installation</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerRoot <var>directory-path</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ServerRoot /usr/local/apache</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>The <code class="directive">ServerRoot</code> directive sets the
|
||
directory in which the server lives. Typically it will contain the
|
||
subdirectories <code>conf/</code> and <code>logs/</code>. Relative
|
||
paths in other configuration directives (such as <code class="directive"><a href="#include">Include</a></code> or <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>, for example) are taken as
|
||
relative to this directory.</p>
|
||
|
||
<pre class="prettyprint lang-config">ServerRoot "/home/httpd"</pre>
|
||
|
||
|
||
<p>The default location of <code class="directive">ServerRoot</code> may be
|
||
modified by using the <code>--prefix</code> argument to
|
||
<a href="../programs/configure.html"><code>configure</code></a>, and
|
||
most third-party distributions of the server have a different
|
||
default location from the one listed above.</p>
|
||
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><a href="../invoking.html">the <code>-d</code>
|
||
option to <code>httpd</code></a></li>
|
||
<li><a href="../misc/security_tips.html#serverroot">the
|
||
security tips</a> for information on how to properly set
|
||
permissions on the <code class="directive">ServerRoot</code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="ServerSignature" id="ServerSignature">ServerSignature</a> <a name="serversignature" id="serversignature">Directive</a> <a title="Permanent link" href="#serversignature" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures the footer on server-generated documents</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerSignature On|Off|EMail</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ServerSignature Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>The <code class="directive">ServerSignature</code> directive allows the
|
||
configuration of a trailing footer line under server-generated
|
||
documents (error messages, <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> ftp directory
|
||
listings, <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> output, ...). The reason why you
|
||
would want to enable such a footer line is that in a chain of proxies,
|
||
the user often has no possibility to tell which of the chained servers
|
||
actually produced a returned error message.</p>
|
||
|
||
<p>The <code>Off</code>
|
||
setting, which is the default, suppresses the footer line.
|
||
The <code>On</code> setting simply adds a line with the
|
||
server version number and <code class="directive"><a href="#servername">ServerName</a></code> of the serving virtual host,
|
||
and the <code>EMail</code> setting additionally creates a
|
||
"mailto:" reference to the <code class="directive"><a href="#serveradmin">ServerAdmin</a></code> of the referenced
|
||
document.</p>
|
||
|
||
<p>The details of the server version number
|
||
presented are controlled by the <code class="directive"><a href="#servertokens">ServerTokens</a></code> directive.</p>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#servertokens">ServerTokens</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="ServerTokens" id="ServerTokens">ServerTokens</a> <a name="servertokens" id="servertokens">Directive</a> <a title="Permanent link" href="#servertokens" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures the <code>Server</code> HTTP response
|
||
header</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ServerTokens Full</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>This directive controls whether <code>Server</code> response
|
||
header field which is sent back to clients includes a
|
||
description of the generic OS-type of the server as well as
|
||
information about compiled-in modules.</p>
|
||
|
||
<dl>
|
||
<dt><code>ServerTokens Full</code> (or not specified)</dt>
|
||
|
||
<dd>Server sends (<em>e.g.</em>): <code>Server: Apache/2.4.2
|
||
(Unix) PHP/4.2.2 MyMod/1.2</code></dd>
|
||
|
||
<dt><code>ServerTokens Prod[uctOnly]</code></dt>
|
||
|
||
<dd>Server sends (<em>e.g.</em>): <code>Server:
|
||
Apache</code></dd>
|
||
|
||
<dt><code>ServerTokens Major</code></dt>
|
||
|
||
<dd>Server sends (<em>e.g.</em>): <code>Server:
|
||
Apache/2</code></dd>
|
||
|
||
<dt><code>ServerTokens Minor</code></dt>
|
||
|
||
<dd>Server sends (<em>e.g.</em>): <code>Server:
|
||
Apache/2.4</code></dd>
|
||
|
||
<dt><code>ServerTokens Min[imal]</code></dt>
|
||
|
||
<dd>Server sends (<em>e.g.</em>): <code>Server:
|
||
Apache/2.4.2</code></dd>
|
||
|
||
<dt><code>ServerTokens OS</code></dt>
|
||
|
||
<dd>Server sends (<em>e.g.</em>): <code>Server: Apache/2.4.2
|
||
(Unix)</code></dd>
|
||
|
||
</dl>
|
||
|
||
<p>This setting applies to the entire server, and cannot be
|
||
enabled or disabled on a virtualhost-by-virtualhost basis.</p>
|
||
|
||
<p>This directive also controls the
|
||
information presented by the <code class="directive"><a href="#serversignature">ServerSignature</a></code> directive.</p>
|
||
|
||
<div class="note">Setting <code class="directive">ServerTokens</code> to less than
|
||
<code>minimal</code> is not recommended because it makes it more
|
||
difficult to debug interoperational problems. Also note that
|
||
disabling the Server: header does nothing at all to make your
|
||
server more secure. The idea of "security through obscurity"
|
||
is a myth and leads to a false sense of safety.</div>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#serversignature">ServerSignature</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="SetHandler" id="SetHandler">SetHandler</a> <a name="sethandler" id="sethandler">Directive</a> <a title="Permanent link" href="#sethandler" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Forces all matching files to be processed by a
|
||
handler</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetHandler <var>handler-name</var>|none|<var>expression</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>2.5 and later</td></tr>
|
||
</table>
|
||
<p>When placed into an <code>.htaccess</code> file or a
|
||
<code class="directive"><a href="#directory"><Directory></a></code> or
|
||
<code class="directive"><a href="#location"><Location></a></code>
|
||
section, this directive forces all matching files to be parsed
|
||
through the <a href="../handler.html">handler</a> given by
|
||
<var>handler-name</var>. For example, if you had a directory you
|
||
wanted to be parsed entirely as imagemap rule files, regardless
|
||
of extension, you might put the following into an
|
||
<code>.htaccess</code> file in that directory:</p>
|
||
|
||
<pre class="prettyprint lang-config">SetHandler imap-file</pre>
|
||
|
||
|
||
<p>Another example: if you wanted to have the server display a
|
||
status report whenever a URL of
|
||
<code>http://servername/status</code> was called, you might put
|
||
the following into <code>httpd.conf</code>:</p>
|
||
|
||
<pre class="prettyprint lang-config"><Location "/status">
|
||
SetHandler server-status
|
||
</Location></pre>
|
||
|
||
|
||
<p>You could also use this directive to configure a particular
|
||
handler for files with a particular file extension. For example:</p>
|
||
|
||
<pre class="prettyprint lang-config"><FilesMatch "\.php$">
|
||
SetHandler application/x-httpd-php
|
||
</FilesMatch></pre>
|
||
|
||
|
||
<p>String-valued expressions can be used to reference per-request
|
||
variables, including backreferences to named regular expressions:</p>
|
||
|
||
<pre class="prettyprint lang-config"><LocationMatch ^/app/(?<sub>[^/]+)/>
|
||
SetHandler "proxy:unix:/var/run/app_%{env:MATCH_sub}.sock|fcgi://localhost:8080"
|
||
</LocationMatch></pre>
|
||
|
||
|
||
<p>You can override an earlier defined <code class="directive">SetHandler</code>
|
||
directive by using the value <code>None</code>.</p>
|
||
|
||
<div class="note"><h3>Note</h3>
|
||
<p>Because <code class="directive">SetHandler</code> overrides default handlers,
|
||
normal behavior such as handling of URLs ending in a slash (/) as
|
||
directories or index files is suppressed.</p></div>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="SetInputFilter" id="SetInputFilter">SetInputFilter</a> <a name="setinputfilter" id="setinputfilter">Directive</a> <a title="Permanent link" href="#setinputfilter" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the filters that will process client requests and POST
|
||
input</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetInputFilter <var>filter</var>[;<var>filter</var>...]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>The <code class="directive">SetInputFilter</code> directive sets the
|
||
filter or filters which will process client requests and POST
|
||
input when they are received by the server. This is in addition to
|
||
any filters defined elsewhere, including the
|
||
<code class="directive"><a href="../mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>
|
||
directive.</p>
|
||
|
||
<p>If more than one filter is specified, they must be separated
|
||
by semicolons in the order in which they should process the
|
||
content.</p>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><a href="../filter.html">Filters</a> documentation</li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="SetOutputFilter" id="SetOutputFilter">SetOutputFilter</a> <a name="setoutputfilter" id="setoutputfilter">Directive</a> <a title="Permanent link" href="#setoutputfilter" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the filters that will process responses from the
|
||
server</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetOutputFilter <var>filter</var>[;<var>filter</var>...]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>The <code class="directive">SetOutputFilter</code> directive sets the filters
|
||
which will process responses from the server before they are
|
||
sent to the client. This is in addition to any filters defined
|
||
elsewhere, including the
|
||
<code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>
|
||
directive.</p>
|
||
|
||
<p>For example, the following configuration will process all files
|
||
in the <code>/www/data/</code> directory for server-side
|
||
includes.</p>
|
||
|
||
<pre class="prettyprint lang-config"><Directory "/www/data/">
|
||
SetOutputFilter INCLUDES
|
||
</Directory></pre>
|
||
|
||
|
||
<p>If more than one filter is specified, they must be separated
|
||
by semicolons in the order in which they should process the
|
||
content.</p>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><a href="../filter.html">Filters</a> documentation</li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="StrictHostCheck" id="StrictHostCheck">StrictHostCheck</a> <a name="stricthostcheck" id="stricthostcheck">Directive</a> <a title="Permanent link" href="#stricthostcheck" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls whether the server requires the requested hostname be
|
||
listed enumerated in the virtual host handling the request
|
||
</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>StrictHostCheck ON|OFF</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>StrictHostCheck OFF</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Added in 2.5.1</td></tr>
|
||
</table>
|
||
<p>By default, the server will respond to requests for any hostname,
|
||
including requests addressed to unexpected or unconfigured hostnames.
|
||
While this is convenient, it is sometimes desirable to limit what hostnames
|
||
a backend application handles since it will often generate self-referential
|
||
responses.</p>
|
||
|
||
<p>By setting <code class="directive">StrictHostCheck</code> to <em>ON</em>,
|
||
the server will return an HTTP 400 error if the requested hostname
|
||
hasn't been explicitly listed by either <code class="directive"><a href="#servername">ServerName</a></code> or <code class="directive"><a href="#serveralias">ServerAlias</a></code> in the virtual host that best matches the
|
||
details of the incoming connection.</p>
|
||
|
||
<p>This directive also allows matching of the requested hostname to hostnames
|
||
specified within the opening <code class="directive"><a href="#virtualhost">VirtualHost</a></code>
|
||
tag, which is a relatively obscure configuration mechanism that acts like
|
||
additional <code class="directive"><a href="#serveralias">ServerAlias</a></code> entries.</p>
|
||
|
||
<p>This directive has no affect in non-default virtual hosts. The value
|
||
inherited from the global server configuration, or the default virtualhost
|
||
for the ip:port the underlying connection, determine the effective value.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="TimeOut" id="TimeOut">TimeOut</a> <a name="timeout" id="timeout">Directive</a> <a title="Permanent link" href="#timeout" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Amount of time the server will wait for
|
||
certain events before failing a request</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>TimeOut <var>time-interval</var>[s]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>TimeOut 60</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>The <code class="directive">TimeOut</code> directive defines the length
|
||
of time Apache httpd will wait for I/O in various circumstances:</p>
|
||
|
||
<ul>
|
||
<li><p>When reading data from the client, the length of time to
|
||
wait for a TCP packet to arrive if the read buffer is
|
||
empty.</p>
|
||
<p> For initial data on a new connection, this directive doesn't
|
||
take effect until after any configured <code class="directive"><a href="#acceptfilter">
|
||
AcceptFilter</a></code> has passed the new connection to the server.</p>
|
||
</li>
|
||
|
||
<li>When writing data to the client, the length of time to wait
|
||
for an acknowledgement of a packet if the send buffer is
|
||
full.</li>
|
||
|
||
<li>In <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> and <code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code>,
|
||
the length of time to wait for any individual block of output
|
||
from a CGI script.</li>
|
||
|
||
<li>In <code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code>, the length of time to
|
||
wait for output from a filtering process.</li>
|
||
|
||
<li>In <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, the default timeout value if
|
||
<code class="directive"><a href="../mod/mod_proxy.html#proxytimeout">ProxyTimeout</a></code> is not
|
||
configured.</li>
|
||
</ul>
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="TraceEnable" id="TraceEnable">TraceEnable</a> <a name="traceenable" id="traceenable">Directive</a> <a title="Permanent link" href="#traceenable" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines the behavior on <code>TRACE</code> requests</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>TraceEnable <var>[on|off|extended]</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>TraceEnable on</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>This directive overrides the behavior of <code>TRACE</code> for both
|
||
the core server and <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. The default
|
||
<code>TraceEnable on</code> permits <code>TRACE</code> requests per
|
||
RFC 2616, which disallows any request body to accompany the request.
|
||
<code>TraceEnable off</code> causes the core server and
|
||
<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> to return a <code>405</code> (Method not
|
||
allowed) error to the client.</p>
|
||
|
||
<p>Finally, for testing and diagnostic purposes only, request
|
||
bodies may be allowed using the non-compliant <code>TraceEnable
|
||
extended</code> directive. The core (as an origin server) will
|
||
restrict the request body to 64Kb (plus 8Kb for chunk headers if
|
||
<code>Transfer-Encoding: chunked</code> is used). The core will
|
||
reflect the full headers and all chunk headers with the response
|
||
body. As a proxy server, the request body is not restricted to 64Kb.</p>
|
||
|
||
<div class="note"><h3>Note</h3>
|
||
|
||
<p>Despite claims to the contrary, enabling the <code>TRACE</code>
|
||
method does not expose any security vulnerability in Apache httpd.
|
||
The <code>TRACE</code> method is defined by the HTTP/1.1
|
||
specification and implementations are expected to support it.</p>
|
||
|
||
</div>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="UNCList" id="UNCList">UNCList</a> <a name="unclist" id="unclist">Directive</a> <a title="Permanent link" href="#unclist" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls what UNC host names can be accessed by the server
|
||
</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>UNCList <var>hostname</var> [<var>hostname</var>...]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>unset</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Added in 2.4.60, Windows only.</td></tr>
|
||
</table>
|
||
<p> During request processing, requests to access a filesystem path that
|
||
resolves to a UNC path will fail unless the hostname in the UNC path
|
||
has been specified by this directive. The intent is to limit access to
|
||
paths derived from untrusted inputs.</p>
|
||
|
||
<div class="example"><p><code>
|
||
UNCList example.com other.example.com
|
||
</code></p></div>
|
||
|
||
<div class="warning"><h3>Security</h3>
|
||
<p>UNC paths accessed outside of request processing, such as during startup,
|
||
are not necessarily checked against the hosts configured with this directive.</p>
|
||
</div>
|
||
|
||
<div class="warning"><h3>Directive Ordering</h3>
|
||
<p>This directive should be placed before UNC paths used in httpd.conf.
|
||
Multiple occurrences of the directive reset the list.</p>
|
||
</div>
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="UnDefine" id="UnDefine">UnDefine</a> <a name="undefine" id="undefine">Directive</a> <a title="Permanent link" href="#undefine" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Undefine the existence of a variable</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>UnDefine <var>parameter-name</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>Undoes the effect of a <code class="directive"><a href="#define">Define</a></code> or
|
||
of passing a <code>-D</code> argument to <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</p>
|
||
<p>This directive can be used to toggle the use of <code class="directive"><a href="#ifdefine"><IfDefine></a></code> sections without needing to alter
|
||
<code>-D</code> arguments in any startup scripts.</p>
|
||
|
||
<p>Variable names may not contain colon ":" characters, to avoid clashes
|
||
with <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>'s syntax.</p>
|
||
|
||
<div class="note"><h3>Virtual Host scope and pitfalls</h3>
|
||
<p>While this directive is supported in virtual host context,
|
||
the changes it makes are visible to any later configuration
|
||
directives, beyond any enclosing virtual host.</p>
|
||
</div>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#define">Define</a></code></li>
|
||
<li><code class="directive"><a href="#ifdefine">IfDefine</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="UseCanonicalName" id="UseCanonicalName">UseCanonicalName</a> <a name="usecanonicalname" id="usecanonicalname">Directive</a> <a title="Permanent link" href="#usecanonicalname" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures how the server determines its own name and
|
||
port</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>UseCanonicalName On|Off|DNS</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>UseCanonicalName Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>In many situations Apache httpd must construct a <em>self-referential</em>
|
||
URL -- that is, a URL that refers back to the same server. With
|
||
<code>UseCanonicalName On</code> Apache httpd will use the hostname and port
|
||
specified in the <code class="directive"><a href="#servername">ServerName</a></code>
|
||
directive to construct the canonical name for the server. This name
|
||
is used in all self-referential URLs, and for the values of
|
||
<code>SERVER_NAME</code> and <code>SERVER_PORT</code> in CGIs.</p>
|
||
|
||
<p>With <code>UseCanonicalName Off</code> Apache httpd will form
|
||
self-referential URLs using the hostname and port supplied by
|
||
the client if any are supplied (otherwise it will use the
|
||
canonical name, as defined above). These values are the same
|
||
that are used to implement <a href="../vhosts/name-based.html">name-based virtual hosts</a>
|
||
and are available with the same clients. The CGI variables
|
||
<code>SERVER_NAME</code> and <code>SERVER_PORT</code> will be
|
||
constructed from the client supplied values as well.</p>
|
||
|
||
<p>An example where this may be useful is on an intranet server
|
||
where you have users connecting to the machine using short
|
||
names such as <code>www</code>. You'll notice that if the users
|
||
type a shortname and a URL which is a directory, such as
|
||
<code>http://www/splat</code>, <em>without the trailing
|
||
slash</em>, then Apache httpd will redirect them to
|
||
<code>http://www.example.com/splat/</code>. If you have
|
||
authentication enabled, this will cause the user to have to
|
||
authenticate twice (once for <code>www</code> and once again
|
||
for <code>www.example.com</code> -- see <a href="http://wiki.apache.org/httpd/FAQ#Why_does_Apache_ask_for_my_password_twice_before_serving_a_file.3F">
|
||
the FAQ on this subject for more information</a>). But if
|
||
<code class="directive">UseCanonicalName</code> is set <code>Off</code>, then
|
||
Apache httpd will redirect to <code>http://www/splat/</code>.</p>
|
||
|
||
<p>There is a third option, <code>UseCanonicalName DNS</code>,
|
||
which is intended for use with mass IP-based virtual hosting to
|
||
support ancient clients that do not provide a
|
||
<code>Host:</code> header. With this option, Apache httpd does a
|
||
reverse DNS lookup on the server IP address that the client
|
||
connected to in order to work out self-referential URLs.</p>
|
||
|
||
<div class="warning"><h3>Warning</h3>
|
||
<p>If CGIs make assumptions about the values of <code>SERVER_NAME</code>,
|
||
they may be broken by this option. The client is essentially free
|
||
to give whatever value they want as a hostname. But if the CGI is
|
||
only using <code>SERVER_NAME</code> to construct self-referential URLs,
|
||
then it should be just fine.</p>
|
||
</div>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li>
|
||
<li><code class="directive"><a href="#servername">ServerName</a></code></li>
|
||
<li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="UseCanonicalPhysicalPort" id="UseCanonicalPhysicalPort">UseCanonicalPhysicalPort</a> <a name="usecanonicalphysicalport" id="usecanonicalphysicalport">Directive</a> <a title="Permanent link" href="#usecanonicalphysicalport" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures how the server determines its own port</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>UseCanonicalPhysicalPort On|Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>UseCanonicalPhysicalPort Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p>In many situations Apache httpd must construct a <em>self-referential</em>
|
||
URL -- that is, a URL that refers back to the same server. With
|
||
<code>UseCanonicalPhysicalPort On</code>, Apache httpd will, when
|
||
constructing the canonical port for the server to honor
|
||
the <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> directive,
|
||
provide the actual physical port number being used by this request
|
||
as a potential port. With <code>UseCanonicalPhysicalPort Off</code>,
|
||
Apache httpd will not ever use the actual physical port number, instead
|
||
relying on all configured information to construct a valid port number.</p>
|
||
|
||
<div class="note"><h3>Note</h3>
|
||
<p>The ordering of the lookup when the physical port is used is as
|
||
follows:</p>
|
||
<dl>
|
||
<dt><code>UseCanonicalName Off | DNS</code></dt>
|
||
<dd>
|
||
<ol>
|
||
<li>Parsed port from <code>Host:</code> header</li>
|
||
<li>Physical port (only with <code class="directive">UseCanonicalPhysicalPort</code> ON)</li>
|
||
<li>Port provided in <code class="directive"><a href="#servername">Servername</a></code></li>
|
||
<li>Default port</li>
|
||
</ol>
|
||
</dd>
|
||
<dt><code>UseCanonicalName On</code></dt>
|
||
<dd>
|
||
<ol>
|
||
<li>Port provided in <code class="directive"><a href="#servername">Servername</a></code></li>
|
||
<li>Physical port (only with <code class="directive">UseCanonicalPhysicalPort</code> ON)</li>
|
||
<li>Default port</li>
|
||
</ol>
|
||
</dd>
|
||
</dl>
|
||
|
||
<p>Only with <code>UseCanonicalPhysicalPort On</code>, the
|
||
physical ports are included in the search.</p>
|
||
</div>
|
||
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
|
||
<li><code class="directive"><a href="#servername">ServerName</a></code></li>
|
||
<li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="VirtualHost" id="VirtualHost"><VirtualHost></a> <a name="virtualhost" id="virtualhost">Directive</a> <a title="Permanent link" href="#virtualhost" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply only to a specific
|
||
hostname or IP address</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><VirtualHost
|
||
<var>addr</var>[:<var>port</var>] [<var>addr</var>[:<var>port</var>]]
|
||
...> ... </VirtualHost></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
</table>
|
||
<p><code class="directive"><VirtualHost></code> and
|
||
<code></VirtualHost></code> are used to enclose a group of
|
||
directives that will apply only to a particular virtual host. Any
|
||
directive that is allowed in a virtual host context may be
|
||
used. When the server receives a request for a document on a
|
||
particular virtual host, it uses the configuration directives
|
||
enclosed in the <code class="directive"><VirtualHost></code>
|
||
section. <var>Addr</var> can be any of the following, optionally followed by
|
||
a colon and a port number (or *):</p>
|
||
|
||
<ul>
|
||
<li>The IP address of the virtual host;</li>
|
||
|
||
<li>A fully qualified domain name for the IP address of the
|
||
virtual host (not recommended);</li>
|
||
|
||
<li>The character <code>*</code>, which acts as a wildcard and matches
|
||
any IP address.</li>
|
||
|
||
<li>The string <code>_default_</code>, which is an alias for <code>*</code></li>
|
||
|
||
</ul>
|
||
|
||
<pre class="prettyprint lang-config"><VirtualHost 10.1.2.3:80>
|
||
ServerAdmin webmaster@host.example.com
|
||
DocumentRoot "/www/docs/host.example.com"
|
||
ServerName host.example.com
|
||
ErrorLog "logs/host.example.com-error_log"
|
||
TransferLog "logs/host.example.com-access_log"
|
||
</VirtualHost></pre>
|
||
|
||
|
||
|
||
<p>IPv6 addresses must be specified in square brackets because
|
||
the optional port number could not be determined otherwise. An
|
||
IPv6 example is shown below:</p>
|
||
|
||
<pre class="prettyprint lang-config"><VirtualHost [2001:db8::a00:20ff:fea7:ccea]:80>
|
||
ServerAdmin webmaster@host.example.com
|
||
DocumentRoot "/www/docs/host.example.com"
|
||
ServerName host.example.com
|
||
ErrorLog "logs/host.example.com-error_log"
|
||
TransferLog "logs/host.example.com-access_log"
|
||
</VirtualHost></pre>
|
||
|
||
|
||
<p>Each Virtual Host must correspond to a different IP address,
|
||
different port number, or a different host name for the server,
|
||
in the former case the server machine must be configured to
|
||
accept IP packets for multiple addresses. (If the machine does
|
||
not have multiple network interfaces, then this can be
|
||
accomplished with the <code>ifconfig alias</code> command -- if
|
||
your OS supports it).</p>
|
||
|
||
<div class="note"><h3>Note</h3>
|
||
<p>The use of <code class="directive"><VirtualHost></code> does
|
||
<strong>not</strong> affect what addresses Apache httpd listens on. You
|
||
may need to ensure that Apache httpd is listening on the correct addresses
|
||
using <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>.</p>
|
||
</div>
|
||
|
||
<p>A <code class="directive"><a href="#servername">ServerName</a></code> should be
|
||
specified inside each <code class="directive"><VirtualHost></code> block. If it is absent, the
|
||
<code class="directive"><a href="#servername">ServerName</a></code> from the "main"
|
||
server configuration will be inherited.</p>
|
||
|
||
<p>When a request is received, the server first maps it to the best matching
|
||
<code class="directive"><VirtualHost></code> based on the local
|
||
IP address and port combination only. Non-wildcards have a higher
|
||
precedence. If no match based on IP and port occurs at all, the
|
||
"main" server configuration is used.</p>
|
||
|
||
<p>If multiple virtual hosts contain the best matching IP address and port,
|
||
the server selects from these virtual hosts the best match based on the
|
||
requested hostname. If no matching name-based virtual host is found,
|
||
then the first listed virtual host that matched the IP address will be
|
||
used. As a consequence, the first listed virtual host for a given IP address
|
||
and port combination is the default virtual host for that IP and port
|
||
combination.</p>
|
||
|
||
<div class="warning"><h3>Security</h3>
|
||
<p>See the <a href="../misc/security_tips.html">security tips</a>
|
||
document for details on why your security could be compromised if the
|
||
directory where log files are stored is writable by anyone other
|
||
than the user that starts the server.</p>
|
||
</div>
|
||
|
||
<h3>See also</h3>
|
||
<ul>
|
||
<li><a href="../vhosts/">Apache HTTP Server Virtual Host documentation</a></li>
|
||
<li><a href="../dns-caveats.html">Issues Regarding DNS and
|
||
Apache HTTP Server</a></li>
|
||
<li><a href="../bind.html">Setting
|
||
which addresses and ports Apache HTTP Server uses</a></li>
|
||
<li><a href="../sections.html">How <Directory>, <Location>
|
||
and <Files> sections work</a> for an explanation of how these
|
||
different sections are combined when a request is received</li>
|
||
</ul>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="Warning" id="Warning">Warning</a> <a name="warning" id="warning">Directive</a> <a title="Permanent link" href="#warning" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Warn from configuration parsing with a custom message</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Warning <var>message</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>2.5 and later</td></tr>
|
||
</table>
|
||
<p>If an issue can be detected from within the configuration, this
|
||
directive can be used to generate a custom warning message. The
|
||
configuration parsing is not halted. The typical use is to check
|
||
whether some user define options are set, and warn if not.</p>
|
||
|
||
<pre class="prettyprint lang-config"># Example
|
||
# tell when ReverseProxy is not set
|
||
<IfDefine !ReverseProxy>
|
||
Warning "reverse proxy is not started, hope this is okay!"
|
||
</IfDefine>
|
||
|
||
<IfDefine ReverseProxy>
|
||
# define custom proxy configuration
|
||
</IfDefine></pre>
|
||
|
||
|
||
<div class="warning"><h3>Note</h3>
|
||
<p> This directive is evaluated at configuration processing time,
|
||
not at runtime. As a result, this directive cannot be conditonally
|
||
evaluated by enclosing it in an <code class="directive"><a href="#if"><If></a></code> section.</p>
|
||
</div>
|
||
|
||
</div>
|
||
</div>
|
||
<div class="bottomlang">
|
||
<p><span>Available Languages: </span><a href="../de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
|
||
<a href="../en/mod/core.html" title="English"> en </a> |
|
||
<a href="../es/mod/core.html" hreflang="es" rel="alternate" title="Español"> es </a> |
|
||
<a href="../fr/mod/core.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
|
||
<a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
|
||
<a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
|
||
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
|
||
<script type="text/javascript"><!--//--><![CDATA[//><!--
|
||
var comments_shortname = 'httpd';
|
||
var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/core.html';
|
||
(function(w, d) {
|
||
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
|
||
d.write('<div id="comments_thread"><\/div>');
|
||
var s = d.createElement('script');
|
||
s.type = 'text/javascript';
|
||
s.async = true;
|
||
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
|
||
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
|
||
}
|
||
else {
|
||
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
|
||
}
|
||
})(window, document);
|
||
//--><!]]></script></div><div id="footer">
|
||
<p class="apache">Copyright 2024 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
|
||
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
|
||
if (typeof(prettyPrint) !== 'undefined') {
|
||
prettyPrint();
|
||
}
|
||
//--><!]]></script>
|
||
</body></html> |