Apache HTTP Server中的表达式

Backus-Naur形式表示法的语法

Backus-Naur形式（BNF）是无上下文语法的一种注释技术，通常用于描述计算中使用的语言的语法。在大多数情况下，表达式用于表示布尔值。对于这些，BNF的起点是expr。但是，一些指令（例如LogMessageaccept表达式）的结果为字符串值。对于这些，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 ")"

变数

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

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

其他与请求相关的变量

杂项变量

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

二元运算符

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

比较运算符

其他二进制运算符

一元运算符

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

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

功能

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

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

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

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

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

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

范例表达式

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

# 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'}"

其他

正则表达式反向引用

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

与SSLRequire的比较

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

版本记录

该req_novary 功能 可用于2.4.4和更高版本。