From: Eric Covener Date: Sat, 17 Sep 2016 20:42:23 +0000 (+0000) Subject: xforms X-Git-Tag: 2.4.24~239 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=4310585d7194f3dab4f40d93479210fd57623ecc;p=thirdparty%2Fapache%2Fhttpd.git xforms git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1761276 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/expr.html.en b/docs/manual/expr.html.en index 9bd50b620c7..87af8f4a2e2 100644 --- a/docs/manual/expr.html.en +++ b/docs/manual/expr.html.en @@ -23,7 +23,8 @@
Apache > HTTP Server > Documentation > Version 2.4

Expressions in Apache HTTP Server

-

Available Languages:  en  | +

Available Languages:  edited  | + en  |  fr 

@@ -418,7 +419,7 @@ listfunction ::= listfuncname "(" word ")" - +
NameDescriptionRestricted
@@ -429,15 +430,15 @@ listfunction ::= listfuncname "(" word ")"Get HTTP response header + v can also be used to access variables). + - + + osenv @@ -460,14 +461,37 @@ listfunction ::= listfuncname "(" word ")" - + + + + + regular file)
NameDescriptionSpecial notes
req, http Get HTTP request header; header names may be added to the Vary header, see below
reqenv Lookup request environment variable (as a shortcut, - v can be used too to access - variables).
ordering
osenv Lookup operating system environment variable
noteLookup request note
Lookup request noteordering
env Return first match of note, reqenv, - osenv
ordering
tolower Convert string to lower case
toupper
file Read contents from a file (including line endings, when present) - yes
filesizerestricted
filemodReturn last modification time of a file (or 0 if file does not exist + or is not regular file)restricted
filesize Return size of a file (or 0 if file does not exist or is not - regular file)yes
restricted
-

The functions marked as "restricted" are not available in some modules - like mod_include.

+

The functions marked as "restricted" in the final column are not + available in some modules like mod_include.

+ +

The functions marked as "ordering" in the final column require some + consideration for the ordering of different components of the server, + especially when the function is used within the + <If> directive which is + evaluated relatively early.

+
+

Environment variable ordering

+ When environment variables are looked up within an + <If> condition, it's important + to consider how extremely early in request processing that this + resolution occurs. As a guideline, any directive defined outside of virtual host + context (directory, location, htaccess) is not likely to have yet had a + chance to execute. SetEnvIf + in virtual host scope is one directive that runs prior to this resolution +
+
+ When reqenv is used outside of <If>, the resolution will generally occur later, but the + exact timing depends on the directive the expression has been used within. +

When the functions req or http are used, the header name will automatically be added to the Vary header of the @@ -589,7 +613,8 @@ Header always set CustomHeader my-value "expr=%{REQUEST_URI} =~ m#^/special_path is available for versions 2.4.4 and later.

-

Available Languages:  en  | +

Available Languages:  edited  | + en  |  fr 

top

Comments

Notice:
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 again 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 Freenode, or sent to our mailing lists.