搜索

[23782] 2015-04-10_Nginx重写规则指南

文档创建者：s7ckTeam
浏览次数：1
最后更新：2025-01-18
2015-04-10_Nginx重写规则指南 N g i n x   重 写 规 则 指 南 L i n u x 中 国   2 0 1 5 - 0 4 - 1 0 当 运 维 遇 到 要 重 写 情 况 时 ， 往 往 是 要 程 序 员 把 重 写 规 则 写 好 后 ， 发 给 你 ， 你 再 到 生 产 环 境 下 配 置 。 对 于 重 写 规 则 说 到 底 就 是 正 则 匹 配 ， 做 运 维 的 岂 能 对 正 则 表 达 式 不 了 解 的 ？ 最 起 码 最 基 本 的 正 则 表 达 式 会 写 。 套 用 一 句 阿 里 的 话 ( 某 网 友 说 是 阿 里 说 的 ， 不 清 楚 到 底 是 不 是 出 自 阿 里 ) “ 不 懂 程 序 的 运 维 ， 不 是 好 运 维 ； 不 懂 运 维 的 开 发 ， 不 是 好 开 发 。 ” 。   正 则 表 达 式 也 是 一 门 语 言 哈 。 当 你 学 习 一 门 语 言 时 ， 必 然 会 遇 到 该 门 语 言 的 正 则 表 达 式 这 章 节 的 。   在 这 里 推 荐 一 本 非 常 好 的 正 则 表 达 式 书 ， 包 含 常 用 的 语 言 的 正 则 写 法 如 s e d 、 p e r l 、 b a s h 、 a w k 、 p h p 、 c # 、 j a v a 、 j a v a s c r i p t 、 p y t h o n 、 r u b y 等 等 ， 《 R e g u l a r   E x p r e s s i o n s   C o o k b o o k ,   2 n d   E d i t i o n 》 ， 也 有 中 文 版 的 ， 大 家 可 以 到 网 络 上 找 找 。 本 文 介 绍 n g i n x 的 重 写 模 块 ， 创 建 重 写 规 则 向 导 ， 便 于 快 捷 正 确 的 创 建 新 的 重 写 规 则 ， 不 求 救 于 人 。 同 时 ， 如 果 想 把 a p a c h e 转 换 成 n g i n x ， 重 写 规 则 也 是 要 改 的 咯 。 一 .   r e w r i t e 模 块 介 绍 n g i n x 的 重 写 模 块 是 一 个 简 单 的 正 则 表 达 式 匹 配 与 一 个 虚 拟 堆 叠 机 结 合 。 依 赖 于 P C R E 库 ， 因 此 需 要 安 装 p c r e 。 根 据 相 关 变 量 重 定 向 和 选 择 不 同 的 配 置 ， 从 一 个 l o c a t i o n 跳 转 到 另 一 个 l o c a t i o n ， 不 过 这 样 的 循 环 最 多 可 以 执 行 1 0 次 ， 超 过 后 n g i n x 将 返 回 5 0 0 错 误 。 同 时 ， 重 写 模 块 包 含 s e t 指 令 ， 来 创 建 新 的 变 量 并 设 其 值 ， 这 在 有 些 情 景 下 非 常 有 用 的 ， 如 记 录 条 件 标 识 、 传 递 参 数 到 其 他 l o c a t i o n 、 记 录 做 了 什 么 等 等 。 二 .   r e w r i t e 模 块 指 令 b r e a k 语 法 ： b r e a k 默 认 值 ： n o n e 使 用 字 段 ： s e r v e r ,   l o c a t i o n ,   i f 完 成 当 前 设 置 的 重 写 规 则 ， 停 止 执 行 其 他 的 重 写 规 则 。 i f 语 法 ： i f   ( c o n d i t i o n )   {   …   } 默 认 值 ： n o n e
使 用 字 段 ： s e r v e r ,   l o c a t i o n 注 意 ： 尽 量 考 虑 使 用 t r y _ f i l e s 代 替 。 判 断 的 条 件 可 以 有 以 下 值 ： 1 .   一 个 变 量 的 名 称 ： 空 字 符 传 “ ” 或 者 一 些 “ 0 ” 开 始 的 字 符 串 为 f a l s e 。 2 .   字 符 串 比 较 ： 使 用 = 或 ! = 运 算 符 3 .   正 则 表 达 式 匹 配 ： 使 用 ~ ( 区 分 大 小 写 ) 和 ~ * ( 不 区 分 大 小 写 ) ， 取 反 运 算 ! ~ 和 ! ~ * 。 4 .   文 件 是 否 存 在 ： 使 用 - f 和 ! - f 操 作 符 5 .   目 录 是 否 存 在 ： 使 用 - d 和 ! - d 操 作 符 6 .   文 件 、 目 录 、 符 号 链 接 是 否 存 在 ： 使 用 - e 和 ! - e 操 作 符 7 .   文 件 是 否 可 执 行 ： 使 用 - x 和 ! - x 操 作 符 r e t u r n 语 法 ： r e t u r n   c o d e 默 认 值 ： n o n e 使 用 字 段 ： s e r v e r ,   l o c a t i o n ,   i f 停 止 处 理 并 为 客 户 端 返 回 状 态 码 。 非 标 准 的 4 4 4 状 态 码 将 关 闭 连 接 ， 不 发 送 任 何 响 应 头 。 可 以 使 用 的 状 态 码 有 ： 2 0 4 ， 4 0 0 ， 4 0 2 - 4 0 6 ， 4 0 8 ， 4 1 0 , 4 1 1 ,   4 1 3 ,   4 1 6 与 5 0 0 - 5 0 4 。 如 果 状 态 码 附 带 文 字 段 落 ， 该 文 本 将 被 放 置 在 响 应 主 体 。 相 反 ， 如 果 状 态 码 后 面 是 一 个 U R L ， 该 U R L 将 成 为 l o c a t i o n 头 补 值 。 没 有 状 态 码 的 U R L 将 被 视 为 一 个 3 0 2 状 态 码 。 r e w r i t e 语 法 ： r e w r i t e   r e g e x   r e p l a c e m e n t   f l a g 默 认 值 ： n o n e 使 用 字 段 ： s e r v e r ,   l o c a t i o n ,   i f 按 照 相 关 的 正 则 表 达 式 与 字 符 串 修 改 U R I ， 指 令 按 照 在 配 置 文 件 中 出 现 的 顺 序 执 行 。 可 以 在 重 写 指 令 后 面 添 加 标 记 。 注 意 ： 如 果 替 换 的 字 符 串 以 h t t p : / / 开 头 ， 请 求 将 被 重 定 向 ， 并 且 不 再 执 行 多 余 的 r e w r i t e 指 令 。 尾 部 的 标 记 ( f l a g ) 可 以 是 以 下 的 值 ： l a s t   –   停 止 处 理 重 写 模 块 指 令 ， 之 后 搜 索 l o c a t i o n 与 更 改 后 的 U R I 匹 配 。 b r e a k   –   完 成 重 写 指 令 。 r e d i r e c t   –   返 回 3 0 2 临 时 重 定 向 ， 如 果 替 换 字 段 用 h t t p : / / 开 头 则 被 使 用 。 p e r m a n e n t   –   返 回 3 0 1 永 久 重 定 向 。 r e w r i t e _ l o g 语 法 ： r e w r i t e _ l o g   o n   |   o f f 默 认 值 ： r e w r i t e _ l o g   o f f 使 用 字 段 ： s e r v e r ,   l o c a t i o n ,   i f 变 量 ： 无 启 用 时 将 在 e r r o r   l o g 中 记 录 n o t i c e 级 别 的 重 写 日 志 。 s e t 语 法 ： s e t   v a r i a b l e   v a l u e
默 认 值 ： n o n e 使 用 字 段 ： s e r v e r ,   l o c a t i o n ,   i f 为 给 定 的 变 量 设 置 一 个 特 定 值 。 u n i n i t i a l i z e d _ v a r i a b l e _ w a r n 语 法 ： u n i n i t i a l i z e d _ v a r i a b l e _ w a r n   o n | o f f 默 认 值 ： u n i n i t i a l i z e d _ v a r i a b l e _ w a r n   o n 使 用 字 段 ： h t t p ,   s e r v e r ,   l o c a t i o n ,   i f 控 制 是 否 记 录 未 初 始 化 变 量 的 警 告 信 息 。 三 .   重 写 规 则 组 成 部 分 3 . 1   任 何 重 写 规 则 的 第 一 部 分 都 是 一 个 正 则 表 达 式 可 以 使 用 括 号 来 捕 获 ， 后 续 可 以 根 据 位 置 来 将 其 引 用 ， 位 置 变 量 值 取 决 于 捕 获 正 则 表 达 式 中 的 顺 序 ， $ 1 引 用 第 一 个 括 号 中 的 值 ， $ 2 引 用 第 二 个 括 号 中 的 值 ， 以 此 类 推 。 如 ： $ 1 是 两 个 小 写 字 母 组 成 的 字 符 串 ， $ 2 是 由 小 写 字 母 和 0 到 9 的 数 字 组 成 的 5 个 字 符 的 字 符 串 ， $ 3 将 是 个 文 件 名 ， $ 4 是 p n g 、 j p g 、 g i f 中 的 其 中 一 个 。 3 . 2   重 写 规 则 的 第 二 部 分 是 U R I 请 求 被 改 写 。 该 U R I 可 能 包 含 正 则 表 达 式 中 的 捕 获 的 位 置 参 数 或 这 个 级 别 下 的 n g i n x 任 何 配 置 变 量 。 如 ： 如 果 这 个 U R I 不 匹 配 n g i n x 配 置 的 任 何 l o c a t i o n ， 那 么 将 给 客 户 端 返 回 3 0 1 ( 永 久 重 定 向 ) 或 3 0 2 ( 临 时 重 定 向 ) 的 状 态 码 来 表 示 重 定 向 类 型 。 该 状 态 码 可 以 通 过 第 三 个 参 数 来 明 确 指 定 。 3 . 3   重 写 规 则 的 第 三 部 分 第 三 部 分 也 就 是 尾 部 的 标 记 ( f l a g ) 。   l a s t 标 记 将 导 致 重 写 后 的 U R I 搜 索 匹 配 n g i n x 的 其 他 l o c a t i o n ， 最 多 可 循 环 1 0 次 。 如 ： b r e a k 指 令 可 以 当 做 自 身 指 令 。 如 ： 另 一 个 停 止 重 写 模 块 处 理 指 令 是 r e t u r n ，   来 控 制 主 H T T P 模 块 处 理 请 求 。   这 意 味 着 ， n g i n x 直 接 返 回 信 息 给 客 户 端 ， 与 e r r o r _ p a g e 结 合 为 客 户 端 呈 1 .   ^ / i m a g e s / ( [ a - z ] { 2 } ) / ( [ a - z 0 - 9 ] { 5 } ) / ( . * ) . ( p n g | j p g | g i f ) $ 1 .   / d a t a ? f i l e = $ 3 . $ 4 1 .   r e w r i t e   ' ^ / i m a g e s / ( [ a - z ] { 2 } ) / ( [ a - z 0 - 9 ] { 5 } ) / ( . * ) . ( p n g | j p g | g i f ) $ '   / d a t a ? f i l e = $ 3 . $ 4   l a s t ; 1 .   i f   ( $ b w h o g )   { 2 .           l i m i t _ r a t e   3 0 0 k ; 3 .           b r e a k ; 4 .   }
现 格 式 化 的 H T M L 页 面 或 激 活 不 同 的 模 块 来 完 成 请 求 。 如 果 状 态 码 附 带 文 字 段 落 ， 该 文 本 将 被 放 置 在 响 应 主 体 。 相 反 ， 如 果 状 态 码 后 面 是 一 个 U R L ， 该 U R L 将 成 为 l o c a t i o n 头 补 值 。 没 有 状 态 码 的 U R L 将 被 视 为 一 个 3 0 2 状 态 码 。 如 ： 四 四 .   实 例 五 五 .   创 建 新 的 重 新 规 则 在 接 到 要 创 建 新 的 重 写 规 则 时 ， 要 弄 清 楚 需 求 是 什 么 样 的 ， 再 决 定 怎 么 做 。 毕 竟 重 写 也 是 耗 资 源 的 有 效 率 之 分 的 。   下 面 的 这 些 问 题 有 些 帮 助 1 .   l o c a t i o n   =   / i m a g e 4 0 4 . h t m l   { 2 .           r e t u r n   4 0 4   " i m a g e   n o t   f o u n d n " ; 3 .   } 1 .   h t t p   { 2 .           #   定 义 i m a g e 日 志 格 式 3 .           l o g _ f o r m a t   i m a g e l o g   ' [ $ t i m e _ l o c a l ]   '   $ i m a g e _ f i l e   '   '   $ i m a g e _ t y p e   '   '   $ b o d y _ b y t e s _ s e n t   '   '   $ s t a t u s ; 4 .           #   开 启 重 写 日 志 5 .           r e w r i t e _ l o g   o n ; 6 .     7 .           s e r v e r   { 8 .                   r o o t   / h o m e / w w w ; 9 .     1 0 .                   l o c a t i o n   /   { 1 1 .                           #   重 写 规 则 信 息 1 2 .                           e r r o r _ l o g   l o g s / r e w r i t e . l o g   n o t i c e ;   1 3 .                           #   注 意 这 里 要 用 ‘ ’ 单 引 号 引 起 来 ， 避 免 { } 1 4 .                           r e w r i t e   ' ^ / i m a g e s / ( [ a - z ] { 2 } ) / ( [ a - z 0 - 9 ] { 5 } ) / ( . * ) . ( p n g | j p g | g i f ) $ '   / d a t a ? f i l e = $ 3 . $ 4 ; 1 5 .                           #   注 意 不 能 在 上 面 这 条 规 则 后 面 加 上 “ l a s t ” 参 数 ， 否 则 下 面 的 s e t 指 令 不 会 执 行 1 6 .                           s e t   $ i m a g e _ f i l e   $ 3 ; 1 7 .                           s e t   $ i m a g e _ t y p e   $ 4 ; 1 8 .                   } 1 9 .     2 0 .                   l o c a t i o n   / d a t a   { 2 1 .                           #   指 定 针 对 图 片 的 日 志 格 式 ， 来 分 析 图 片 类 型 和 大 小 2 2 .                           a c c e s s _ l o g   l o g s / i m a g e s . l o g   m a i n ; 2 3 .                           r o o t   / d a t a / i m a g e s ; 2 4 .                           #   应 用 前 面 定 义 的 变 量 。 判 断 首 先 文 件 在 不 在 ， 不 在 再 判 断 目 录 在 不 在 ， 如 果 还 不 在 就 跳 转 到 最 后 一 个 u r l 里 2 5 .                           t r y _ f i l e s   / $ a r g _ f i l e   / i m a g e 4 0 4 . h t m l ; 2 6 .                   } 2 7 .                   l o c a t i o n   =   / i m a g e 4 0 4 . h t m l   { 2 8 .                           #   图 片 不 存 在 返 回 特 定 的 信 息 2 9 .                           r e t u r n   4 0 4   " i m a g e   n o t   f o u n d n " ; 3 0 .                   } 3 1 .   }
的 ： 1 .   你 的 U R L 的 模 式 是 什 么 样 的 ? 2 .   是 否 有 一 个 以 上 的 方 法 来 实 现 ？ 3 .   是 否 需 要 捕 获 U R L 部 分 作 为 变 量 ？ 4 .   重 定 向 到 另 一 个 w e b 上 可 以 看 到 我 的 规 则 ？ 5 .   是 否 要 替 换 查 询 的 字 符 串 参 数 ？ 检 查 网 站 或 应 用 程 序 布 局 ， 清 楚 U R L 模 式 。 啰 嗦 一 句 ： 我 一 而 再 再 而 三 的 强 调 ， 运 维 不 能 与 开 发 脱 节 ， 运 维 要 参 与 到 开 发 当 中 。 如 果 有 不 止 一 种 方 法 实 现 ， 创 建 一 个 永 久 重 定 向 。 同 时 ， 定 义 一 个 重 写 规 范 ， 来 使 网 址 清 洁 ， 还 可 以 帮 助 网 站 更 容 易 被 找 到 。 实 例 1 .   要 将 h o m e 目 录 重 定 向 到 主 页 面 上 ， 目 录 结 构 如 下 ： 重 写 规 则 如 下 ： 指 定 $ s c h e m e 和 $ h o s t 变 量 ， 因 为 要 做 一 个 永 久 重 定 向 并 希 望 n g i n x 使 用 相 同 的 参 数 来 构 造 U R L 。 实 例 2 .   如 果 想 分 别 记 录 各 个 部 分 的 U R L ， 可 以 使 用 正 则 表 达 式 来 捕 获 U R I ， 然 后 ， 给 变 量 分 配 指 定 位 置 变 量 ， 见 上 面 的 实 例 。 实 例 3 .   当 重 写 规 则 导 致 内 部 重 定 向 或 指 示 客 户 端 调 用 该 规 则 本 身 被 定 义 的 l o c a t i o n 时 ， 必 须 采 取 特 殊 的 动 作 来 避 免 重 写 循 环 。 如 ： 在 s e r v e r 配 置 段 定 义 了 一 条 规 则 带 上 l a s t 标 志 ， 在 引 用 l o c a t i o n 时 ， 必 须 使 用 b r e a k 标 志 。 实 例 4 .   作 为 重 写 规 则 的 一 部 分 ， 传 递 新 的 查 询 字 符 串 参 数 是 使 用 重 写 规 则 的 目 标 之 一 。   如 ： 1 .   / 2 .   / h o m e 3 .   / h o m e / 4 .   / h o m e / i n d e x 5 .   / h o m e / i n d e x / 6 .   / i n d e x 7 .   / i n d e x . p h p 8 .   / i n d e x . p h p / 1 .   r e w r i t e   ^ / ( h o m e ( / i n d e x ) ? | i n d e x ( . p h p ) ? ) / ? $   $ s c h e m e : 2 .   / / $ h o s t /   p e r m a n e n t ; 1 .   s e r v e r   { 2 .           r e w r i t e   ^ ( / i m a g e s ) / ( . * ) . ( p n g | j p g | g i f ) $   $ 1 / $ 3 / $ 2 . $ 3   l a s t ; 3 .           l o c a t i o n   / i m a g e s /   { 4 .                   r e w r i t e   ^ ( / i m a g e s ) / ( . * ) . ( p n g | j p g | g i f ) $   $ 1 / $ 3 / $ 2 . $ 3   b r e a k ; 5 .           } 6 .   } 1 .   r e w r i t e   ^ / i m a g e s / ( . * ) _ ( d + ) x ( d + ) . ( p n g | j p g | g i f ) $   / r e s i z e r / $ 1 . $ 4 ? w i d t h = $ 2 & h e i g h t = $ 3 ?   l a s t ;
原 文 ： h t t p : / / w w w . t t l s a . c o m / n g i n x / n g i n x - r e w r i t i n g - r u l e s - g u i d e / 作 者 ：   默 北 n g i n x 重 写 规 则 说 起 来 挺 简 单 的 ， 做 起 来 就 难 ， 重 点 在 于 正 则 表 达 式 ， 同 时 ， 还 需 要 考 虑 到 n g i n x 执 行 顺 序 。 阅 读 原 文
回复

举报

高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

使用Markdown编辑器编辑 使用富文本编辑器编辑

Archiver| 手机版| 小黑屋|
Powered by Discuz! X3.4 Copyright © 2001-2020, Tencent Cloud. 商业源码建议获取授权，如侵犯您的权益，请联系客服处理