日志

关于我

SeaRiver

强者恒强,弱者恒弱!

文章分类

初级URL重写指南

2009-07-06 14:43:51| 分类： apache | 标签： |举报 |字号大中小订阅

下载LOFTER 我的照片书 |

中国站长站站长书库模块索引指令索引常见问题词汇表站点导航

Apache HTTP Server 版本2.2

站长书库在线文档Apache 2.2 在线文档URL重写

初级URL重写指南

本文是mod_rewrite参考文档的补充材料。阐述在实际应用中如何解决网管所面临的基于URL的典型问题，并详细描述了如何配置URL重写规则集以解决这些问题。

注意：根据你的服务器配置，有可能必须对这里的例子作些小修改，比如，在额外启用mod_alias和mod_userdir的情况下要增加[PT]标志，或者为了适应目录级(.htaccess)的配置而将针对服务器级的规则集进行重写。对一个特定的规则集应该先透彻理解然后再考虑应用，这样才能避免出现问题。

描述：

在有些web服务器上，一个资源会拥有多个URL。在实际应用和发布中应该使用的是规范的URL，其他的则是简写或者只在内部使用。无论用户在请求中使用什么形式的URL，最终看见的都应该是规范的URL。

解决方案：

对所有不规范的URL执行一个外部HTTP重定向，以改变它在浏览器地址栏中的显示及其后继请求。下例中的规则集用规范的/u/user替换/~user，并修正了/u/user所遗漏的后缀斜杠。

RewriteRule   ^/~([^/]+)/?(.*)    /u/$1/$2  [R]  RewriteRule   ^/u/([^/]+)$  /$1/$2/   [R]

描述：

这个规则的目的是强制使用特定的主机名以代替其他名字。比如，你想强制使用www.example.com代替example.com，就可以在以下方案的基础上进行修改：

解决方案：

对运行在非80端口的站点

RewriteCond %{HTTP_HOST}   !^fully\.qualified\.domain\.name [NC]  RewriteCond %{HTTP_HOST}   !^$  RewriteCond %{SERVER_PORT} !^80$  RewriteRule ^/(.*)         http://fully.qualified.domain.name:%{SERVER_PORT}/$1 [L,R]

对运行在80端口的站点

RewriteCond %{HTTP_HOST}   !^fully\.qualified\.domain\.name [NC]  RewriteCond %{HTTP_HOST}   !^$  RewriteRule ^/(.*)         http://fully.qualified.domain.name/$1 [L,R]

DocumentRoot

描述：

通常，web服务器的DocumentRoot直接对应于URL"/"，但是它常常不是处于最高的一级。比如，你希望访问者在进入网站时首先进入/about/目录。可以使用下面给出的规则集。

解决方案：

只需将"/"重定向到"/about/"即可：

RewriteEngine on  RewriteRule   ^/$  /about/  [R]

也可以使用RedirectMatch指令解决问题：

RedirectMatch ^/$ http://example.com/e/www/

描述：

每个网管对引用目录的结尾斜杠问题都有一本苦经，如果遗漏了，服务器会产生一个错误，因为如果请求是"/~quux/foo"而不是"/~quux/foo/"，服务器就会去找一个叫foo的文件，而它是一个目录，所以就报错了。通常，可以使用这个 FAQ entry里面提到的方法解决问题。但是有时候需要使用重写规则来解决问题，比如，在应用了许多复杂的重写规则之后。

解决方案：

解决这个微妙问题的方案是让服务器自动添加后缀斜杠。为了达到目的，必须使用一个外部重定向，以使浏览器能够正确地处理后继的请求(比如对图片的请求)。如果仅仅执行一个内部重写，可能仅仅对目录页面有效，而对含有相对URL的图片的页面无效，因为浏览器有请求内嵌目标的可能。比如，如果不用外部重定向，对`/~quux/foo/index.html`页面中的`image.gif`的请求将变成对`/~quux/image.gif`的请求！所以，应该这样写：
RewriteEngine on RewriteBase /~quux/ RewriteRule ^foo$ foo/ [R]

又懒又疯狂的做法是把这些写入其宿主目录中的顶级`.htaccess`中：

RewriteEngine on RewriteBase /~quux/ RewriteCond %{REQUEST_FILENAME} -d RewriteRule ^(.+[^/])$ $1/ [R]

但是这样一来会增加处理上的开销。

描述：

