Apache.htaccess重写规则详解

本文深入解析了PHP项目在Apache环境下通过.htaccess文件和mod_rewrite模块实现URL重写的完整实践，涵盖启用前提（启用模块与AllowOverride All配置）、最通用的全量路由转发模板（适配主流框架）、按需定制的具体规则（如用户页、文章页映射、隐藏.php后缀、强制HTTPS与www跳转），以及关键的调试技巧与常见避坑指南，强调理解规则逻辑而非机械套用，帮助开发者安全、高效地打造简洁友好的URL结构。

PHP项目在Apache环境下实现URL重写，核心靠的是 .htaccess 文件配合 mod_rewrite 模块。它不改变PHP代码逻辑，只让访问地址更简洁、更友好。关键不是堆规则，而是理解每条指令的作用和常见组合方式。

基础启用与安全前提

所有规则生效前，必须满足两个硬性条件：

• Apache已启用 mod_rewrite 模块（Linux常用 a2enmod rewrite，Windows检查 httpd.conf 中 LoadModule rewrite_module 是否启用）
• 对应目录的虚拟主机配置中，AllowOverride 必须设为 All（不能是 None 或 FileInfo 等受限值）
• 重启Apache后，.htaccess 才可能被读取

最通用的“全量转发”模板

适用于ThinkPHP、Laravel等框架或自建路由系统，把除真实文件/目录外的所有请求，统一交给 index.php 处理：

<IfModule mod_rewrite.c>
  RewriteEngine On
  RewriteBase /
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule ^(.*)$ index.php?/$1 [L]
</IfModule>

说明：

• RewriteBase /：指定重写基准路径，多用于子目录部署（如网站在 /myapp/ 下，则改为 RewriteBase /myapp/）
• !-f 和 !-d：跳过真实存在的文件（如 logo.png）和目录（如 /css/），避免静态资源被错误转发
• index.php?/$1：将路径作为查询参数传入，PHP中可用 $_SERVER['QUERY_STRING'] 或解析 $_SERVER['REQUEST_URI'] 获取原始路径

按需匹配的具体路由规则

适合轻量项目或单页模块，直接映射固定结构：

• 用户页：RewriteRule ^user/([0-9]+)/?$ user.php?id=$1 [L] → 访问 /user/123 实际执行 user.php?id=123
• 文章页（含标题）：RewriteRule ^post/([0-9]+)/([a-zA-Z0-9_-]+)$ post.php?id=$1&slug=$2 [L]
• 隐藏 .php 后缀：RewriteCond %{REQUEST_FILENAME}.php -f + RewriteRule ^(.+)$ $1.php [L]
• 强制 HTTPS + www：RewriteCond %{HTTPS} off [OR] + RewriteCond %{HTTP_HOST} !^www\. [NC] + RewriteRule ^(.*)$ https://www.example.com/$1 [R=301,L]

调试与避坑要点

规则写错容易导致500错误或无限重定向，建议：

• 每次只加一条规则，测试通过再叠加
• 开启Apache错误日志（ErrorLog），查看具体哪行报错
• 用 [R=301] 测试跳转是否符合预期，确认后再换 [L] 做内部转发
• 注意正则贪婪性：用 ^article/(\d+)$ 比 ^article/(.*)$ 更安全，防止误匹配
• 静态资源路径出问题？检查是否漏了 !-f 判断，或前端用了相对路径（建议用 统一基准）

以上就是《Apache.htaccess重写规则详解》的详细内容，更多关于的资料请关注golang学习网公众号！