如何正确配置 Apache 的 RewriteRule 实现 URL 友好重写

胖婷小哥_3975

胖婷小哥_3975

2026-09-17

924人浏览

原创

如何正确配置 Apache 的 RewriteRule 实现 URL 友好重写

本文详解 htaccess 中 rewriterule 失效的常见原因及修复方法,重点解决“/show_article/17”无法重写为“/show_article.php?article_id=17”的问题,涵盖规则语法、路径匹配、标志位使用与调试要点。

本文详解 htaccess 中 rewriterule 失效的常见原因及修复方法,重点解决“/show_article/17”无法重写为“/show_article.php?article_id=17”的问题,涵盖规则语法、路径匹配、标志位使用与调试要点。

在 Apache 的 .htaccess 文件中,RewriteRule 不生效是开发者常遇到的问题。您当前的配置存在多个关键错误,导致重写逻辑未被触发或执行失败。

? 主要问题分析

  1. 路径前缀错误RewriteRule ^/show_article/([0-9]+)\.php 中的开头斜杠 /.htaccess 上下文中是非法的(仅在服务器级 httpd.conf 中有效),应去掉;
  2. 目标路径不匹配需求:您希望用户访问 /show_article/17(无 .php 后缀),但规则却匹配带 .php 的路径,且目标指向 /show_article.php?...,而实际文件可能是 show_article.php(注意路径层级);
  3. 缺少必要重写标志:未使用 [L](Last)终止后续规则,也未加 [QSA] 保留原有查询参数(虽本例暂无,但属良好实践);
  4. RewriteBase 与实际目录不一致:若网站部署在子目录(如 https://mysite.com/mysite/),RewriteBase / 会导致路径解析错误;若站点根目录即文档根,则 RewriteBase / 正确,但需确保规则路径与之匹配;
  5. MultiViews 干扰-MultiViews 禁用内容协商是合理的,但 Options +FollowSymLinks 已足够,无需 -MultiViews(除非明确需要禁用)。

✅ 推荐修正配置(适配您的目标)

假设您的 PHP 文件位于网站根目录下,文件名为 show_article.php,且希望实现:

  • 用户访问:https://mysite.com/show_article/17
  • 内部重写为:/show_article.php?article_id=17

请将 .htaccess 替换为以下内容:

# BEGIN Friendly URL Rewrite
Options +FollowSymLinks
RewriteEngine On
RewriteBase /

# 将 /show_article/123 → /show_article.php?article_id=123
RewriteRule ^show_article/(\d+)$ show_article.php?article_id=$1 [QSA,L]
# END

? 注意:^show_article/(\d+)$ 匹配的是URL 路径部分(不含域名和查询字符串),因此 https://mysite.com/show_article/17 中的 /show_article/17 完全匹配该正则。

Apache 2.4.62
Apache 2.4.62

Apache 2.4.62 官方 tar.gz 源码包是 Linux 及类 Unix 系统构建 Web 服务器的核心基础。通过源码编译安装,开发者能够灵活定制模块、优化性能并精准控制安装路径,满足多样化的业务需求。

下载

⚠️ 关键注意事项

  • 启用 mod_rewrite:确保 Apache 已加载 rewrite_module(Linux 常通过 a2enmod rewrite 启用,Windows 检查 httpd.confLoadModule rewrite_module 是否启用);
  • AllowOverride 权限:虚拟主机配置中必须设置 AllowOverride All(或至少 AllowOverride FileInfo),否则 .htaccess 中的重写指令将被忽略;
  • 缓存干扰:浏览器可能缓存 301 重定向或旧响应,请务必使用无痕窗口测试,或在 Chrome 开发者工具中勾选 Disable cache
  • PHP 文件存在性验证:确保 show_article.php 真实存在于网站根目录,且有可读权限;
  • 调试技巧:临时添加 RewriteLog(Apache LogLevel alert rewrite:trace3(Apache ≥ 2.4)查看重写过程日志(需管理员权限)。

? 进阶建议(可选)

若需支持多级路径(如 /show_article/17/title-slug)或统一处理所有 ID 类路由,可扩展为:

# 支持带可选 slug 的路由(slug 被忽略,仅用于 SEO)
RewriteRule ^show_article/(\d+)(?:/[^/]+)?$ show_article.php?article_id=$1 [QSA,L]

最后,请始终以 https://mysite.com/show_article/17 形式在 HTML 中书写链接(而非 ?article_id=17),才能真正发挥重写优势——既提升 SEO 友好性,又隐藏后端参数结构。

正确配置后,Apache 将静默完成内部映射,用户地址栏显示干净 URL,服务端脚本仍可通过 $_GET['article_id'] 获取值,一切无缝衔接。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

apache

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

4775

7

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

2023.06.21

2792

4

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.31

2470

5

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.01

2479

5

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

2023.08.11

4499

6

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

2023.08.11

2441

3

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

2229

3

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

2023.09.01

2068

6

HTML嵌入CSS样式的方法
HTML嵌入CSS样式的方法

HTML嵌入CSS样式的方法有内联样式、内部样式表和外部样式表。本专题为大家提供CSS样式相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.20

2008

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Apache Maven 官方安装指南
Apache Maven 官方安装指南

共0课时 | 0人学习

Apache Maven 官方用户中心
Apache Maven 官方用户中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习