通常，许多网管在建立一个新的web服务器时，都会有这样的要求：重定向一个web服务器上的所有用户主目录到另一个web服务器。

解决方案：

很简单，在老的web服务器上重定向所有的"/~user/anypath"到"http://newserver/~user/anypath"：

RewriteEngine on  RewriteRule   ^/~(.+)  http://newserver/~$1  [R,L]

描述：

有时会有必要使web服务器在多个目录中搜索页面，对此，MultiViews或者其他技术无能为力。

解决方案：

编制一个明确的规则集以搜索目录中的文件：

RewriteEngine on    # 首先尝试在 dir1 中寻找，找到即停  RewriteCond         /your/docroot/dir1/%{REQUEST_FILENAME}  -f  RewriteRule  ^(.+)  /your/docroot/dir1/$1  [L]    # 然后尝试在 dir2 中寻找，找到即停  RewriteCond         /your/docroot/dir2/%{REQUEST_FILENAME}  -f  RewriteRule  ^(.+)  /your/docroot/dir2/$1  [L]    # 再找不到就继续寻找其他的 Alias 或 ScriptAlias 目录  RewriteRule   ^(.+)  -  [PT]

描述：

希望保持请求之间的状态信息，又不希望使用CGI来包装所有页面，只是通过分离URL中的有用信息来做到。

解决方案：

可以用一个规则集来分离出状态信息，并设置环境变量以备此后用于XSSI或CGI。这样，一个"/foo/S=java/bar/"的URL会被解析为"/foo/bar/"，而环境变量STATUS则被设置为"java"。

RewriteEngine on  RewriteRule   ^(.*)/S=([^/]+)/(.*)    $1/$3 [E=STATUS:$2]

描述：

如果需要为用户username支持一个www.username.host.domain.com的主页，但不在此机器上建虚拟主机，而是仅用在此机器上增加一个DNS A记录的方法实现。

解决方案：

仅能对包含"Host: "头的HTTP/1.1请求实现。可以使用以下规则集内部地将http://www.username.host.com/anypath重写为/home/username/anypath

RewriteEngine on  RewriteCond   %{HTTP_HOST}                 ^www\.[^.]+\.host\.com$  RewriteRule   ^(.+)                        %{HTTP_HOST}$1          [C]  RewriteRule   ^www\.([^.]+)\.host\.com(.*) /home/$1$2

描述：

对不是来自本地域ourdomain.com的外来访问者的请求，重定向其用户主目录URL到另一个web服务器www.somewhere.com，有时这种做法也会用在虚拟主机的配置段中。

解决方案：

只须一个重写条件：

RewriteEngine on  RewriteCond   %{REMOTE_HOST}  !^.+\.ourdomain\.com$  RewriteRule   ^(/~.+)         http://www.somewhere.com/$1 [R,L]

描述：

默认情况下，重定向到一个HTML锚是不可行的，因为'`#`'会被转义为'`%23`'。This, in turn, breaks the redirection.

解决方案：

在`RewriteRule`指令中使用`[NE]`标志(不转义)。

依赖于时间的重写

描述：

在页面内容需要按时间的不同而变化的场合，比如重定向特定页面等，许多网管仍然采用CGI脚本的方法，如何用mod_rewrite来实现呢？

解决方案：

有许多名为TIME_xxx的变量可以用在重写条件中，联合使用词典模式的"<STRING", "=STRING", ">STRING"比较，就可以实现依赖于时间的重写：

RewriteEngine on  RewriteCond   %{TIME_HOUR}%{TIME_MIN} >0700  RewriteCond   %{TIME_HOUR}%{TIME_MIN} <1900  RewriteRule   ^foo\.html$             foo.day.html  RewriteRule   ^foo\.html$             foo.night.html

此例使foo.html在07:00-19:00时间内指向foo.day.html，而在其余时间指向foo.night.html，对主页是一个不错的功能...

对YYYY转变为XXXX的向前兼容

描述：

在转变了大批document.YYYY文件为document.XXXX后(比如.html→.phtml)，如何保持URL的向前兼容(仍然虚拟地存在)？

解决方案：

只须按基准文件名重写，并测试带有新的扩展名的文件是否存在，如果存在则用新的，否则仍然用原来的。

