Apache2 中 .htaccess 嵌套路由重写失败的完整解决方案-php教程-PHP中文网

Apache2 中 .htaccess 嵌套路由重写失败的完整解决方案

本文详解 Apache2 下嵌套 URL（如 /en/about）重写到 index.php?url=... 时 404 的根本原因，涵盖配置路径不一致、重写规则自循环、静态资源误拦截等关键问题，并提供安全、健壮的 .htaccess 配置方案。

本文详解 apache2 下嵌套 url（如 `/en/about`）重写到 `index.php?url=...` 时 404 的根本原因，涵盖配置路径不一致、重写规则自循环、静态资源误拦截等关键问题，并提供安全、健壮的 `.htaccess` 配置方案。

在基于 PHP 的单入口应用中，常需将任意嵌套路径（如 /en/about、/zh/contact/us）统一交由 index.php 处理，通过 $_GET['url'] 解析路由。但实践中频繁出现 404 错误——表面看 .htaccess 已启用、mod_rewrite 已加载，问题实则隐藏于配置一致性与重写逻辑严谨性之中。

? 根本问题定位

首先，您当前的 Apache 虚拟主机配置存在路径不匹配：

<directory>   # ← .htaccess 生效目录在此
DocumentRoot /var/www/domain/      # ← 实际文档根目录却在此</directory>

若 .htaccess 文件实际位于 /var/www/domain/.htaccess，而指向 /var/www/html/domain，则该文件根本不会被 Apache 加载，所有重写规则失效。请确保二者路径严格一致：

# ✅ 正确示例（假设项目在 /var/www/domain）
<directory>
    Options -Indexes +FollowSymLinks -MultiViews
    AllowOverride All
    Require all granted
</directory>
DocumentRoot /var/www/domain

其次，原始重写规则存在逻辑缺陷：

RewriteRule .* index.php?url=$0 [QSA,L]

该规则会无差别重写所有请求，包括对 index.php 自身的访问，导致二次重写：
→ 请求 /en/about → 重写为 index.php?url=en/about
→ 但 index.php 再次被匹配 → 重写为 index.php?url=index.php&url=en/about
虽 PHP 仍可读取 $_GET['url'] 的最后一个值（因 QSA 合并参数），但 $_SERVER['QUERY_STRING'] 已污染，且存在潜在循环风险。

更严重的是，该规则还会重写 style.css、logo.png 等静态资源，导致样式丢失或脚本加载失败。

✅ 推荐的健壮 .htaccess 配置

以下配置已通过生产环境验证，兼顾安全性、可维护性与兼容性：

Apache Tika Content Extraction Hub

通过Apache Tika Server REST API从1400多种文件格式中提取文本和元数据。处理PDF、DOCX、PPTX、电子邮件归档以及带有MIME类型检测的嵌入式文档提取。

下载

# 启用重写引擎并设置基础路径（需与 DocumentRoot 匹配）
RewriteEngine On
RewriteBase /

# 1. 直接放行对 index.php 的请求（避免自循环）
RewriteRule ^index\.php$ - [L]

# 2. 仅当请求路径不对应真实文件时，才重写到入口文件
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?url=$1 [QSA,L]

关键说明：

^index\.php$ - [L]：精确匹配 index.php 并立即终止（[L]），杜绝重入；
!-f 和 !-d：双重条件确保仅重写非文件、非目录的请求（如 /en/about），而 /css/app.css 或 /images/icon.svg 将直接由 Apache 原样响应；
^(.*)$ 替代 .*：更清晰地捕获整个路径，$1 引用更语义化；
QSA（Query String Append）：保留原始查询参数（如 /en/about?id=123 → url=en/about&id=123）。

⚠️ 注意事项与调试建议

启用 Apache 日志辅助诊断：
在虚拟主机配置中添加：
```
LogLevel alert rewrite:trace3
```
重启 Apache 后查看 error.log，可追踪每条规则的匹配与执行过程。

PHP 路由解析示例（index.php）：

<?php $url = $_GET['url'] ?? '';
// 安全过滤：移除开头/结尾斜杠，防止路径遍历
$url = trim($url, '/');
$segments = explode('/', $url); // ['en', 'about']
// 后续路由分发逻辑...

Windows 用户注意：
若使用 WAMP/XAMPP，请确认 httpd.conf 中 LoadModule rewrite_module modules/mod_rewrite.so 已取消注释，且 AllowOverride All 在对应块中生效。

Nginx 迁移提示：
若未来迁移到 Nginx，等效配置为：

location / {
    try_files $uri $uri/ /index.php?url=$uri&$args;
}

遵循以上配置，您的嵌套路由将稳定工作：点击 domain.local/en/about 将正确触发 index.php，$_GET['url'] 值为 en/about，静态资源毫发无损，且彻底规避重写循环与路径错配陷阱。