本文介绍如何通过 .htaccess 配置 Apache 的 mod_rewrite，使请求优先从 cache/ 目录中匹配并返回对应 .html 文件（如 /how-to-do → cache/how-to-do.html），若文件不存在则交由 index.php 统一处理。
本文介绍如何通过 `.htaccess` 配置 apache 的 mod_rewrite，使请求优先从 `cache/` 目录中匹配并返回对应 `.html` 文件（如 `/how-to-do` → `cache/how-to-do.html`），若文件不存在则交由 `index.php` 统一处理。
在现代 PHP 应用（如 Laravel、Lumen 或自研轻量框架）中，常采用「前端控制器模式」：所有非静态资源请求均被重写至 index.php 进行路由分发。但为提升性能，我们往往希望对已生成的静态缓存页（如 cache/about-us.html）直接由 Web 服务器响应，绕过 PHP 解析——这不仅降低 CPU 消耗，还能显著减少响应延迟。
要实现该逻辑，关键在于在现有重写规则链中插入一个前置缓存检查环节，且确保其优先级高于最终回退到 index.php 的规则。
✅ 正确的 .htaccess 缓存规则配置
将以下代码块紧接在 # Send Requests To Front Controller... 注释之前（即位于最后一条 RewriteRule ^ index.php [L] 规则之上）：
# Check if cache file exists and serve from cache if it is
RewriteCond %{DOCUMENT_ROOT}/cache/$0.html -f
RewriteRule ^[^/.]+$ cache/$0.html [L]? 规则解析：
- RewriteRule ^[^/.]+$：匹配不包含 / 和 . 的单段 URL 路径（如 /how-to-do、/contact），但排除 /foo/bar 或 /style.css 等多级路径或带扩展名的请求；
- $0：捕获整个匹配的路径（不含开头 /），例如请求 /how-to-do 时，$0 值为 how-to-do；
- RewriteCond %{DOCUMENT_ROOT}/cache/$0.html -f：检查服务器文件系统中是否存在 DOCUMENT_ROOT/cache/how-to-do.html；
- [L]：匹配成功即终止后续重写，直接输出该 HTML 文件。
? 提示：%{DOCUMENT_ROOT} 是 Apache 内置变量，指向站点根目录（如 /var/www/html），比硬编码路径更安全、可移植。
立即学习“PHP免费学习笔记（深入）”；
? 支持多级路径（可选增强）
若需支持类似 /blog/post-123 这样的路径也尝试查找 cache/blog/post-123.html，可放宽正则限制：
# For multi-segment paths (e.g., /blog/post-123 → cache/blog/post-123.html)
RewriteCond %{DOCUMENT_ROOT}/cache/$0.html -f
RewriteRule ^[^.]+$ cache/$0.html [L]⚠️ 注意：此时 ^[^.]+$ 仅排除含 . 的路径（防止误匹配 .htaccess 或 .php），但仍允许 / 存在；确保 cache/ 目录结构与 URL 路径严格一致（建议启用 FollowSymLinks 并确认目录权限）。
⚠️ 注意事项与最佳实践
- 目录命名一致性：问题中描述为 caches 文件夹，但示例规则使用 cache/ —— 请务必统一为实际目录名（如 caches/ 则需同步修改规则中的 cache/ 为 caches/）；
- 文件扩展名约定：本方案默认查找 .html 后缀。若缓存为 .htm、.json 或无扩展名，请相应调整 RewriteCond 和 RewriteRule 中的 .html；
- 避免循环重写：确保 cache/ 目录不在重写路径中被再次捕获（当前规则因限定 ^[^/.]+$ 已天然规避）；
- 调试技巧：临时添加 RewriteLogLevel 9 和 RewriteLog "/path/to/rewrite.log"（Apache 2.2）或启用 LogLevel alert rewrite:trace3（Apache 2.4）辅助排查；
-
安全性提醒：禁止用户直接上传或写入 cache/ 下的可执行脚本（如 .php），建议在 cache/ 目录下额外放置 .htaccess 禁用脚本执行：
<Files "*"> SetHandler default-handler </Files>
✅ 最终效果验证
| 请求 URL | cache/ 中存在？ | 实际响应来源 |
|---|---|---|
| https://example.com/how-to-do | how-to-do.html ✔️ | cache/how-to-do.html（200 OK，静态响应） |
| https://example.com/how-to-do | how-to-do.html ❌ | index.php（PHP 处理路由） |
| https://example.com/style.css | — | 原始文件（因正则不匹配，跳过缓存检查） |
此方案简洁高效，无需改动应用代码，即可为高频页面提供毫秒级静态响应能力，是动静分离架构中不可或缺的一环。
