Apache 模块 mod_rewrite

RewriteBase 指令

RewriteBase 指令指定用于每个目录（htaccess）RewriteRule 指令的基本 URL，这些指令替换相对路径。

当您在每个目录（htaccess）上下文中使用替换中的相对路径时，此指令是必需的，除非以下任一条件为真

• 原始请求和替换位于 DocumentRoot 下（而不是通过其他方式访问，例如 Alias）。
• 包含 RewriteRule 的目录的文件系统路径，后缀为相对替换，在服务器上也作为 URL 路径有效（这很少见）。
• 在 Apache HTTP Server 2.4.16 及更高版本中，当请求通过 Alias 或 mod_userdir 映射时，可以省略此指令。

在下面的示例中，RewriteBase 是必需的，以避免重写到 http://example.com/opt/myapp-1.2.3/welcome.html，因为资源不是相对于文档根目录的。此错误配置通常会导致服务器在文档根目录下查找“opt”目录。

DocumentRoot "/var/www/example.com"
AliasMatch "^/myapp" "/opt/myapp-1.2.3"
<Directory "/opt/myapp-1.2.3">
    RewriteEngine On
    RewriteBase "/myapp/"
    RewriteRule "^index\.html$"  "welcome.html"
</Directory>

RewriteCond 指令

RewriteCond 指令定义规则条件。一个或多个 RewriteCond 可以位于 RewriteRule 指令之前。只有当 URI 的当前状态与其模式匹配，并且满足这些条件时，才会使用以下规则。

TestString 是一个字符串，除了纯文本之外，它还可以包含以下扩展结构

• RewriteRule 反向引用：这些是 $N (0 <= N <= 9) 形式的反向引用。$1 到 $9 提供对来自 RewriteRule 的模式的已分组部分（在括号中）的访问，该 RewriteRule 受当前 RewriteCond 条件集的约束。$0 提供对该模式匹配的整个字符串的访问。
• RewriteCond 反向引用：这些是 %N (0 <= N <= 9) 形式的反向引用。%1 到 %9 提供对来自当前条件集中最后匹配的 RewriteCond 的模式的已分组部分（同样，在括号中）的访问。%0 提供对该模式匹配的整个字符串的访问。
• RewriteMap 扩展：这些是 ${mapname:key|default} 形式的扩展。有关更多详细信息，请参阅 RewriteMap 的文档。
• 服务器变量：这些是 %{ NAME_OF_VARIABLE } 形式的变量，其中 NAME_OF_VARIABLE 可以是以下列表中的字符串

  HTTP 标头	连接和请求
  HTTP_ACCEPT HTTP_COOKIE HTTP_FORWARDED HTTP_HOST HTTP_PROXY_CONNECTION HTTP_REFERER HTTP_USER_AGENT	AUTH_TYPE CONN_REMOTE_ADDR CONTEXT_PREFIX CONTEXT_DOCUMENT_ROOT IPV6 PATH_INFO QUERY_STRING REMOTE_ADDR REMOTE_HOST REMOTE_IDENT REMOTE_PORT REMOTE_USER REQUEST_METHOD SCRIPT_FILENAME
  服务器内部	日期和时间	特殊
  DOCUMENT_ROOT SCRIPT_GROUP SCRIPT_USER SERVER_ADDR SERVER_ADMIN SERVER_NAME SERVER_PORT SERVER_PROTOCOL SERVER_SOFTWARE	TIME_YEAR TIME_MON TIME_DAY TIME_HOUR TIME_MIN TIME_SEC TIME_WDAY TIME	API_VERSION CONN_REMOTE_ADDR HTTPS IS_SUBREQ REMOTE_ADDR REQUEST_FILENAME REQUEST_SCHEME REQUEST_URI THE_REQUEST

  这些变量都对应于同名的 HTTP MIME 标头、Apache HTTP Server 的 C 变量或 Unix 系统的 struct tm 字段。大多数在 此处 或手册的其他地方或 CGI 规范中都有记录。

  SERVER_NAME 和 SERVER_PORT 分别取决于 UseCanonicalName 和 UseCanonicalPhysicalPort 的值。

  那些对 mod_rewrite 特殊的包括以下内容。

  API_VERSION

  这是当前 httpd 构建中 Apache httpd 模块 API（服务器和模块之间的内部接口）的版本，如 include/ap_mmn.h 中定义。模块 API 版本对应于正在使用的 Apache httpd 版本（例如，在 Apache httpd 1.3.14 的发行版中，它是 19990320:10），但这主要对模块作者有用。

  CONN_REMOTE_ADDR

  自 2.4.8 起：连接的对等方 IP 地址（请参阅 mod_remoteip 模块）。

  HTTPS

  如果连接使用 SSL/TLS，则将包含文本“on”，否则包含“off”。（无论是否加载 mod_ssl，此变量都可以安全使用）。

  IS_SUBREQ

  如果当前正在处理的请求是子请求，则将包含文本“true”，否则包含“false”。子请求可能由需要解析其他文件或 URI 以完成其任务的模块生成。

  REMOTE_ADDR

  远程主机的 IP 地址（请参阅 mod_remoteip 模块）。

  REQUEST_FILENAME

  与请求匹配的文件或脚本的完整本地文件系统路径，如果在引用 REQUEST_FILENAME 时服务器已确定此路径。否则，例如在虚拟主机上下文中，与 REQUEST_URI 相同的值。根据 AcceptPathInfo 的值，服务器可能只使用 REQUEST_URI 的一些前导组件来将请求映射到文件。

  REQUEST_SCHEME

  将包含请求的方案（通常是“http”或“https”）。此值可以通过 ServerName 影响。

  REQUEST_URI

  请求的 URI 的路径组件，例如“/index.html”。这尤其不包括查询字符串，查询字符串作为名为 QUERY_STRING 的独立变量提供。返回的 REQUEST_URI 值已进行 %-解码，要对其进行重新编码，请将其通过“escape” 映射函数 传递。

  THE_REQUEST

  浏览器发送到服务器的完整 HTTP 请求行（例如，“GET /index.html HTTP/1.1”）。这并不包括浏览器发送的任何其他标头。此值未进行转义（解码），与下面大多数其他变量不同。

