Apache HTTP Server 中的表达式

历史上，Apache HTTP Server 的不同模块中用于表达条件的表达式有多种语法变体。目前正在进行一些努力，仅对所有配置指令使用一个名为* ap_expr 的变体。本文档介绍 ap_expr *表达式解析器。

• ap_expr *表达式旨在替换 HTTPD 中的大多数其他表达式变体。例如，不赞成使用的SSLRequire表达式可以替换为Require expr。

Backus-Naur 格式的语法

Backus-Naur Form(BNF)是无上下文语法的一种标记技术，通常用于描述计算中使用的语言的语法。在大多数情况下，表达式用于表示布尔值。对于这些，BNF 中的起点是expr。但是，一些伪指令，例如LogMessage接受表达式，该表达式的结果为字符串值。对于这些，BNF 的起点是string。

expr        ::= "true" | "false"
| "!" expr
| expr "&&" expr
| expr "||" expr
| "(" expr ")"
| comp

comp        ::= stringcomp
| integercomp
| unaryop word
| word binaryop word
| word "in" "{" wordlist "}"
| word "in" listfunction
| word "=~" regex
| word "!~" regex

stringcomp  ::= word "==" word
| word "!=" word
| word "<"  word
| word "<=" word
| word ">"  word
| word ">=" word

integercomp ::= word "-eq" word | word "eq" word
| word "-ne" word | word "ne" word
| word "-lt" word | word "lt" word
| word "-le" word | word "le" word
| word "-gt" word | word "gt" word
| word "-ge" word | word "ge" word

wordlist    ::= word
| wordlist "," word

word        ::= word "." word
| digit
| "'" string "'"
| """ string """
| variable
| rebackref
| function

string      ::= stringpart
| string stringpart

stringpart  ::= cstring
| variable
| rebackref

cstring     ::= ...
digit       ::= [0-9]+

variable    ::= "%{" varname "}"
| "%{" funcname ":" funcargs "}"

rebackref   ::= "$" [0-9]

function     ::= funcname "(" word ")"

listfunction ::= listfuncname "(" word ")"

Variables

表达式解析器提供了许多形式为%{HTTP_HOST}的变量。注意，变量的值可能取决于对其进行评估的请求处理的阶段。例如，在完成身份验证之前，先对<If >指令中使用的表达式进行求值。因此，在这种情况下不会设置%{REMOTE_USER}。

以下变量提供命名的 HTTP 请求 Headers 的值。其他 Headers 的值可以通过req function获得。使用这些变量可能会导致将 Headers 名称添加到 HTTP 响应的 Vary Headers 中，除非在接受表达式的指令中另有说明。 req_novary function可用于规避此行为。

其他与请求相关的变量

Misc variables

某些模块会注册其他变量，请参见例如mod_ssl。

Binary operators

除某些内置比较运算符外，二进制运算符的格式为“ -[a-zA-Z][a-zA-Z0-9_]+”，即减号和至少两个字符。名称不区分大小写。模块可以注册其他二进制运算符。

Comparison operators

其他二进制运算符

Unary operators

一元运算符采用一个参数，格式为“ -[a-zA-Z]”，即减号和一个字符。名称*区分大小写。模块可以注册其他一元运算符。

标记为“受限”的运算符在mod_include之类的某些模块中不可用。

Functions

普通的字符串值函数将一个字符串作为参数并返回一个字符串。函数名称不区分大小写。模块可以注册其他功能。

在最后一栏中标记为“受限”的功能在mod_include之类的某些模块中不可用。

在最后一栏中标记为“ ordering”的功能需要对服务器的不同组件的 Sequences 进行一些考虑，尤其是在<If>指令中使用该功能时，该指令的评估相对较早。

使用函数req或http时，Headers 名称将自动添加到 HTTP 响应的 Vary Headers 中，除非在接受表达式的指令中另有说明。 req_novary函数可用于防止将名称添加到 Vary Headers 中。

除了字符串值函数外，还有一些列表值函数，它们将一个字符串作为参数并返回一个单词列表，即一个字符串列表。单词表可以与特殊的-in运算符一起使用。函数名称不区分大小写。模块可以注册其他功能。

没有内置的列表值函数。 mod_ssl提供PeerExtList。有关详细信息，请参见SSLRequire的描述(但SSLRequire之外也可以使用PeerExtList)。

Example expressions

以下示例说明如何使用表达式评估请求：

# Compare the host name to example.com and redirect to www.example.com if it matches
<If "%{HTTP_HOST} == 'example.com'">
    Redirect permanent "/" "http://www.example.com/"
</If>

# Force text/plain if requesting a file with the query string contains 'forcetext'
<If "%{QUERY_STRING} =~ /forcetext/">
    ForceType text/plain
</If>

# Only allow access to this content during business hours
<Directory "/foo/bar/business">
    Require expr %{TIME_HOUR} -gt 9 && %{TIME_HOUR} -lt 17
</Directory>

# Check a HTTP header for a list of values
<If "%{HTTP:X-example-header} in { 'foo', 'bar', 'baz' }">
    Header set matched true
</If>

# Check an environment variable for a regular expression, negated.
<If "! reqenv('REDIRECT_FOO') =~ /bar/">
    Header set matched true
</If>

# Check result of URI mapping by running in Directory context with -f
<Directory "/var/www">
    AddEncoding x-gzip gz
<If "-f '%{REQUEST_FILENAME}.unzipme' && ! %{HTTP:Accept-Encoding} =~ /gzip/">
      SetOutputFilter INFLATE
</If>
</Directory>

# Check against the client IP
<If "-R '192.168.1.0/24'">
    Header set matched true
</If>

# Function example in boolean context
<If "md5('foo') == 'acbd18db4cc2f85cedef654fccc4a4d8'">
  Header set checksum-matched true
</If>

# Function example in string context
Header set foo-checksum "expr=%{md5:foo}"

# This delays the evaluation of the condition clause compared to <If>
Header always set CustomHeader my-value "expr=%{REQUEST_URI} =~ m#^/special_path\.php$#"

# Conditional logging
CustomLog logs/access-errors.log common "expr=%{REQUEST_STATUS} >= 400"
CustomLog logs/access-errors-specific.log common "expr=%{REQUEST_STATUS} -in {'405','410'}"

Other

正则表达式反向引用

字符串$0 ... $9允许引用先前执行的，成功匹配正则表达式的捕获组。通常，它们只能与匹配的正则表达式在同一表达式中使用，但是某些模块允许特殊用途。

与 SSLRequire 比较

• ap_expr *语法主要是已弃用的SSLRequire指令的语法的超集。差异在SSLRequire的文档中进行了描述。

Version History

req_novary function可用于 2.4.4 和更高版本。