在 apache 的 rewriterule 中，使用正则表达式匹配可选后缀名的核心技巧是在后缀字符后添加问号 ?。例如，若要匹配 .html、.php 或无后缀的情况，可以使用 (\.html|\.php)?。这表示该组内容可能出现零次或一次。结合 [l] 标志可确保规则立即生效，避免后续规则干扰。
如何匹配特定后缀与无后缀的混合请求
当需要同时处理带 .html 后缀的请求和直接访问目录（无后缀）的请求时，可以将后缀部分设为可选。假设目标是将所有请求重写为 /index.php，但保留原始 URI 作为参数。对于 example.com/page.html 和 example.com/page，我们希望统一由 /index.php?uri=page 处理。关键在于捕获非后缀的主体部分，并将后缀视为可选。
<ifmodule mod_rewrite.c>
RewriteEngine On
# 匹配以 .html 结尾的请求，捕获主体
RewriteRule ^(.+)\.html$ /index.php?uri=$1 [L,QSA]
# 匹配无后缀的请求，捕获整个路径
RewriteRule ^(.+)$ /index.php?uri=$1 [L,QSA]
</ifmodule>
上述配置分为两条规则。第一条专门处理 .html 后缀，通过 (.+)\.html$ 捕获主体。第二条处理剩余的所有情况，即无后缀的请求。这种分离写法比尝试在一个复杂正则中处理所有情况更清晰且易于维护。测试时，访问 /about.html 将触发第一条规则，而访问 /contact 将触发第二条规则。两者最终都指向 /index.php 并携带相应的 uri 参数。
如何处理多个可选后缀的优先级
如果网站同时支持 .html 和 .php 两种后缀，且希望优先匹配 .html，或者在无后缀时默认视为 .html，则需要仔细设计正则表达式的顺序和结构。Apache 按顺序执行规则，因此应将更具体或优先级更高的规则放在前面。若希望 /page 自动补全为 /page.html 的逻辑，可以在规则中使用条件判断或特定的正则分组。
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
<ifmodule mod_rewrite.c>
RewriteEngine On
# 优先匹配 .html
RewriteRule ^(.+)\.html$ /content.php?type=html&file=$1 [L,QSA]
# 其次匹配 .php
RewriteRule ^(.+)\.php$ /content.php?type=php&file=$1 [L,QSA]
# 最后匹配无后缀，默认当作 html 处理
RewriteRule ^(.+)$ /content.php?type=html&file=$1 [L,QSA]
</ifmodule>
在这个场景中，我们定义了三个层级的规则。第一个规则精确匹配 .html 后缀，将其映射到 content.php 并标记类型为 html。第二个规则处理 .php 后缀，标记类型为 php。第三个规则作为兜底，匹配任何未被前两条规则捕获的请求（即无后缀），并默认将其视为 html 类型。这种结构确保了无论用户输入何种形式，都能得到一致的处理结果。注意 [QSA] 标志用于追加原有查询字符串，保证参数不丢失。
基于正则捕获组提取文件名主体的具体问题
在使用可选后缀的正则表达式时，一个常见的问题是捕获组 $1 的内容可能包含后缀本身，导致文件名提取错误。例如，若使用 ^(.+)(\.html)?$，当请求为 /test.html 时，$1 会捕获 test，这是正确的；但当请求为 /test 时，$1 也会捕获 test。然而，如果正则写得不严谨，如 ^(.*)\.(html|php)?$，在匹配 /test 时，由于 .* 是贪婪的，可能会导致匹配行为不符合预期，或者 $1 为空。为确保 $1 始终只包含文件名主体，应使用非贪婪匹配或明确界定边界。