如果 TestString 的特殊值为 expr，则 CondPattern 将被视为 ap_expr。如果未给出 novary 标志，则表达式中引用的 HTTP 标头将被添加到 Vary 标头中。

您应该注意的其他事项

1. 变量 SCRIPT_FILENAME 和 REQUEST_FILENAME 包含相同的值 - Apache HTTP Server 的内部 request_rec 结构的 filename 字段的值。第一个名称是众所周知的 CGI 变量名称，而第二个名称是 REQUEST_URI 的适当对应项（它包含 request_rec 的 uri 字段的值）。

   如果发生了替换并且重写继续，则这两个变量的值将相应更新。

   如果在每个服务器上下文中使用（即，在请求映射到文件系统之前），SCRIPT_FILENAME 和 REQUEST_FILENAME 无法包含完整的本地文件系统路径，因为在此处理阶段路径未知。在这种情况下，这两个变量最初将包含 REQUEST_URI 的值。为了在每个服务器上下文中获取请求的完整本地文件系统路径，请使用基于 URL 的前瞻 %{LA-U:REQUEST_FILENAME} 来确定 REQUEST_FILENAME 的最终值。

2. %{ENV:variable}，其中 variable 可以是任何环境变量，也可用。这是通过 Apache httpd 的内部结构查找的（如果在那里找不到），则通过 Apache httpd 服务器进程的 getenv() 查找。
3. %{SSL:variable}，其中variable 是 SSL 环境变量 的名称，无论是否加载 mod_ssl 都可以使用，但如果未加载，则始终扩展为空字符串。例如：%{SSL:SSL_CIPHER_USEKEYSIZE} 可能扩展为 128。即使没有设置 SSLOptions 指令的 StdEnvVars 选项，这些变量也可用。
4. %{HTTP:header}，其中header 可以是任何 HTTP MIME 标头名称，始终可用于获取 HTTP 请求中发送的标头的值。例如：%{HTTP:Proxy-Connection} 是 HTTP 标头 ``Proxy-Connection:'' 的值。

   如果在条件中使用 HTTP 标头，则如果条件对请求求值为真，则此标头将添加到响应的 Vary 标头中。如果条件对请求求值为假，则不会添加它。将 HTTP 标头添加到响应的 Vary 标头中对于正确缓存是必需的。

   必须记住，在 'ornext|OR' 标志的情况下，条件遵循短路逻辑，因此某些条件可能根本不会被评估。

