Lighttpd Module : Rewrites 使用详解

kok

GOOGLE 了半天找到的几篇值得收藏的文章。。不知道有没有用LIGHTTPD 的  这个应该很有用。。。
说明： 本文章来源于Lighttpd 官方网站，这里只做翻译和解释说明，并保留原文。
原文地址： http://redmine.lighttpd.net/wiki/1/Docs:ModRewrite
h1. URL Rewrites
*Module: mod_rewrite*
h2. Description
     ［描述］
internal redirects, url rewrite
内部从定向，URL重写

h2. Options
        ［选项］
h3. url.rewrite-once

Rewrites a set of URLs internally in the webserver BEFORE they are handled.［在URL设置被处理之前，在webserver服务器内部重写这个URL，只匹配一次］

e.g.

<pre>
url.rewrite-once = ( "<regex>" => "<relative-uri>" )
（说明：在上面的语句中， <regex> 代表正则表达式部分， <relative-uri>代表被替换或处理的文本部分，也就是说，凡是URL设置中，符合<regex>部分正则表达式部分的字符串会被后面的<relative-uri>替换， 这个有点向javascript 字符串处理，其中url.rewrite-once，表示URL字符对象本身。）
</pre>

h3. url.rewrite-repeat

Rewrites a set of URLs internally in the webserver BEFORE they are handled
［解释如上， 本语句进行多次重复处理，也就是多次寻找负责正则表达式设置规则的字符串，并进行替换。］
e.g.

<pre>
url.rewrite-repeat = ( "<regex>" => "<relative-uri>" )
（解释如上）
</pre>

The difference between these options is that, while url.rewrite-repeat allows for applying multiple (seperately defined) rewrite rules in a row, url.rewrite-once will cause further rewrite rules to be skipped if the expression was matched. As such, url.rewrite-once behaves like Apaches' RewriteRule ... [L]: http://httpd.apache.org/docs/2.2/mod/mod_rewrite.html#rewriterule
［以上两个选项的区别在于url.rewrite-repeat 允许在一行中进行多次URL重写，而url.rewrite-once 只能重写一次，其它匹配重写规则会跳过，只有第一次生效。例如：url.rewrite-once行为类似Apaches 的 RewriteRule，呵呵,这里言下之意，就是url.rewrite-repeat是lighttpd的独特之处了。］

The options @url.rewrite@ and @url.rewrite-final@ were mapped to @url.rewrite-once@ in 1.3.16.
［url.rewrite和url.rewrite-final 在1.3.16的url.rewrite-once中说明。］

