htaccess RewriteRule配置可选参数适配REST API路由问题

问题根源 #

你写的规则失效有两个核心错误：

• 规则顺序和正则写法错误：新规则里periods后没有加斜杠分隔，会错误捕获路径内容，同时和原有匹配period路径段的规则产生冲突
• 对RewriteRule匹配范围理解错误：第三种URL里的?year={year}属于查询字符串（Query String）部分，RewriteRule默认只匹配?前面的路径内容，试图在路径正则里捕获year参数完全无效

可用配置 #

直接替换原有规则即可，注意长路径规则必须放在短路径规则前面，避免被提前拦截：

RewriteEngine On

# 适配格式2：/customer/{customerid}/orders/periods/{period}
RewriteRule ^customer/([a-zA-Z0-9-]+)/orders/periods/([a-z0-9-]+)/?$ api/customer.php?customer_id=$1&period=$2 [L,QSA]

# 适配格式1和格式3：/customer/{customerid}/orders/periods、/customer/{customerid}/orders/periods?year={year}
RewriteRule ^customer/([a-zA-Z0-9-]+)/orders/periods/?$ api/customer.php?customer_id=$1 [L,QSA]

规则说明 #

• 正则末尾的/?是兼容路径末尾带不带斜杠的访问场景，不影响参数传递
• 标记里的QSA是Query String Append的缩写，作用是自动把原请求携带的查询参数（比如year=2024）追加到转发的目标URL后，不需要单独写正则匹配查询参数。转发完成后你在customer.php里直接通过$_GET['customer_id']、$_GET['period']、$_GET['year']就能拿到对应参数，和普通GET传参的获取方式完全一致
• 如果需要区分是否传了year参数，直接在PHP代码里用isset($_GET['year'])判断即可，不需要在Rewrite层做额外逻辑处理

内容的提问来源于stack exchange，提问作者ernschd