5. %{LA-U:variable} 可用于前瞻，前瞻执行内部（基于 URL 的）子请求以确定variable 的最终值。这可用于访问在当前阶段不可用但在稍后阶段将设置的重写变量。

   例如，要根据服务器上下文（httpd.conf 文件）中的 REMOTE_USER 变量进行重写，必须使用 %{LA-U:REMOTE_USER} - 此变量由授权阶段设置，该阶段在 URL 转换阶段（mod_rewrite 在此阶段运行）之后进行。

   另一方面，由于 mod_rewrite 通过 API 的 Fixup 阶段实现其每个目录上下文（.htaccess 文件），并且授权阶段在此阶段之前进行，因此您只需在该上下文中使用 %{REMOTE_USER} 即可。

6. %{LA-F:variable} 可用于执行内部（基于文件名）子请求，以确定variable 的最终值。大多数情况下，这与上面的 LA-U 相同。

CondPattern 是条件模式，它是一个正则表达式，应用于TestString 的当前实例。TestString 首先被评估，然后与CondPattern 匹配。

CondPattern 通常是与 Perl 兼容的正则表达式，但还有其他语法可用于对Teststring 执行其他有用的测试。

1. 您可以使用 '!' 字符（感叹号）作为模式字符串的前缀来否定条件的结果，无论使用哪种CondPattern。
2. 您可以执行词法字符串比较

   <CondPattern

   词法上优先
   将CondPattern 视为普通字符串，并将其与TestString 进行词法比较。如果TestString 在词法上优先于CondPattern，则为真。

   >CondPattern

   词法上后于
   将CondPattern 视为普通字符串，并将其与TestString 进行词法比较。如果TestString 在词法上后于CondPattern，则为真。

   =CondPattern

   词法上相等
   将CondPattern 视为普通字符串，并将其与TestString 进行词法比较。如果TestString 在词法上等于CondPattern（两个字符串完全相同，字符与字符相同），则为真。如果CondPattern 为 ""（两个引号），则将TestString 与空字符串进行比较。

   <=CondPattern

   词法上小于或等于
   将CondPattern 视为普通字符串，并将其与TestString 进行词法比较。如果TestString 在词法上优先于CondPattern 或等于CondPattern（两个字符串相同，字符与字符相同），则为真。

   >=CondPattern

   词法上大于或等于
   将CondPattern 视为普通字符串，并将其与TestString 进行词法比较。如果TestString 在词法上后于CondPattern 或等于CondPattern（两个字符串相同，字符与字符相同），则为真。

   注意

   字符串比较运算符是CondPattern 参数的一部分，如果使用引号，则必须将其包含在引号中。例如

   RewriteCond %{HTTP_USER_AGENT} "=This Robot/1.0"