*{color:red}NOTE: url rewriting does not work within a $HTTP["url"] conditional.* [http://forum.lighttpd.net/topic/1092#3028]
［ 注释： url rewriting 在$HTTP['url']情况下无效。 ］


h2. Regular Expressions
    ［正则表达式］

* Patterns ("wildcards") are matched against a string
  模式("通配符")被用来陪陪一个字符串
* Special characters (see [http://www.regular-expressions.info/reference.html] for reference):
  特殊字符请参考： http://www.regular-expressions.info/reference.html  ， （这个网站似乎是正则表达式官方网站，看来lighttpd正则表达式很规范。）
** . (full stop) - match any character 匹配任何字符
** \* (asterisk) - match zero or more of the previous symbol匹配零或多个符号
** \+ (plus) - match one or more of the previous symbol匹配一个或多个前面的符号
** ? (question) - match zero or one of the previous symbol匹配零个或一个前面的符号
** \\? (backslash-something) - match special characters匹配一个特殊字符
** ^ (caret) - match the start of a string匹配一个字符串开始
** $ (dollar) - match the end of a string匹配一个字符串结束
** [set] - match any one of the symbols inside the square braces.匹配方括号内的任意一个字符
** [^set] - match any symbol that is NOT inside the square braces.匹配任何一个不再这个括号内的字符
** (pattern) - grouping, remember what the pattern matched as a special variable 子查询
** {n,m} - from n to m times matching the previous character (m could be omitted to mean >=n times) 匹配n到m次。
** (?!expression) - match anything BUT expression at the current position. Example: @"^(/(?!(favicon.ico$|js/|images/)).*)" => "/fgci/$1"@
      匹配当前位置的任何一个符号

* Normal alphanumeric characters are treated as normal
  正常的字母和数字还保持原样

h3. Replacement Patterns 替换模式

If the matched regex contains groups in parentheses, $1..$9 in the replacement refer to the captured text in the
matching group "$1" meaning the first group, "$2" the second, and so on.
如果匹配的正则中包括子集，那么$1--$9所在的位置会被替换成扑获到的文本，在匹配的子集中$1表似乎第一个子集，$2表示第二个子集，以此类推。

Note that % replacements (like %1, %2, %0, etc.) in url.rewrite-* targets are permitted, but do *not* have the meaning they would have in evhost.path-pattern.  If url.rewrite-* is specified within a regex conditional, % patterns are replaced by the corresponding groups from the condition regex.  %1 is replaced with the first subexpression, %2 with the second, etc.  %0 is replaced by the entire substring matching the regexp.  See below for an example using "%0".
注释： %替换符，(例如％1，％2,%0等等) 在url.rewrite-*选项中是许可的，但是这并不意味着可以在evhost.path-pattern模式中许可。如果url.rewrite-*是通过正则表达式指定的，%模式被相应的正则自己所替换。%1被第一个子集替换，%2被第二个子集替换，依次类推。%0被整个的字符串替换，下面是一个用%0的例子。

h2. Examples例子

The regex is matching the full REQUEST_URI which is supplied by the user including
query-string.
正则表达式匹配全部用户提交的REQUEST_URI，包括查询字符串(query-string:a=123&b=234).

<pre>
# the following example, is, however just simulating vhost by rewrite
# * you can never change document-root by mod_rewrite
# use mod_*host instead to make real mass-vhost
下面的例子描述了怎样可以通过重写来模拟虚拟域名，这样你不再需要通过mod_rewrite模块修改document-root参数参数，通过mod_*host来代替产生一个真实的虚拟主机集群。

server.document-root = "/www/htdocs/"
$HTTP["host"] =~ "^.*\.([^.]+\.com)$" {
  url.rewrite-once = ( "^/(.*)" => "/%0/$1" )
}

# request:        http://any.domain.com/url/
# before rewrite: REQUEST_URI="/www/htdocs/url/"
# and DOCUMENT_ROOT="/www/htdocs/" %0="any.domain.com" $1="url/"
# after rewrite:  REQUEST_URI="/www/htdocs/any.domain.com/url/"
# still, you have DOCUMENT_ROOT=/www/htdocs/
注释：通过上面的实例可以看出，重写模块url.rewrite－＊ 是在url被服务器执行之前所调用的，因此我猜测lighttpd 的WEB服务器是有事件管理的，通过事件管理来增强服务器性能。
     url.rewrite-*的事件顺序是，REQUEST_URL被扑获后，和被正式处理前的这一段时间执行。可以通过url.rewrite-once('.*'=>"/%0");获取完成的URL字符串，输出%0就可以了。
         个人猜想url这个模块应该有办法可以直接输出url字符，进行一些常规的字符串判断或处理。

# please note, that we have two regular expressions: the one which
# $HTTP["host"] is been compared with, and the one of the rewrite rule.
# the numbered subexpressions available to build the relative uri are
# being prefixed by '%' for subexpressions of the first regular expression
# match and by '$' for subexpressions of the second one.
# subexpression 0 interpolates the whole matching string: %0 for the whole
# string matching the conditional, and $0 for the whole string matching the
# rewrite rule.
请注意，我们有两个正则表达式，$HTTP['host']被匹配的是第一个。能够用来建立相关URI的数字化表达式由‘％’作为前缀，这个数字化的表达式是作为第一个正则表达式的子表达式。第二个是用‘$’作为前缀。   第一个正则表达式，由‘％’作为前缀，数字化的表示方式，例如(%1,%2 ...)能够用来建立相关的URI，表达式0（％0或$0）包含了整个匹配的字符串。


# if the rewrite rule is not included in a conditional
# block, only the '$' prefixed variables are available.
如果rewrite rule（重写规则）没有被包含在一个条件代码块内，只有'$'作为前缀的变量是有效的。所谓代码块，指被大括号‘｛’和‘｝’包围着的一段代码，这里看起来有点局部变量的意思。
也就是在局部范围内%是有效的变量前缀，在全局范围内$是有效的变量前缀。
（附加注释：在lighttpd的evhost模块中有说明，$1-$5是REQUEST_URL的指定变量，分别表示一个REQUEST_URL的不同部分，即使$HTTP['host']=~"正则表达式"｛｝，$1-$5的内并并没有被改变
   ，在上面的实例中可以看到$1代表的是"url/"部分，因此$1-$5和全局变量是有区别的，而下面的正则表达式通过$1、$2....这样的形式来提取正则表达式子集匹配，那么这个是否会和全局$1-$5的定义冲突？）


汗 限制一万字... 下一半在一楼

cpuer

lighttpd不行。

lemss

还是使用nginx吧

fanslive

一般默认的阿帕奇规则扔到里面都可以用，我上次试的

cpuer

我去学习下了

诡谲

在nginx很简单哦...
在lighttpd下也很简单.只要用我那个方法...

cpuer

shopex程序在Apache下的伪静态都够复杂的。

诡谲

恩.看过了.也用过了....
这个规则还是比较简单的.如果有一些是要进行目录判断的.比如shopex程序.你用这个简单的rewrite就不行咯...

你得用lighttpd-mod-magnet这个模块.可以进行比较高阶的规则匹配.这个是我配置的shopex的伪静态规则.你有空可以参考一下
http://www.xmlchina.org/original ... ttpd-pseudo-static/

cpuer

看了一部分我就开始头晕了。

lemss

即使知道办法一般也懒得写的