本文详解如何通过 .htaccess 正确配置 Apache2，将 /myapi/ 下所有动态请求（如 /myapi/books）统一路由到 src/index.php，同时排除静态资源，避免重写循环与性能隐患，并提供安全、高效、符合现代 Apache 2.4 最佳实践的规则写法。
本文详解如何通过 `.htaccess` 正确配置 apache2，将 `/myapi/` 下所有动态请求（如 `/myapi/books`）统一路由到 `src/index.php`，同时排除静态资源，避免重写循环与性能隐患，并提供安全、高效、符合现代 apache 2.4 最佳实践的规则写法。
要在 Apache2 中实现「将 /myapi/ 子目录下所有非静态资源请求全部转发至 src/index.php」，关键在于编写语义清晰、无副作用、兼容性强的重写规则。原始规则虽功能接近，但存在冗余捕获、条件分离、潜在重写循环风险及标志滥用等问题。以下是优化后的完整解决方案：
✅ 推荐 .htaccess 配置（置于 /var/www/html/myapi/.htaccess）
RewriteEngine On # 将所有不匹配静态文件扩展名的请求，直接重写到 src/index.php RewriteRule !\.(png|jpe?g|gif|zip|css|svg|js|ico|woff2?|ttf|eot|pdf|xml|txt)$ src/index.php [END]
? 说明：
- ! 表示“否定”，即匹配不以指定扩展名结尾的 URL 路径；
- jpe?g 同时覆盖 jpeg 和 jpg；
- [END] 是 Apache 2.4+ 引入的关键标志，彻底终止当前重写流程，防止后续规则（包括父目录 .htaccess 或主配置中可能存在的规则）再次介入——这是避免隐式重写循环、提升安全性和可预测性的核心保障；
- 不使用 QSA（Query String Append）是因目标路径 src/index.php 本身不含查询参数，Apache 默认自动透传原始查询字符串（如 /myapi/books?id=123 → src/index.php?id=123），显式添加反而冗余。
⚠️ 注意事项与常见陷阱
-
确保 Apache 启用了 mod_rewrite 并允许 .htaccess 覆盖：
在虚拟主机或主配置中，对应目录需设置：<Directory "/var/www/html/myapi"> AllowOverride All Require all granted </Directory>若使用 Docker（如问题中所述），还需确认 .htaccess 文件真实挂载并被容器内 Apache 进程读取——体积挂载路径错误、权限不足（如 chmod 644）、SELinux 上下文异常均会导致规则静默失效。
-
路径前缀无需加 /：
src/index.php 是相对于 .htaccess 所在目录（即 /myapi/）的相对路径。若误写为 /src/index.php，Apache 会尝试从文档根 /var/www/html/ 下查找，导致 404；更严重的是，在某些配置下可能触发无限内部重定向（500 错误）。立即学习“PHP免费学习笔记（深入）”；
-
建议补充 PHP 扩展名过滤：
若项目不允许直接访问其他 PHP 脚本（如 src/config/db.php），可将 php 加入排除列表：RewriteRule !\.(php|png|jpe?g|gif|zip|css|svg|js|ico|woff2?|ttf|eot|pdf|xml|txt)$ src/index.php [END]
此举增强安全性，防止敏感脚本被意外执行。
-
调试技巧：
临时启用重写日志（需管理员权限）：LogLevel alert rewrite:trace3
查看 error.log 可清晰追踪每一步匹配与重写行为，快速定位规则未生效原因。
? 补充：PHP 端如何获取原始路径？
在 src/index.php 中，可通过 $_SERVER['REQUEST_URI'] 获取完整请求路径（如 /myapi/books）。若需剥离 /myapi 前缀以适配框架路由，推荐使用：
$base = '/myapi'; $requestUri = $_SERVER['REQUEST_URI']; $path = substr($requestUri, strlen($base)); // 结果：'/books'（可用于 Slim/Laravel/Lumen 等路由解析）
此方案简洁可靠，不依赖 PATH_INFO（易受 CGI 模式影响），兼容性最佳。
综上，一条精准的 RewriteRule + [END] 标志，辅以合理的静态资源白名单和严格的服务端配置，即可稳健支撑现代 PHP API 子目录路由需求。