3. 您可以执行整数比较

   -eq

   在数值上等于
   TestString 被视为整数，并与CondPattern 进行数值比较。如果两者在数值上相等，则为真。

   -ge

   在数值上大于或等于
   TestString 被视为整数，并与CondPattern 进行数值比较。如果TestString 在数值上大于或等于CondPattern，则为真。

   -gt

   在数值上大于
   TestString 被视为整数，并与CondPattern 进行数值比较。如果TestString 在数值上大于CondPattern，则为真。

   -le

   在数值上小于或等于
   TestString 被视为整数，并与CondPattern 进行数值比较。如果TestString 在数值上小于或等于CondPattern，则为真。为了避免与-l 混淆，请使用-L 或-h 变体。

   -lt

   在数值上小于
   TestString 被视为整数，并与CondPattern 进行数值比较。如果TestString 在数值上小于CondPattern，则为真。为了避免与-l 混淆，请使用-L 或-h 变体。

   -ne

   在数值上不等于
   TestString 被视为整数，并与CondPattern 进行数值比较。如果两者在数值上不同，则为真。这等效于 !-eq。

4. 您可以执行各种文件属性测试

   -d

   是目录。
   将TestString 视为路径名，并测试它是否存在以及是否为目录。

   -f

   是普通文件。
   将TestString 视为路径名，并测试它是否存在以及是否为普通文件。

   -F

   是现有文件，通过子请求。
   检查TestString 是否为有效文件，可通过服务器当前为该路径配置的所有访问控制进行访问。这使用内部子请求来进行检查，因此请谨慎使用 - 它会影响服务器的性能！

   -h

   是符号链接，bash 约定。
   参见-l。

   -l

   是符号链接。
   将TestString 视为路径名，并测试它是否存在以及是否为符号链接。如果存在混淆的可能性，例如使用-lt 或-le 测试时，也可能使用 bash 约定-L 或-h。

   -L

   是符号链接，bash 约定。
   参见-l。

   -s

   是普通文件，具有大小。
   将TestString 视为路径名，并测试它是否存在以及是否为大小大于零的普通文件。

   -U

   是现有 URL，通过子请求。
   检查TestString 是否为有效 URL，可通过服务器当前为该路径配置的所有访问控制进行访问。这使用内部子请求来进行检查，因此请谨慎使用 - 它会影响服务器的性能！

   此标志仅返回有关访问控制、身份验证和授权等方面的信息。此标志不会返回有关配置的处理程序（静态文件、CGI、代理等）将返回的状态代码的信息。

   -x

   具有可执行权限。
   将TestString 视为路径名，并测试它是否存在以及是否具有可执行权限。这些权限根据底层操作系统确定。

   例如

   RewriteCond /var/www/%{REQUEST_URI} !-f
   RewriteRule ^(.+) /other/archive/$1 [R]

5. 如果TestString 具有特殊值 expr，则CondPattern 将被视为 ap_expr。

   在以下示例中，-strmatch 用于将 REFERER 与站点主机名进行比较，以阻止不需要的热链接。

   RewriteCond expr "! %{HTTP_REFERER} -strmatch '*://%{HTTP_HOST}/*'"
   RewriteRule "^/images" "-" [F]

您还可以通过将[flags] 作为 RewriteCond 指令的第三个参数附加到CondPattern 来设置特殊标志，其中flags 是以下任何标志的逗号分隔列表

• 'nocase|NC'（不区分大小写）
  这使测试不区分大小写 - 'A-Z' 和 'a-z' 之间的差异将被忽略，无论是在扩展的TestString 中还是在CondPattern 中。此标志仅对TestString 和CondPattern 之间的比较有效。它对文件系统和子请求检查没有影响。
• 'ornext|OR'（或下一个条件）
  使用此标志将规则条件与本地 OR 结合起来，而不是隐式 AND。典型示例

  RewriteCond "%{REMOTE_HOST}"  "^host1"  [OR]
  RewriteCond "%{REMOTE_HOST}"  "^host2"  [OR]
  RewriteCond "%{REMOTE_HOST}"  "^host3"
  RewriteRule ...some special stuff for any of these hosts...

  如果没有此标志，您将不得不将条件/规则对编写三次。
