Mod_rewrite 语法快速入门指南 - 文章教程

Mod_rewrite 语法快速入门指南

发布于 2019-04-12 字数 7455 浏览 1220 评论 0

一条 RewriteRule 指令,定义一条重写规则,规则间的顺序非常重要。对 Apache1.2 及以后的版本,模板 pattern 是一个 POSIX 正则式,用以匹配当前的URL。当前的 URL 不一定是用户最初提交的 URL,因为可能用一些规则在此规则前已经对 URL 进行了处理。

mod_rewrite 来说,! 是个合法的模板前缀,表示非的意思,这对描述不满足某种匹配条件的情况非常方便,或用作最后一条默认规则。当使用 ! 时,不能在模板中有分组的通配符,也不能做后向引用。

当匹配成功后,Substitution 会被用来替换相应的匹配,它除了可以是普通的字符串以外,还可以包括:

  1. $N,引用RewriteRule模板中匹配的相关字串,N表示序号,N=0..9
  2. %N,引用最后一个RewriteCond模板中匹配的数据,N表示序号
  3. %{VARNAME},服务器变量
  4. ${mapname:key|default},映射函数调用

这些特殊内容的扩展,按上述顺序进行。

一个URL的全部相关部分都会被Substitution替换,而且这个替换过程会一直持续到所有的规则都被执行完,除非明确地用L标志中断处理过程。

susbstitution有”-”前缀时,表示不进行替换,只做匹配检查。

利用RewriteRule,可定义含有请求串(Query String)的URL,此时只需在Sustitution中加入一个?,表示此后的内容放入QUERY_STRING变量中。如果要清空一个 QUERY_STRING 变量,只需要以?结束Substitution串即可。

如果给一个Substitution增加一个http://thishost[:port]的前缀,则mod_rewrite会自动将此前缀去掉。因此,利用http://thisthost做一个无条件的重定向到自己,将难以奏效。要实现这种效果,必须使用R标志。

Flags是可选参数,当有多个标志同时出现时,彼此间以逗号分隔。

1. ‘redirect|R [=code]’ (强制重定向)

给当前的URI增加前缀http://thishost[:thisport]/, 从而生成一个新的URL,强制生成一个外部重定向(external redirection,指生的URL发送到客户端,由客户端再次以新的URL发出请求,虽然新URL仍指向当前的服务器)。

如果没有指定的code值,则HTTP应答以状态值302 (MOVED TEMPORARILY),如果想使用300-400(不含400)间的其它值可以通过在code的位置以相应的数字指定,也可以用标志名指定: temp (默认值)、permanentseeother

注意,当使用这个标志时,要确实substitution是个合法的URL,这个标志只是在URL前增加http://thishost[:thisport]/前缀而已,重写操作会继续进行。如果要立即将新URL重定向,用L标志来中重写流程。

2. ‘forbidden|F’ (强制禁止访问URL所指的资源)

立即返回状态值403 (FORBIDDEN)的应答包。将这个标志与合适的 RewriteConds 联合使用,可以阻断访问某些URL。

3. ‘gone|G’ (强制返回URL所指资源为不存在(gone))

立即返回状态值 410 (GONE)的应答包。用这个标志来标记URL所指的资源永久消失了.

4. # ‘proxy|P’ (强制将当前URL送往代理模块(proxy module))

