diff options
author | André Malo <nd@apache.org> | 2014-01-29 13:33:12 +0000 |
---|---|---|
committer | André Malo <nd@apache.org> | 2014-01-29 13:33:12 +0000 |
commit | 88d87da6a459219aea96a83303afb7fa2139ff0b (patch) | |
tree | aeb840ac7e04593991d8bfd9689975e9b67f101b /docs/manual/expr.html.en | |
parent | cabae8de6aba546e33253956e8a121ffca64c1e8 (diff) | |
download | httpd-88d87da6a459219aea96a83303afb7fa2139ff0b.tar.gz |
update transformation
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1562439 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual/expr.html.en')
-rw-r--r-- | docs/manual/expr.html.en | 61 |
1 files changed, 34 insertions, 27 deletions
diff --git a/docs/manual/expr.html.en b/docs/manual/expr.html.en index d288cd218a..064d7aaa8b 100644 --- a/docs/manual/expr.html.en +++ b/docs/manual/expr.html.en @@ -25,17 +25,15 @@ <a href="./fr/expr.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p> </div> - <p>Historically, there are several syntax variants for expressions used to express - a condition in the different modules of the Apache HTTP Server. - There is some ongoing effort to only use a single variant, called <em>ap_expr</em>, - for all configuration directives. - This document describes the <em>ap_expr</em> expression parser. + <p>Historically, there are several syntax variants for expressions + used to express a condition in the different modules of the Apache + HTTP Server. There is some ongoing effort to only use a single + variant, called <em>ap_expr</em>, for all configuration directives. + This document describes the <em>ap_expr</em> expression parser. </p> <p>The <em>ap_expr</em> expression is intended to replace most other - expression variants in HTTPD. For example, the deprecated - <code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code> expressions can be - replaced by <a href="mod/mod_authz_core.html#reqexpr">Require expr</a>. - </p> + expression variants in HTTPD. For example, the deprecated <code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code> expressions can be replaced + by <a href="mod/mod_authz_core.html#reqexpr">Require expr</a>. </p> </div> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#grammar">Grammar in Backus-Naur Form notation</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#vars">Variables</a></li> @@ -51,12 +49,14 @@ <div class="section"> <h2><a name="grammar" id="grammar">Grammar in Backus-Naur Form notation</a></h2> - <p><a href="http://en.wikipedia.org/wiki/Backus%E2%80%93Naur_Form">Backus-Naur Form</a> (BNF) is a notation - technique for context-free grammars, often used to describe the syntax of languages used in computing. + <p><a href="http://en.wikipedia.org/wiki/Backus%E2%80%93Naur_Form">Backus-Naur + Form</a> (BNF) is a notation technique for context-free grammars, + often used to describe the syntax of languages used in computing. In most cases, expressions are used to express boolean values. - For these, the starting point in the BNF is <code>expr</code>. However, a few directives - like <code class="directive"><a href="./mod/mod_log_debug.html#logmessage">LogMessage</a></code> accept expressions - that evaluate to a string value. For those, the starting point in the BNF is <code>string</code>. + For these, the starting point in the BNF is <code>expr</code>. + However, a few directives like <code class="directive"><a href="./mod/mod_log_debug.html#logmessage">LogMessage</a></code> accept expressions + that evaluate to a string value. For those, the starting point in + the BNF is <code>string</code>. </p> <blockquote> <pre> @@ -216,8 +216,8 @@ listfunction ::= listfuncname "<strong>(</strong>" word "<strong>)</strong>" <td>The <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> of the current vhost</td></tr> <tr><td><code>AUTH_TYPE</code></td> - <td>The configured <code class="directive"><a href="./mod/mod_authn_core.html#authtype">AuthType</a></code> - (e.g. "<code>basic</code>")</td></tr> + <td>The configured <code class="directive"><a href="./mod/mod_authn_core.html#authtype">AuthType</a></code> (e.g. + "<code>basic</code>")</td></tr> <tr class="odd"><td><code>CONTENT_TYPE</code></td> <td>The content type of the response</td></tr> <tr><td><code>HANDLER</code></td> @@ -262,14 +262,16 @@ listfunction ::= listfuncname "<strong>(</strong>" word "<strong>)</strong>" <td>The day of the week (starting with <code>0</code> for Sunday)</td></tr> <tr class="odd"><td><code>TIME</code></td> - <td>The date and time in the format <code>20101231235959</code></td></tr> + <td>The date and time in the format + <code>20101231235959</code></td></tr> <tr><td><code>SERVER_SOFTWARE</code></td> <td>The server version string</td></tr> <tr class="odd"><td><code>API_VERSION</code></td> <td>The date of the API version (module magic number)</td></tr> </table> - <p>Some modules register additional variables, see e.g. <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>.</p> + <p>Some modules register additional variables, see e.g. + <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div> <div class="section"> @@ -392,7 +394,8 @@ listfunction ::= listfuncname "<strong>(</strong>" word "<strong>)</strong>" "<code>false</code>", or "<code>no</code>" (case insensitive). True otherwise.</td><td /></tr> <tr><td><code>-R</code></td> - <td>Same as "<code>%{REMOTE_ADDR} -ipmatch ...</code>", but more efficient + <td>Same as "<code>%{REMOTE_ADDR} -ipmatch ...</code>", but more + efficient </td><td /></tr> </table> @@ -417,7 +420,9 @@ listfunction ::= listfuncname "<strong>(</strong>" word "<strong>)</strong>" <tr><td><code>resp</code></td> <td>Get HTTP response header</td><td /></tr> <tr class="odd"><td><code>reqenv</code></td> - <td>Lookup request environment variable (as a shortcut, <code>v</code> can be used too to access variables).</td><td /></tr> + <td>Lookup request environment variable (as a shortcut, + <code>v</code> can be used too to access + variables).</td><td /></tr> <tr><td><code>osenv</code></td> <td>Lookup operating system environment variable</td><td /></tr> <tr class="odd"><td><code>note</code></td> @@ -461,11 +466,11 @@ listfunction ::= listfuncname "<strong>(</strong>" word "<strong>)</strong>" the expression. The <code>req_novary</code> function can be used to prevent names from being added to the Vary header.</p> - <p>In addition to string-valued functions, there are also list-valued functions which - take one string as argument and return a wordlist, i.e. a list of strings. The wordlist - can be used with the special <code>-in</code> operator. - Functions names are not case sensitive. - Modules may register additional functions.</p> + <p>In addition to string-valued functions, there are also + list-valued functions which take one string as argument and return a + wordlist, i.e. a list of strings. The wordlist can be used with the + special <code>-in</code> operator. Functions names are not case + sensitive. Modules may register additional functions.</p> <p>There are no built-in list-valued functions. <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> provides <code>PeerExtList</code>. See the description of @@ -478,7 +483,8 @@ listfunction ::= listfuncname "<strong>(</strong>" word "<strong>)</strong>" <h2><a name="examples" id="examples">Example expressions</a></h2> - <p>The following examples show how expressions might be used to evaluate requests:</p> + <p>The following examples show how expressions might be used to + evaluate requests:</p> <pre class="prettyprint lang-config"> # Compare the host name to example.com and redirect to www.example.com if it matches @@ -508,7 +514,8 @@ listfunction ::= listfuncname "<strong>(</strong>" word "<strong>)</strong>" <td>string contained in string list</td></tr> <tr class="odd"><td><code>/regexp/</code></td> <td><code>m#regexp#</code></td> - <td>Regular expression (the second form allows different delimiters than /)</td></tr> + <td>Regular expression (the second form allows different + delimiters than /)</td></tr> <tr><td><code>/regexp/i</code></td> <td><code>m#regexp#i</code></td> <td>Case insensitive regular expression</td></tr> |