如何在 Apache2 中将子目录所有请求重写至 PHP 入口文件-php教程-PHP中文网

如何在 Apache2 中将子目录所有请求重写至 PHP 入口文件

本文详解如何通过 .htaccess 正确配置 Apache2，将 /myapi/ 子目录下的所有动态请求（如 /myapi/books）统一路由到 src/index.php，同时排除静态资源，避免重写循环与性能隐患。

本文详解如何通过 `.htaccess` 正确配置 apache2，将 `/myapi/` 子目录下的所有动态请求（如 `/myapi/books`）统一路由到 `src/index.php`，同时排除静态资源，避免重写循环与性能隐患。

在基于 Apache2 的 PHP 项目中（如使用 Slim、Laravel 或自定义路由框架），常需将子目录内所有非静态请求集中交由单一入口文件（如 src/index.php）处理。你已将项目置于 /var/www/html/myapi/，并希望访问 http://localhost/myapi/books 时，实际执行的是 myapi/src/index.php —— 这正是典型的前端控制器（Front Controller）模式。但原始 .htaccess 配置存在逻辑冗余与潜在风险，需优化。

✅ 推荐配置（Apache 2.4+）

将以下内容保存为 /var/www/html/myapi/.htaccess：

RewriteEngine On
RewriteRule !\.(png|jpe?g|gif|zip|css|svg|js|php)$ src/index.php [END]

? 配置说明：

RewriteRule !\.(...)$：否定匹配——仅当请求路径不以指定扩展名结尾时才触发重写。相比 RewriteCond + RewriteRule 组合，更简洁、高效。
扩展名列表含 jpe?g（兼容 jpg/jpeg）、php（防止意外重写其他 PHP 脚本，提升安全性）。
[END] 是关键：Apache 2.4 引入的标志，立即终止当前重写流程，彻底避免后续规则或内部重写循环（而 [L] 在某些上下文中仍可能被再次处理，导致 500 错误）。
无需 QSA：因未修改查询字符串，Apache 默认透传 ?id=123 等参数。
无需捕获 (.*)：因未在目标路径中引用捕获组，省略可减少正则开销。

⚠️ 注意事项与排错要点

确保 Apache 启用 mod_rewrite 并允许 .htaccess 覆盖：
在虚拟主机或主配置中确认：
```
<directory>
    AllowOverride All
    Require all granted
</directory>
```
并重启服务：sudo systemctl restart apache2。
Docker 环境特别提醒：如你所遇，.htaccess 文件需真实挂载进容器（而非仅挂载父目录），且权限需为 644、属主可读。建议通过 docker exec -it ls -l /var/www/html/myapi/.htaccess 验证文件存在性与内容一致性。
调试技巧：临时启用重写日志（需 root 权限）：

btpanel phpsite 宝塔面板PHP网站
宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载
```
LogLevel alert rewrite:trace3
```
查看 /var/log/apache2/error.log 定位匹配失败原因。
安全加固建议：
若 src/ 目录不应被直接访问，可在其下添加空 index.html 或配置 Deny from all（配合 AllowOverride None），防止敏感文件泄露。