乐趣区

Nginx-rewrite配置规则

rewrite 语法

server {rewrite {规则} {定向路径} {重写类型} ;
}

1、规则:可以是字符串或者正则来表示想匹配的目标 url
2、定向路径:表示匹配到规则后要定向的路径,如果规则里有正则,则可以使用 $index 来表示正则里的捕获分组
3、重写类型:

  • last:相当于 Apache 里德 (L) 标记,表示完成 rewrite,浏览器地址栏 URL 地址不变
  • break;本条规则匹配完成后,终止匹配,不再匹配后面的规则,浏览器地址栏 URL 地址不变
  • redirect:返回 302 临时重定向,浏览器地址会显示跳转后的 URL 地址
  • permanent:返回 301 永久重定向,浏览器地址栏会显示跳转后的 URL 地址

举例说明

server {
    rewrite /last.html /index.html last;
    # 访问 /last.html 的时候,页面内容重写到 /index.html 中

    rewrite /break.html /index.html break;
    # 访问 /break.html 的时候,页面内容重写到 /index.html 中,并停止后续的匹配

    rewrite /redirect.html /index.html redirect;
    # 访问 /redirect.html 的时候,页面直接 302 定向到 /index.html 中

    rewrite /permanent.html /index.html permanent;
    # 访问 /permanent.html 的时候,页面直接 301 定向到 /index.html 中

    rewrite ^/html/(.+?).html$ /post/$1.html permanent;
    # 把 /html/*.html => /post/*.html,301 定向

    rewrite ^/search\/([^\/]+?)(\/|$) /search.html?keyword=$1 permanent;
    # 把 /search/key => /search.html?keyword=key
}

last 和 break 的区别:

  1. 因为 301 和 302 不能简单的只返回状态码,还必须有重定向的 URL,这就是 return 指令无法返回 301,302 的原因了(return 只能返回除 301、302 之外的 code)。
  2. last 一般写在 server 和 if 中,而 break 一般使用在 location 中
  3. last 不终止重写后的 url 匹配,即新的 url 会再从 server 走一遍匹配流程,而 break 终止重写后的匹配
  4. break 和 last 都能组织继续执行后面的 rewrite 指令
  5. 在 location 里一旦返回 break 则直接生效并停止后续的匹配 location
server {
    location / {
        rewrite /last/ /q.html last;
        rewrite /break/ /q.html break;
    }
    location = /q.html {return 400;}
}

访问 /last/ 时重写到 /q.html,然后使用新的 uri 再匹配,正好匹配到 locatoin = /q.html 然后返回了 400;
访问 /break 时重写到 /q.html,由于返回了 break,则直接停止了;


欢迎订阅「K 叔区块链」– 专注于区块链技术学习

博客地址:http://www.jouypub.com
简书主页:https://www.jianshu.com/u/756c9c8ae984
segmentfault 主页:https://segmentfault.com/blog/jouypub
腾讯云主页:https://cloud.tencent.com/developer/column/72548

退出移动版