Apache环境下WordPress子目录.htaccess URL重写规则失效问题

云原生阿岚

2026-6-16

WordPress站点/api子目录URL重写解决方案

一、修正/api子目录的.htaccess规则

你的原规则失效核心原因是RewriteBase设置后，匹配路径是相对于/api目录的，规则开头的^api/属于冗余前缀，导致实际匹配的是/api/api/FormEntries/1这类不存在的路径。

替换/api/.htaccess内容为：

RewriteEngine On
RewriteBase /api/
RewriteRule ^([a-zA-Z0-9_-]+)/?([0-9]+)?$ $1.php?id=$2 [NC,QSA,L]

关键调整说明：

移除规则开头的api/，因为RewriteBase已经将基准路径锁定为/api/，匹配逻辑仅针对子目录内的路径
^([a-zA-Z0-9_-]+)精准匹配PHP文件名（如FormEntries、OtherObject）
/?([0-9]+)?兼容带/不带斜杠的ID参数，同时允许省略ID的场景（比如访问/api/FormEntries直接对应FormEntries.php）
[NC]忽略URL大小写，[QSA]保留额外查询参数，[L]终止后续规则执行，避免冲突

二、根目录.htaccess配置方案（避免WordPress路由干扰）

如果子目录规则仍不生效，可将/api的重写规则放到根目录.htaccess的最顶部（在WordPress默认规则之前），确保优先执行：

RewriteEngine On
# 优先处理/api友好URL
RewriteRule ^api/([a-zA-Z0-9_-]+)/?([0-9]+)?$ /api/$1.php?id=$2 [NC,QSA,L]

# 以下保留WordPress默认规则，请勿修改
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]

这样设置后，所有/api开头的请求会先被你的规则处理，不会进入WordPress的路由逻辑，彻底避免冲突。