diff options
author | Joshua Slive <slive@apache.org> | 2002-09-03 01:13:31 +0000 |
---|---|---|
committer | Joshua Slive <slive@apache.org> | 2002-09-03 01:13:31 +0000 |
commit | 71da11ab4d56ce5028cdf6df0df9b4849ccbfc82 (patch) | |
tree | 35d2900b44d3a0fc7c2c842b552301a9c35fdee6 /docs/manual/sections.html.en | |
parent | 679f82a1d2ead37e57150d648dc0d0354f4fbc89 (diff) | |
download | httpd-71da11ab4d56ce5028cdf6df0df9b4849ccbfc82.tar.gz |
A little fine-tuning of the new sections doc.
This doc could still use some help from an apache
configuration-merging expert.
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@96618 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual/sections.html.en')
-rw-r--r-- | docs/manual/sections.html.en | 27 |
1 files changed, 16 insertions, 11 deletions
diff --git a/docs/manual/sections.html.en b/docs/manual/sections.html.en index bb0c114783..dee07970f7 100644 --- a/docs/manual/sections.html.en +++ b/docs/manual/sections.html.en @@ -9,7 +9,7 @@ use configuration section containers or <code>.htaccess</code> files to change the scope of other configuration directives.</p> <ul><li><a href="#types">Types of Configuration Section Containers</a></li><li><a href="#file-and-web">Filesystem and Webspace</a><ul><li><a href="#filesystem">Filesystem Containers</a></li><li><a href="#webspace">Webspace Containers</a></li><li><a href="#wildcards">Wildcards and Regular Expressions</a></li><li><a href="#whichwhen">What to use When</a></li></ul></li><li><a href="#virtualhost">Virtual Hosts</a></li><li><a href="#proxy">Proxy</a></li><li><a href="#whatwhere">What Directives are Allowed?</a></li><li><a href="#mergin">How the sections are merged</a><ul><li><a href="#merge-examples">Some Examples</a></li></ul></li></ul><hr><h2><a name="types">Types of Configuration Section Containers</a></h2> -<table border="1"><tr><td valign="top"><strong>Related Modules</strong><br><br><code><a href="./mod/core.html">core</a></code><br><code><a href="./mod/mod_proxy.html">mod_proxy</a></code><br></td><td valign="top"><strong>Related Directives</strong><br><br><a href="./mod/core.html#directory" class="directive"><code class="directive"><Directory></code></a><br><a href="./mod/core.html#directorymatch" class="directive"><code class="directive"><DirectoryMatch></code></a><br><a href="./mod/core.html#files" class="directive"><code class="directive"><Files></code></a><br><a href="./mod/core.html#filesmatch" class="directive"><code class="directive"><FilesMatch></code></a><br><a href="./mod/core.html#ifdefine" class="directive"><code class="directive"><IfDefine></code></a><br><a href="./mod/core.html#ifmodule" class="directive"><code class="directive"><IfModule></code></a><br><a href="./mod/core.html#location" class="directive"><code class="directive"><Location></code></a><br><a href="./mod/core.html#locationmatch" class="directive"><code class="directive"><LocationMatch></code></a><br><a href="./mod/proxy.html#proxy" class="directive"><code class="directive"><Proxy></code></a><br><a href="./mod/core.html#virtualhost" class="directive"><code class="directive"><VirtualHost></code></a><br></td></tr></table> +<table border="1"><tr><td valign="top"><strong>Related Modules</strong><br><br><code><a href="./mod/core.html">core</a></code><br><code><a href="./mod/mod_proxy.html">mod_proxy</a></code><br></td><td valign="top"><strong>Related Directives</strong><br><br><a href="./mod/core.html#directory" class="directive"><code class="directive"><Directory></code></a><br><a href="./mod/core.html#directorymatch" class="directive"><code class="directive"><DirectoryMatch></code></a><br><a href="./mod/core.html#files" class="directive"><code class="directive"><Files></code></a><br><a href="./mod/core.html#filesmatch" class="directive"><code class="directive"><FilesMatch></code></a><br><a href="./mod/core.html#ifdefine" class="directive"><code class="directive"><IfDefine></code></a><br><a href="./mod/core.html#ifmodule" class="directive"><code class="directive"><IfModule></code></a><br><a href="./mod/core.html#location" class="directive"><code class="directive"><Location></code></a><br><a href="./mod/core.html#locationmatch" class="directive"><code class="directive"><LocationMatch></code></a><br><a href="./mod/proxy.html#proxy" class="directive"><code class="directive"><Proxy></code></a><br><a href="./mod/proxy.html#proxymatch" class="directive"><code class="directive"><ProxyMatch></code></a><br><a href="./mod/core.html#virtualhost" class="directive"><code class="directive"><VirtualHost></code></a><br></td></tr></table> <p>There are two basic types of containers. Most containers are evaluated for each request. The enclosed directives are applied only @@ -165,13 +165,17 @@ SetHandler server-status<br> <p>The <a href="./mod/core.html#directory" class="directive"><code class="directive"><Directory></code></a>, <a href="./mod/core.html#files" class="directive"><code class="directive"><Files></code></a>, and <a href="./mod/core.html#location" class="directive"><code class="directive"><Location></code></a> -directives can each use the shell-style wildcard characters "?" to -match any single character, "*" to match any set of characters, and -character classes like [a-zA-Z] to match particular characters. This -is useful to apply the same configuration to a group of filesystem or -webspace locations. If even more flexible matching is required, each +directives can each use shell-style wildcard characters as in +<code>fnmatch</code> from the C standard library. The character "*" +matches any sequence of characters, "?" matches any single character, +and "[<em>seq</em>]" matches any character in <em>seq</em>. The "/" +character will not be matched by any wildcard; it must be specified +explictly.</p> + +<p>If even more flexible matching is required, each container has a regular-expression (regex) counterpart <a href="./mod/core.html#directorymatch" class="directive"><code class="directive"><DirectoryMatch></code></a>, <a href="./mod/core.html#filesmatch" class="directive"><code class="directive"><FilesMatch></code></a>, and <a href="./mod/core.html#locationmatch" class="directive"><code class="directive"><LocationMatch></code></a> that allow -perl-compatible<a href="glossary.html#regex">regular expressions</a> +perl-compatible +<a href="glossary.html#regex">regular expressions</a> to be used in choosing the matches. But see the section below on configuration merging to find out how using regex sections will change how directives are applied.</p> @@ -249,8 +253,9 @@ with a different configuration for each. For more information, see the <a href="vhosts/">Virtual Host Documentation</a>.</p> <h2><a name="proxy">Proxy</a></h2> -<p>The <a href="./mod/proxy.html#proxy" class="directive"><code class="directive"><Proxy></code></a> -container applies enclosed configuration directives only +<p>The <a href="./mod/mod_proxy.html#proxy" class="directive"><code class="directive"><Proxy></code></a> +and <a href="./mod/mod_proxy.html#proxymatch" class="directive"><code class="directive"><ProxyMatch></code></a> +containers apply enclosed configuration directives only to sites accessed through <code><a href="./mod/mod_proxy.html">mod_proxy</a></code>'s proxy server that match the specified URL. For example, the following configuration will prevent the proxy server from being used to access the @@ -274,8 +279,8 @@ sections is also syntactically allowed in <a href="./mod/core.html#filesmatch" class="directive"><code class="directive"><FilesMatch></code></a>, <a href="./mod/core.html#location" class="directive"><code class="directive"><Location></code></a>, <a href="./mod/core.html#locationmatch" class="directive"><code class="directive"><LocationMatch></code></a>, -and -<a href="./mod/proxy.html#proxy" class="directive"><code class="directive"><Proxy></code></a> +<a href="./mod/proxy.html#proxy" class="directive"><code class="directive"><Proxy></code></a>, +and <a href="./mod/proxy.html#proxymatch" class="directive"><code class="directive"><ProxyMatch></code></a> sections. There are some exceptions, however.</p> <ul> |