# 将document.html重写为document.phtml的向后兼容的规则集  # 当且仅当document.phtml存在且document.html不存在的时候  RewriteEngine on  RewriteBase   /~quux/  # 剪切并记住basename  RewriteRule   ^(.*)\.html$              $1      [C,E=WasHTML:yes]  # 如果存在的话就重写为document.phtml  RewriteCond   %{REQUEST_FILENAME}.phtml -f  RewriteRule   ^(.*)$ $1.phtml                   [S=1]  # 否则返回先前的basename  RewriteCond   %{ENV:WasHTML}            ^yes$  RewriteRule   ^(.*)$ $1.html

从旧到新(内部)

描述：

假定已经把文件foo.html改名为bar.html，需要对老的URL向后兼容，即让用户仍然可以使用老的URL，而感觉不到文件被改名了。

解决方案：

通过以下规则内部地将老的URL重写为新的：

RewriteEngine  on  RewriteBase    /~quux/  RewriteRule    ^foo\.html$  bar.html

从旧到新(外部)

描述：

仍然假定已经把文件foo.html改名为bar.html，需要对老的URL向后兼容，但是要让用户得到文件被改名的暗示，即浏览器的地址栏中显示的是新的URL。

解决方案：

作一个HTTP的强制重定向以改变浏览器和用户界面上的显示：

RewriteEngine  on  RewriteBase    /~quux/  RewriteRule    ^foo\.html$  bar.html  [R]

从静态到动态

描述：

如何无缝转换静态页面foo.html为动态的foo.cgi，而不为浏览器/用户所察觉。

解决方案：

只须重写此URL为CGI-script，并强制作为CGI-script运行的MIME类型。比如对/~quux/foo.html的请求会执行/~quux/foo.cgi

RewriteEngine  on  RewriteBase    /~quux/  RewriteRule    ^foo\.html$  foo.cgi  [T=application/x-httpd-cgi]

阻止Robot

描述：

如何阻止一个完全匿名的Robot取得特定网络区域的页面？/robots.txt文件可以包含若干"Robot排除协议"行，但不足以阻止此类Robot。

解决方案：

可以用一个规则集以拒绝对网络区域/~quux/foo/arc/(对一个很深的目录区域进行列表可能会使服务器产生很大的负载)的访问。还必须确保仅阻止特定的Robot，也就是说，仅仅阻止Robot访问主机是不够的(这样会同时阻止用户访问该主机)。为此，就需要对HTTP头的User-Agent信息作匹配。

RewriteCond %{HTTP_USER_AGENT}   ^NameOfBadRobot.*  RewriteCond %{REMOTE_ADDR}       ^123\.45\.67\.[8-9]$  RewriteRule ^/~quux/foo/arc/.+   -   [F]

阻止内嵌的图片

描述：

假设http://www.quux-corp.de/~quux/有一些内嵌GIF图片的页面，这些图片很好，所以就有人盗链到他们自己的页面中了。由于这样徒然增加了我们服务器的流量，因此，我们不愿意这种事情发生。

解决方案：

虽然，我们不能100%地保护这些图片不被写入别人的页面，但至少可以对发出HTTP Referer头的浏览器加以限制。

RewriteCond %{HTTP_REFERER} !^$  RewriteCond %{HTTP_REFERER} !^http://www.quux-corp.de/~quux/.*$ [NC]  RewriteRule .*\.gif$        -                                    [F]

RewriteCond %{HTTP_REFERER}         !^$  RewriteCond %{HTTP_REFERER}         !.*/foo-with-gif\.html$  RewriteRule ^inlined-in-foo\.gif$   -                        [F]

拒绝代理

描述：: 如何拒绝某个主机或者来自特定主机的用户使用Apache代理？
解决方案：

外部重写引擎

描述：

如何解决似乎无法用`mod_rewrite`解决的FOO/BAR/QUUX/之类的问题？

解决方案：

可以使用一个与`RewriteMap`功能相同的外部`RewriteMap`程序，一旦它在Apache启动时被执行，则从`STDIN`接收被请求的URL ，并将处理过(通常是重写过的)的URL(以相同顺序)在`STDOUT`输出。
RewriteEngine on RewriteMap quux-map prg:/path/to/map.quux.pl RewriteRule ^/~quux/(.*)$ /~quux/${quux-map:$1}

#!/path/to/perl # 禁止使用会导致Apache陷入死循环的I/O缓冲 $| = 1; # 从stdin读取URL(每行一个)，并在stdout输出替换URL while (<>) { s|^foo/|bar/|; print $_; }
这是只是一个简单的示例，只是把所有的`/~quux/foo/...`重写为`/~quux/bar/...`而已。但事实上，可以把它修改成任何你想要的输出。但是要注意，虽然一般用户都可以使用，可是只有系统管理员才可以定义这样的映射。

