ap_expr 表达式解析器

注: 在某些模块 (例如 mod_include ) 中，标记为 "restricted" 的运算符不可用。

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

注: 在最后一列中标记为 "受限" 的函数在某些模块 (例如 mod_include) 中不可用。

在最终列中标记为 "排序" 的函数需要对服务器的不同组件进行排序进行一些考虑，尤其是当在相对早期求值的 <If> 伪指令中使用该函数时。

环境变量排序

在 <If> 条件中查找环境变量时，请务必考虑请求处理中发生此解析的非常早的时间。 作为准则，在虚拟主机上下文 (目录，位置， htaccess) 外部定义的任何伪指令都不可能还没有执行的机会。 虚拟主机作用域中的SetEnvIf是在该决议之前运行的一条指令。

在 <If>外部使用 reqenv 时，通常稍后会发生解析，但确切的计时取决于已在其中使用表达式的伪指令。

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

除了字符串值函数之外，还有列表值函数以一个字符串作为参数并返回一个 wordlist ，即一个字符串列表。 可将 wordlist 与特殊的 in 运算符一起使用 (请参阅下文)。 函数名不区分大小写。 没有内置列表值函数。

示例：

# 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 examples 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 允许引用先前执行的成功匹配正则表达式中的捕获组。 它们通常只能在与匹配正则表达式相同的表达式中使用，但某些模块允许特殊使用。

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