• 'novary|NV'（不变异）
  如果在条件中使用 HTTP 标头，则此标志将阻止此标头添加到响应的 Vary 标头中。
  如果此响应的表示形式因此标头的值而异，则使用此标志可能会破坏此响应的正确缓存。因此，此标志应仅在充分了解 Vary 标头的含义时使用。

示例

要根据请求的 ``User-Agent:'' 标头重写站点的首页，您可以使用以下内容

RewriteCond  "%{HTTP_USER_AGENT}"  "(iPhone|Blackberry|Android)"
RewriteRule  "^/$"                 "/homepage.mobile.html"  [L]

RewriteRule  "^/$"                 "/homepage.std.html"     [L]

解释：如果您使用识别自己为移动浏览器的浏览器（请注意，此示例不完整，因为还有许多其他移动平台），则将提供首页的移动版本。否则，将提供标准页面。

默认情况下，多个 RewriteCond 按顺序进行评估，并隐式使用逻辑AND。如果条件失败，在没有OR 标志的情况下，整个规则集将被放弃，并且不会评估进一步的条件。

RewriteEngine 指令

RewriteEngine 指令启用或禁用运行时重写引擎。如果将其设置为 off，则此模块根本不会进行任何运行时处理。它甚至不会更新 SCRIPT_URx 环境变量。

使用此指令在特定上下文中禁用规则，而不是注释掉所有 RewriteRule 指令。

请注意，重写配置不会由虚拟主机继承。这意味着您需要为要使用重写规则的每个虚拟主机设置 RewriteEngine on 指令。

如果 RewriteMap 指令的类型为 prg，并且它们定义在没有将 RewriteEngine 设置为 on 的上下文中，则它们不会在服务器初始化期间启动。

RewriteMap 指令

RewriteMap 指令定义一个重写映射，该映射可通过映射函数在重写规则的替换字符串中使用，以通过键查找插入/替换字段。此查找的来源可以是多种类型。

MapName 是映射的名称，将用于通过以下结构之一为重写规则的替换字符串指定映射函数

${ MapName : LookupKey }
${ MapName : LookupKey | DefaultValue }

当出现这样的结构时，会查询映射表MapName并查找键LookupKey。如果找到该键，则用SubstValue替换映射函数结构。如果未找到该键，则用DefaultValue替换，如果没有指定DefaultValue，则用空字符串替换。空值的行为与不存在的键相同，因此无法区分空值键和不存在的键。

例如，您可以定义一个RewriteMap如下

RewriteMap examplemap "txt:/path/to/file/map.txt"

然后，您可以在RewriteRule中使用此映射，如下所示

RewriteRule "^/ex/(.*)" "${examplemap:$1}"

MapTypeOptions参数的含义取决于特定的MapType。有关更多信息，请参阅使用 RewriteMap。

可以使用以下MapType和MapSource组合

txt

一个包含以空格分隔的键值对的纯文本文件，每行一个。(详情 ...)

rnd

从纯文本文件中随机选择一个条目。(详情 ...)

dbm

在包含名称-值对的 dbm 文件中查找条目。使用httxt2dbm实用程序从纯文本文件格式构建哈希。(详情 ...)

int

RewriteMap提供的四个可用内部函数之一：toupper、tolower、escape 或 unescape。(详情 ...)

prg

调用外部程序或脚本来处理重写。(详情 ...)

dbd 或 fastdbd

要执行的 SQL SELECT 语句，用于查找重写目标。(详情 ...)

更多详细信息和大量示例，请参阅RewriteMap 如何使用

RewriteOptions 指令

RewriteOptions指令为当前每个服务器或每个目录配置设置一些特殊选项。Option字符串目前只能是以下之一

Inherit

这将强制当前配置继承父配置。在每个虚拟服务器上下文中，这意味着继承主服务器的映射、条件和规则。在每个目录上下文中，这意味着继承父目录的.htaccess配置或<Directory>部分的条件和规则。继承的规则实际上被复制到使用此指令的部分。如果与本地规则结合使用，则继承的规则将被复制到本地规则后面。此指令的位置（在本地规则下方或上方）不会影响此行为。如果本地规则强制重写停止，则不会处理继承的规则。