本文允许自由使用、分发、转载，但必须保留译者署名；详见：译者声明。

中国站长站站长书库模块索引指令索引常见问题词汇表站点导航

原地址: http://book.chinaz.com/docs/apache/2_2/rewrite/rewrite_guide.html

评论这张

转发至微博

阅读(660)| 评论(0)

历史上的今天

this.p={  m:2,
              b:2,
              loftPermalink:'',
              id:'fks_082071082085082075092083095095085095089067084084087068',
              blogTitle:'初级URL重写指南',
              blogAbstract:'<SPAN style=\"WORD-SPACING: 0px; FONT: 14px \'Times New Roman\'; TEXT-TRANSFORM: none; COLOR: rgb(0,0,0); TEXT-INDENT: 0px; WHITE-SPACE: normal; LETTER-SPACING: normal; BORDER-COLLAPSE: separate; orphans: 2; widows: 2; webkit-border-horizontal-spacing: 0px; webkit-border-vertical-spacing: 0px; webkit-text-decorations-in-effect: none; webkit-text-size-adjust: auto; webkit-text-stroke-width: 0;\"  \>  <DIV style=\"PADDING-RIGHT: 1em; PADDING-LEFT: 0px; FONT-WEIGHT: normal; PADDING-BOTTOM: 0px; MARGIN: 0px; COLOR: rgb(0,51,102); PADDING-TOP: 0px; FONT-FAMILY: Arial, Helvetica, sans-serif; BACKGROUND-COLOR: rgb(255,255,255);\"  \>  <DIV style=\"MARGIN-LEFT: 30px;\"  \>  <P\></P\></DIV\></DIV\></SPAN\>',
              blogTag:'',
              blogUrl:'blog/static/1980021720096624351469',
              isPublished:1,
              istop:false,
              type:0,
              modifyTime:1317419984183,
              publishTime:1246862631469,
              permalink:'blog/static/1980021720096624351469',
              commentCount:0,
              mainCommentCount:0,
              recommendCount:0,
              bsrk:-100,
              publisherId:0,
              recomBlogHome:false,
              currentRecomBlog:false,
              attachmentsFileIds:[],
              vote:{},
              groupInfo:{},
              friendstatus:'none',
              followstatus:'unFollow',
              pubSucc:'',
              visitorProvince:'',
              visitorCity:'',
              visitorNewUser:false,
              postAddInfo:{},
              mset:'000',
              mcon:'',
              srk:-100,
              remindgoodnightblog:false,
              isBlackVisitor:false,
              isShowYodaoAd:false,
              hostIntro:'强者恒强,弱者恒弱!',
              hmcon:'1',
              selfRecomBlogCount:'0',
              lofter_single:'<iframe width="140" height="560" style="overflow:hidden;" src="http://www.lofter.com/mailEntry.do?blogad=1&blog" frameBorder="0"></iframe>'
            }

{list a as x}
    {if !!x}
    <div class="iblock nbw-fce nbw-f40">
      <a class="fc03 noul" target="_blank" hidefocus="true" href="http://blog.163.com/${x.visitorName}/">
      {if x.visitorName==visitor.userName}
      <img alt="${x.visitorNickname|escape}" onerror="this.src=location.f40" class="cwd bdwa bdc0" src="${fn1(x.visitorName)}&r=${visitor.imageUpdateTime}"/>
      {else}
      <img alt="${x.visitorNickname|escape}" onerror="this.src=location.f40" class="cwd bdwa bdc0" src="${fn1(x.visitorName)}"/>
      {/if}
      </a>
      <div class="cwd vname thide">
        {if x.moveFrom=='wap'}
          <a class="noul pnt" target="_blank" href="http://blog.163.com/services/wapblog.html?frompersonalbloghome"><span title="来自网易手机博客" class="iblock wapIcon"> </span></a>
        {elseif x.moveFrom=='iphone'}
          <a class="noul pnt" target="_blank"><span title="来自iPhone客户端" class="iblock iphoneIcon"> </span></a>
        {elseif x.moveFrom=='android'}
          <a class="noul pnt" target="_blank"><span title="来自Android客户端" class="iblock androidIcon"> </span></a>
        {elseif x.moveFrom=='mobile'}
          <a class="noul pnt" target="_blank" href="http://blog.163.com/services/emsblog.html?frompersonalbloghome"><span title="来自网易短信写博" class="iblock wapIcon"> </span></a>
        {/if}
        <a class="fc03 m2a"  target="_blank" hidefocus="true" href="http://blog.163.com/${x.visitorName}/">
          ${fn(x.visitorNickname,8)|escape}
        </a>
      </div>
    </div>
    {/if}
    {/list}

