在网站运营中，URL（统一资源定位符）的结构对于搜索引擎优化（SEO）和用户体验至关重要。AnQiCMS 提供了灵活的伪静态功能，让我们可以自定义网站的 URL 形式，使其更具可读性和友好性。然而，在配置自定义伪静态规则时，尤其是涉及动态参数时，如果处理不当，可能会遇到 URL 参数转义问题，导致页面无法正常访问或链接结构混乱。

本文将深入探讨如何在 AnQiCMS 的自定义伪静态规则中正确配置 URL 参数，并提供实用的策略来避免常见的转义问题。

理解伪静态规则与 URL 参数

首先，我们需要区分两种主要的 URL 参数传递方式：路径型参数和查询字符串型参数。

路径型参数 是指将动态值直接嵌入到 URL 路径中，形成类似 /article/123.html 或 /category/web-design/ 这样的结构。AnQiCMS 的伪静态规则主要就是用来定义这种路径型参数的格式。它们将原本动态的、带有问号和等号的 URL（如 index.php?id=123）转化为看起来像静态 HTML 文件的链接。

查询字符串型参数 则是我们常见的以问号 ? 开头，后面跟 key=value 对，多个参数之间用 & 连接的格式，如 /search?q=AnQiCMS&page=2。这种类型的参数通常用于搜索、筛选或分页等场景，且不直接受 AnQiCMS 后台伪静态规则的路径结构定义影响，更多是在模板中构建。

在 AnQiCMS 中，通过后台的 功能管理 -> 伪静态规则 菜单，我们可以对这两种 URL 参数进行统一的管理，其中自定义模式提供了极大的灵活性。

AnQiCMS 自定义伪静态规则的核心机制

AnQiCMS 内置了多种预设的伪静态模式，如数字模式、模型命名模式等，这些模式通常能满足大部分基础需求。但当我们追求更独特的 URL 结构或遇到特定场景时，自定义模式就显得尤为重要。

自定义模式允许我们针对文档详情（archive）、分类列表（category）、模型首页（archiveIndex）、单页面（page）、标签列表（tagIndex）和标签详情（tag）六种核心页面类型，分别配置其 URL 结构。每条规则都遵循 规则名===规则值 的格式。

例如，一条基本的文章详情规则可能看起来像这样： archive===/{module}/{id}.html

这条规则表示，文章详情页的 URL 将由 /模块别名/文章ID.html 组成。

在规则值中，AnQiCMS 提供了一系列可用的变量，它们是构建动态 URL 的基石：

  • {id}：数据记录的唯一标识 ID。
  • {filename}：数据记录（如文章、单页、标签）的自定义链接别名，通常是拼音或英文。
  • {catname}：分类的自定义链接别名。
  • {catid}：分类的唯一标识 ID。
  • {module}：内容模型的 URL 别名。
  • {page}：分页页码。

正确配置 URL 参数的关键变量：避免转义问题

转义问题通常发生在系统尝试处理包含特殊字符或结构不明确的 URL 时。在 AnQiCMS 的自定义伪静态规则中，最常见的“转义问题”及其解决方案围绕着 {page} 变量的配置。

文档明确指出，{page} 变量在自定义规则中必须放在小括号 () 内，例如 (/{page})。这不仅仅是语法规定，更是避免潜在转义问题和实现 URL 可选性的关键：

  1. 实现可选性：通过 (/{page}) 这种写法，AnQiCMS 能够识别出分页参数是可选的。这意味着当用户访问第一页时，URL 中不会出现 /1 这样的冗余信息，而是直接显示不带分页参数的干净 URL。例如，如果规则是 category===/{catname}(/{page})，那么第一页的分类 URL 可能是 /news/，而第二页会是 /news/2。如果缺少括号，系统可能无法正确处理 /1 的省略，导致生成 /news/1 这样的冗余链接，或者在解析时出现路径匹配问题。

  2. 避免意外的路径匹配和参数解析：没有括号的 {page} 可能会被系统错误地解析为常规路径的一部分，尤其是在 / 符号之后。将其包裹在括号中，向 AnQiCMS 明确指示这是一个可能存在的、用于页码的动态片段，且在不存在时（即第一页）应被跳过，从而避免了路径解析上的混淆。

例如，一个常见且正确的分类列表伪静态规则如下： category===/{module}/{catname}(/{page})

这条规则会生成类似 /article/news/ (第一页) 和 /article/news/2 (第二页) 的 URL，既美观又符合 SEO 规范。

除了 {page} 的特殊处理外，{filename} 和 {catname} 这两个自定义链接别名也扮演着重要角色。它们取代了直接使用 {id} 可能带来的纯数字 URL，提供了更具语义化和关键词丰富度的链接。在后台编辑文档、分类或标签时，我们可以在“自定义 URL”字段中为它们指定 URL 友好的别名（通常是小写字母、数字和连字符），系统也会自动生成拼音别名作为默认值。确保这些自定义 URL 中不包含空格、中文或其他特殊字符，是避免 URL 编码转义问题的**实践。

避免“转义问题”的实用技巧与注意事项

要彻底避免伪静态规则中的转义问题，除了遵循 {page} 的特殊语法外，还有一些通用的实用技巧：

  1. 保持自定义 URL 别名清洁：在后台为 filename 或 catname 等字段设置自定义 URL 时，务必只使用小写字母、数字、连字符 - 或下划线 _。避免使用中文、空格、?、&、=、/ 等可能导致 URL 编码（转义）的字符。AnQiCMS 会尽力处理，但手动保持清洁能最大程度地避免问题。
  2. 区分路径参数与查询参数：伪静态规则定义的是 URL 的 路径 部分，而不是查询字符串。不要尝试在伪静态规则中模拟 ?