Apache 中的表达式

从历史上看，有几种表达式的语法变体用于表示 Apache HTTP Server 的不同模块中的条件。目前正在努力仅为所有 configuration 指令使用一个名为 ap_expr 的变体。本文档描述了 ap_expr 表达式解析器。

ap_expr 表达式旨在替换 HTTPD 中的大多数其他表达式变体。对于 example，不推荐使用的SSLRequire表达式可以替换为要求 expr。

语法 Backus-Naur 表格符号

Backus-Naur 表格(BNF)是 context-free 语法的表示法技术，通常用于描述计算中使用的语言的语法。在大多数情况下，表达式用于表示 boolean 值。对于这些，BNF 的起点是expr。但是，像LogMessage这样的一些指令会接受求值为 string value 的表达式。对于那些人来说，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}形式的变量。请注意，变量的 value 可能取决于评估它的请求处理的阶段。对于 example，在完成身份验证之前会评估<If >指令中使用的表达式。因此，在这种情况下不会设置%{REMOTE_USER}。

以下变量提供了命名的 HTTP 请求 headers 的值。可以使用req功能获取其他 headers 的值。使用这些变量可能会导致 header name 被添加到 HTTP 响应的 Vary 标头中，除非接受表达式的指令另有说明。req_novary功能可用于规避此行为。

其他请求相关变量

其他变量

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

二进制操作员

对于某些 built-in 比较 operators 的 exception，binary operators 的形式为“-[a-zA-Z][a-zA-Z0-9_]+”，i.e。一个减号和至少两个字符。 name 不区分大小写。模块可以注册其他二进制 operators。

比较 operators

其他二进制 operators

一元操作员

一元 operators 采用一个参数，形式为“-[a-zA-Z]”，i.e。一个减号和一个字符。 name 区分大小写。模块可以注册其他一元运算符。

标记为“受限制”的 operators 在mod_include等某些模块中不可用。

功能

普通 string-valued 函数将一个 string 作为参数，return 一个 string。函数名称不区分大小写。模块可以注册其他功能。

最终列中标记为“受限制”的功能在mod_include等某些模块中不可用。

在最后一列中标记为“ordering”的函数需要考虑服务器的不同组件的 ordering，尤其是在<1>指令中使用 function 时，相对较早地进行评估。

环境变量 ordering

当在<如果>条件中查找环境变量时，重要的是要考虑在此请求处理过早发生此解决方案的时间。作为指导原则，在虚拟 host context(目录，位置，htaccess)之外定义的任何指令都不太可能有机会执行。虚拟 host 范围中的SetEnvIf 之后是在此解决方案之前运行的一个指令

当在<如果>之外使用reqenv时，分辨率通常会在稍后发生，但确切的时间取决于表达式在其中使用的指令。

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

除了 string-valued 函数之外，还有 list-valued 函数，它们将一个 string 作为参数并_返回一个 wordlist，i.e。 strings 列表。 wordlist 可以与特殊的-in operator 一起使用。函数名称不区分大小写。模块可以注册其他功能。

没有 built-in list-valued 函数。 mod_ssl提供PeerExtList。有关详细信息，请参阅SSLRequire的说明(但PeerExtList也可在SSLRequire之外使用)。

Example 表达式

以下示例显示了如何使用表达式来评估请求：

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

其他

正则表达式反向引用

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

与 SSLRequire 的比较

ap_expr 语法主要是不推荐使用的SSLRequire指令语法的超集。差异在SSLRequire的文档中描述。

Version History

req_novary功能适用于 2.4.4 及更高版本。