这个标志,强制将substitution当作一个发向代理模块的请求,并立即将共送往代理模块。因此,必须确保substitution串是一个合法的URI (如, 典型的情况是以http://hostname开头),否则会从代理模块得到一个错误. 这个标志,是ProxyPass指令的一个更强劲的实现,将远程请求(remote stuff)映射到本地服务器的名字空间(namespace)中来。

注意,使用这个功能必须确保代理模块已经编译到 Apache 服务器程序中了. 可以用“ httpd -l ”命令,来检查输出中是否含有mod_proxy.c来确认一下。如果没有,而又需要使用这个功能,则需要重新编译httpd程序并使用 mod_proxy有效。

5. ‘last|L’ (最后一条规则)

中止重写流程,不再对当前URL施加更多的重写规则。这相当于perl的last命令或C的break命令。

6. ‘next|N’ (下一轮)

重新从第一条重写规则开始执行重写过程,新开的过程中的URL不应当与最初的URL相同。 这相当于Perl的next命令或C的continue命令. 千万小心不要产生死循环。

7. # ‘chain|C’ (将当前的规则与其后续规则綑绑(chained))

当规则匹配时,处理过程与没有綑绑一样;如果规则不匹配,则綑绑在一起的后续规则也不在检查和执行。

8. ‘type|T=MIME-type’ (强制MIME类型)

强制将目标文件的MIME-type为某MIME类型。例如,这可用来模仿mod_alias模块对某目录的ScriptAlias指定,通过强制将该目录下的所有文件的类型改为 “application/x-httpd-cgi”.

9. ‘nosubreq|NS’ (used only if no internal sub-request )

这个标志强制重写引擎跳过为内部sub-request的重写规则.例如,当mod_include试图找到某一目录下的默认文件时 (index.xxx),sub-requests 会在Apache内部发生. Sub-requests并非总是有用的,在某些情况下如果整个规则集施加到它上面,会产生错误。利用这个标志可排除执行一些规则。

10. ‘nocase|NC’ (模板不区分大小写)

这个标志会使得模板匹配当前URL时忽略大小写的差别。

11. ‘qsappend|QSA’ (追加请求串(query string))

这个标志,强制重写引擎为Substitution的请求串追加一部分串,则不是替换掉原来的。借助这个标志,可以使用一个重写规则给请求串增加更多的数据。

12. ‘noescape|NE’ (不对输出结果中的特殊字符进行转义处理)

通常情况下,mod_write的输出结果中,特殊字符(如’%‘, ‘$‘, ‘;‘, 等)会转义为它们的16进制形式(如分别为’%25‘, ‘%24‘, and ‘%3B‘)。这个标志会禁止mod_rewrite对输出结果进行此类操作。 这个标志只能在 Apache 1.3.20及以后的版本中使用。

13. ‘passthrough|PT’ (通过下一个处理器)

这个标志强制重写引擎用 filename 字段的值来替换内部request_rec数据结构中uri字段的值。使用这个标志,可以使后续的其它URI-to-filename转换器的AliasScriptAliasRedirect等指令,也能正常处理 RewriteRule指令的输出结果。用一个小例子来说明它的语义:如果要用mod_rewrite的重写引擎将/abc转换为/def,然后用 mod_alas将/def重写为ghi,则要:

RewriteRule ^/abc(.*) /def$1 [PT]
Alias /def /ghi

如果PT标志被忽略,则mod_rewrite也能很好完成工作,如果., 将 uri=/abc/... 转换为filename=/def/... ,完全符合一个URI-to-filename转换器的动作。接下来 mod_alias 试图做 URI -to-filename 转换时就会出问题。

注意:如果要混合都含有URL-to-filename转换器的不同的模块的指令,必须用这个标志。最典型的例子是mod_alias和mod_rewrite的使用。

14. ‘skip|S=num’ (跳过后面的num个规则)

当前规则匹配时,强制重写引擎跳过后续的num个规则。用这个可以来模仿if-then-else结构:then子句的最后一条rule的标志是skip=N,而Nelse子句的规则条数。

15. ‘env|E=VAR:VAL’ (设置环境变量)

设置名为VAR的环境变量的值为VAL,其中VAL中可以含有正则式的后向引用($N%N)。这个标志可以使用多次,以设置多个环境变量。这儿设置的 变量,可以在多种情况下被引用,如在XSSICGI中。另外,也可以在RewriteCond模板中以%{ENV:VAR}的形式被引用。

16.最后一点

注意:一定不要忘记,在服务器范围内的配置文件中,模板(pattern)用以匹配整个URL;而在目录范围内的配置文件中,目录前缀总是被自动去 掉后再进行模板匹配的,且在替换完成后自动再加上这个前缀。

这个功能对很多种类的重写是非常重要的,因为如果没有去前缀,则要进行父目录的匹配,而父目录 的信息并不是总能得到的。一个例外是,当substitution中有http://打头时,则不再自动增加前缀了,如果P标志出现,则会强制转向代理。

注意:如果要在某个目录范围内启动重写引擎,则需要在相应的目录配置文件中设置“RewriteEngine on”,且目录的“Options FollowSymLinks”必须设置。如果管理员由于安全原因没有打开FollowSymLinks,则不能使用重写引擎。

如果你对这篇文章有疑问,欢迎到本站 社区 发帖提问或使用手Q扫描下方二维码加群参与讨论,获取更多帮助。

扫码加入群聊

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!

关于作者

JSmiles

生命进入颠沛而奔忙的本质状态,并将以不断告别和相遇的陈旧方式继续下去。

2583 文章
29 评论
84935 人气
更多

推荐作者

清欢

文章 1 评论 0

贱贱哒

文章 3 评论 0

悸初

文章 2 评论 0

西瓜杏

文章 0 评论 0

各自安好

文章 0 评论 0