<#--最新日志，群博日志--> <#--推荐日志-->

<p class="fc06">推荐过这篇日志的人：</p>
    <div>
      {list a as x}
      {if !!x}
      <div class="iblock nbw-fce nbw-f40">
        <a class="fc03 noul" target="_blank" hidefocus="true" href="http://blog.163.com/${x.recommenderName}/">
        <img alt="${x.recommenderNickname|escape}" onerror="this.src=location.f40" class="cwd bdwa bdc0" src="${fn1(x.recommenderName)}"/>
        </a>
        <div class="cwd thide">
          <a class="fc03 m2a" target="_blank" hidefocus="true" href="http://blog.163.com/${x.recommenderName}/">
            ${fn(x.recommenderNickname,6)|escape}
          </a>
        </div>
      </div>
      {/if}
      {/list}
    </div>
    {if !!b&&b.length>0}
    <p  class="fc06">他们还推荐了：</p>
    <ul>
    {list b as y}
      {if !!y}
        <li class="rrb"><span class="iblock">·</span><a class="fc03 m2a" target="_blank" href="http://blog.163.com/${y.recommendBlogPermalink}/?from=blog/static/1980021720096624351469">${y.recommendBlogTitle|escape}</a></li>
      {/if}
    {/list}
    </ul>
    {/if}

<#--引用记录--> <#--博主推荐--> <#--随机阅读--> <#--首页推荐--> <#--历史上的今天--> <#--被推荐日志--> <#--上一篇，下一篇--> <#-- 热度 -->

{list a as x}
    {if !!x}
    <div class="hotItem iblock nbw-fce nbw-f40">
      <a class="fc03 noul" target="_blank" hidefocus="true" href="http://blog.163.com/${x.publisherUsername}/">
      {if x.publisherUsername==visitor.userName}
      <img alt="${x.publisherNickname|escape}" onerror="this.src=location.f40" class="cwd bdwa bdc0" src="${fn1(x.publisherUsername)}&r=${visitor.imageUpdateTime}"/>
      {else}
      <img alt="${x.publisherNickname|escape}" onerror="this.src=location.f40" class="cwd bdwa bdc0" src="${fn1(x.publisherUsername)}"/>
      {/if}
      </a>
      <div class="cwd vname thide">
        <a class="fc03 m2a"  target="_blank" hidefocus="true" href="http://blog.163.com/${x.publisherUsername}/">
          ${fn(x.publisherNickname,8)|escape}
        </a>
      </div>
      <a class="f-myLikeIcons hottype {if x.type==1} js-liketype{elseif x.type==2} js-reblogtype{elseif x.type==3} js-sharetype{else}{/if}" target="_blank" hidefocus="true" href="http://blog.163.com/${x.publisherUsername}/"> </a>
    </div>
    {/if}
    {/list}

<#-- 网易新闻广告 --> <#--右边模块结构--> <#--评论模块结构--> <#--引用模块结构--> <#--博主发起的投票-->

页脚

我的照片书 - 手机博客 - 下载LOFTER APP - 订阅此博客

SeaRiver Blog

导航

日志

初级URL重写指南

初级URL重写指南

DocumentRoot

描述：

默认情况下，重定向到一个HTML锚是不可行的，因为'`#`'会被转义为'`%23`'。This, in turn, breaks the redirection.

解决方案：

在`RewriteRule`指令中使用`[NE]`标志(不转义)。

依赖于时间的重写

对YYYY转变为XXXX的向前兼容

从旧到新(内部)

从旧到新(外部)

从静态到动态

阻止Robot

阻止内嵌的图片

拒绝代理

外部重写引擎

历史上的今天

最近读者

热度

评论

页脚

SeaRiver Blog

导航

日志

初级URL重写指南

初级URL重写指南

描述：

依赖于时间的重写

对YYYY转变为XXXX的向前兼容

从旧到新(内部)

从旧到新(外部)

从静态到动态

阻止Robot

阻止内嵌的图片

拒绝代理

外部重写引擎 描述：

外部重写引擎

历史上的今天

最近读者

热度

评论

页脚