从父范围继承的规则在之后应用于子范围内指定的规则。

InheritBefore

与上面的Inherit类似，但父范围的规则在之前应用于子范围内指定的规则。
在 Apache HTTP Server 2.3.10 及更高版本中可用。

InheritDown

如果启用此选项，所有子配置将继承当前配置的配置。它等效于在所有子配置中指定RewriteOptions Inherit。有关如何处理父子关系的更多详细信息，请参阅Inherit选项。
在 Apache HTTP Server 2.4.8 及更高版本中可用。

InheritDownBefore

与上面的InheritDown类似，但当前范围的规则在之前应用于任何子范围中指定的规则。
在 Apache HTTP Server 2.4.8 及更高版本中可用。

IgnoreInherit

此选项强制当前配置和子配置忽略所有从指定InheritDown或InheritDownBefore的父级继承的规则。
在 Apache HTTP Server 2.4.8 及更高版本中可用。

AllowNoSlash

默认情况下，mod_rewrite将忽略映射到磁盘上的目录但缺少尾部斜杠的 URL，以预期mod_dir模块将向客户端发出重定向到带有尾部斜杠的规范 URL。

当DirectorySlash指令设置为关闭时，可以启用AllowNoSlash选项以确保不再忽略重写规则。如果需要，此选项可以使在没有尾部斜杠的情况下匹配目录的 .htaccess 文件中应用重写规则成为可能。
在 Apache HTTP Server 2.4.0 及更高版本中可用。

AllowAnyURI

当在VirtualHost或服务器上下文中使用 httpd 2.2.22 或更高版本中的RewriteRule时，mod_rewrite将仅在请求 URI 是URL-path时处理重写规则。这避免了一些安全问题，其中某些规则可能允许“意外”模式扩展（请参阅CVE-2011-3368和CVE-2011-4317）。要解除对匹配 URL-path 的限制，可以启用AllowAnyURI选项，mod_rewrite将对任何请求 URI 字符串应用规则集，无论该字符串是否匹配 HTTP 规范要求的 URL-path 语法。
在 Apache HTTP Server 2.4.3 及更高版本中可用。

安全警告

如果与未仔细编写的重写规则一起使用，启用此选项将使服务器容易受到安全问题的攻击。强烈建议不要使用此选项。特别是，注意包含“@”字符的输入字符串，这些字符串可能会根据上述 CVE 名称更改转换后的 URI 的解释。

MergeBase

使用此选项，RewriteBase的值将从其显式定义的位置复制到任何未定义其自身RewriteBase的子目录或子位置。这是 2.4.0 到 2.4.3 中的默认行为，并且恢复它的标志在 Apache HTTP Server 2.4.4 及更高版本中可用。

IgnoreContextInfo

在目录（htaccess）上下文中进行相对替换并且未设置RewriteBase时，此模块使用一些扩展的 URL 和文件系统上下文信息将相对替换更改回 URL。mod_userdir和mod_alias等模块提供此扩展的上下文信息。在 2.4.16 及更高版本中可用。

LegacyPrefixDocRoot

在 2.4.26 之前，如果替换是与当前虚拟主机匹配的绝对 URL，则 URL 可能会先缩减为 URL-path，然后缩减为本地路径。由于 URL 可以缩减为本地路径，因此路径应以文档根目录为前缀。这可以防止在对 http://host/file/myfile 发出请求时访问 /tmp/myfile，其中包含以下RewriteRule。

RewriteRule /file/(.*) http://localhost/tmp/$1

此选项允许使用旧行为，其中文档根目录不会作为前缀添加到从 URL 缩减的本地路径。在 2.4.26 及更高版本中可用。

RewriteRule 指令

RewriteRule指令是真正的重写引擎主力。该指令可以出现多次，每个实例定义一个重写规则。定义这些规则的顺序很重要 - 这是它们在运行时应用的顺序。

