ap_expr 表示式剖析器

附註: 標示為「受限」的運算子在某些模組中無法使用，例如 mod_include 。

# 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) 可能還沒有機會執行。 SetEnv如果虛擬主機範圍中的 是在此解析之前執行的指引。

在 <If>外部使用 reqenv 時，解決方案通常會在稍後發生，但確切的計時取決於在其中使用表示式的指引。

使用函數 req 或 http 時，標頭名稱會自動新增至 HTTP 回應的 Vary 標頭，但接受表示式之指引的其他附註除外。 req_novary 函數可用來防止名稱新增至 Vary 標頭。

除了字串值函數之外，還有以一個字串作為引數並傳回字組清單 (即字串清單) 的清單值函數。 字組清單可以與特殊 -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>