Pattern是一个与 perl 兼容的正则表达式。根据RewriteRule指令定义的位置，此模式将与什么进行比较会有所不同。

<If "true">
  # Without RewriteOptions Inherit, this rule is overridden by the next
  # section and no redirect will happen for URIs containing 'foo'
  RewriteRule foo http://example.com/foo [R]
</If>
<If "true">
  RewriteRule bar http://example.com/bar [R]
</If>

有关正则表达式的一些提示，请参阅mod_rewrite 简介。

在 mod_rewrite 中，否定字符（'!'）也可以用作可能的模式前缀。这使您可以否定模式；例如，说：“如果当前 URL 不匹配此模式”。这可用于特殊情况，在这些情况下，匹配否定模式更容易，或者用作最后一个默认规则。

重写规则的 替换 是替换由模式匹配的原始 URL 路径的字符串。替换 可以是

文件系统路径

指定要传递给客户端的资源在文件系统上的位置。仅当在服务器（虚拟主机）上下文中配置规则并且替换中路径的第一个组件存在于文件系统中时，替换才被视为文件系统路径

URL 路径

一个 DocumentRoot 相对路径，指向要提供的资源。请注意，mod_rewrite 会尝试通过检查路径的第一段是否在文件系统的根目录中存在来猜测您是否指定了文件系统路径或 URL 路径。例如，如果您指定了一个/www/file.html 的替换字符串，那么它将被视为 URL 路径，除非您的文件系统根目录（或在使用 .htaccess 文件中的重写时，相对于您的文档根目录）存在名为www 的目录，在这种情况下，它将被视为文件系统路径。如果您希望其他 URL 映射指令（如 Alias）应用于生成的 URL 路径，请使用[PT] 标志，如下所述。

绝对 URL

如果指定了绝对 URL，mod_rewrite 会检查主机名是否与当前主机匹配。如果匹配，则会剥离方案和主机名，并将生成的路径视为 URL 路径。否则，将对给定 URL 执行外部重定向。要强制将外部重定向回当前主机，请参阅下面的[R] 标志。

请注意，使用绝对 URI 的重定向（隐式或非隐式）将包括请求的查询字符串，要防止这种情况，请参阅下面的[QSD] 标志。

-（破折号）

破折号表示不应执行任何替换（现有路径将原样传递）。这在需要应用标志（见下文）而无需更改路径时使用。

除了纯文本之外，替换字符串还可以包含

1. 对 RewriteRule 模式的反向引用（$N）
2. 对最后匹配的 RewriteCond 模式的反向引用（%N）
3. 服务器变量，如规则条件测试字符串（%{VARNAME}）
4. 映射函数 调用（${mapname:key|default}）

反向引用是形式为$N（N=0..9）的标识符，它将被匹配的模式的第N个组的内容替换。服务器变量与 RewriteCond 指令的测试字符串相同。映射函数来自 RewriteMap 指令，并在其中解释。这三种类型的变量按上述顺序展开。

重写规则应用于先前重写规则的结果，按照它们在配置文件中定义的顺序。URL 路径或文件系统路径（见上文“匹配了什么？”）将被替换完全替换，重写过程将继续，直到所有规则都已应用，或者被 L 标志 显式终止，或者其他暗示立即终止的标志，例如END 或F。

此外，您可以通过将[标志] 作为 RewriteRule 指令的第三个参数附加来设置要执行的特殊 操作。标志 是一个逗号分隔的列表，用方括号括起来，包含以下表格中的任何标志。有关每个标志的更多详细信息和示例，请参阅 重写标志文档。

以下是所有可能的替换组合及其含义

在每个服务器配置（httpd.conf）中
对于请求“GET /somepath/pathinfo”

在每个目录配置中，用于/somepath
(/physical/path/to/somepath/.htaccess，使用RewriteBase "/somepath")
对于请求“GET /somepath/localpath/pathinfo”