本教程详细阐述如何利用 `.htaccess` 文件实现网站url的整洁化。内容涵盖了隐藏php文件扩展名（如将 `about.php` 显示为 `about`），以及将带有查询参数的动态url（如 `news.php?id=45`）重写为更美观的路径形式（如 `news/45`）。文章还深入探讨了常见的配置陷阱，如重写循环和 `multiviews` 选项的冲突，并提供了完整的解决方案与示例代码，旨在帮助开发者构建用户体验更佳、对搜索引擎更友好的网站url结构。
URL美化与.htaccess重写规则概述
在现代Web开发中，拥有简洁、易读且对搜索引擎友好的URL是提升用户体验和网站SEO表现的关键。Apache服务器通过 .htaccess 文件和 mod_rewrite 模块提供了强大的URL重写能力，允许我们将复杂的内部URL映射为用户友好的外部URL。本教程将引导您完成两项核心任务：隐藏文件扩展名和美化带查询参数的动态URL。
第一步：禁用MultiViews以避免冲突
在配置自定义URL重写规则时，Apache的 MultiViews 选项有时会与我们的规则产生冲突，尤其是在处理无扩展名的URL时。MultiViews 尝试根据请求的URL和可用的文件类型自动提供最佳匹配。例如，如果请求 /about 并且存在 about.php，MultiViews 可能会在我们的重写规则生效之前就将其解析。为了确保我们的 RewriteRule 能够按预期工作，我们通常需要禁用 MultiViews。
Options -MultiViews
将这行代码放置在 .htaccess 文件的顶部，确保它在所有 RewriteRule 之前生效。
第二步：将美化URL重写回原始带参数格式
这一步的目标是将用户请求的漂亮URL（例如 example.com/news/45）在服务器内部重写为实际处理请求的动态URL（例如 news.php?id=45）。这使得用户看到的是简洁的路径，而服务器仍能正确地将参数传递给PHP脚本。
立即学习“PHP免费学习笔记（深入）”；
RewriteEngine on# 将 "/news/45" 重写为 "news.php?id=45"RewriteRule ^news/(d+)$ news.php?id=$1 [L]
规则解析：
RewriteEngine on: 启用重写引擎。^news/(d+)$: 这是一个正则表达式。^: 匹配URL的开始。news/: 精确匹配字符串 “news/”。(d+): 这是一个捕获组，匹配一个或多个数字（d 代表数字，+ 代表一个或多个）。这个捕获到的数字将被存储在 $1 中。$: 匹配URL的结束。news.php?id=$1: 这是重写后的目标URL。$1 会被正则表达式捕获到的数字替换。[L]: Last 标志。它告诉Apache，如果此规则匹配并执行了重写，则停止处理后续的重写规则。这对于防止重写循环和确保规则按预期顺序执行至关重要。
重要提示： 这条规则必须放在处理无扩展名URL的规则之前。
第三步：处理无扩展名的PHP文件URL
接下来，我们将处理更通用的情况：隐藏PHP文件的 .php 扩展名。例如，将 www.example.com/about.php 显示为 www.example.com/about。
# 处理无扩展名的".php" URLsRewriteCond %{REQUEST_URI} !.w{2,3}$RewriteCond %{DOCUMENT_ROOT}/$1.php -fRewriteRule (.*) $1.php [L]
规则解析：
RewriteCond %{REQUEST_URI} !.w{2,3}$: 这是第一个条件。%{REQUEST_URI}: 获取当前请求的URI（不包含域名）。!.w{2,3}$: 这是一个正则表达式，前面的 ! 表示“不匹配”。它检查URI是否不以一个点号（.）后跟2到3个字母数字字符（w）结尾。这有效地排除了已经带有文件扩展名（如 .css, .js, .png, .php 等）的请求，避免对它们进行不必要的重写。RewriteCond %{DOCUMENT_ROOT}/$1.php -f: 这是第二个条件。%{DOCUMENT_ROOT}: 获取网站的根目录路径。$1.php: $1 是 RewriteRule 中 (.*) 捕获到的内容。这个条件检查在服务器根目录下是否存在一个以 $1 命名并带有 .php 扩展名的实际文件。-f: 测试路径是否是一个常规文件。RewriteRule (.*) $1.php [L]: 这是重写规则。(.*): 捕获整个请求URI（不包含 /）。$1.php: 将捕获到的URI内容加上 .php 扩展名。[L]: Last 标志，停止处理后续规则。
通过这两个 RewriteCond，我们确保只有那些没有扩展名且对应存在 .php 文件的请求才会被重写，从而避免了重写循环。
常见问题与错误诊断：500内部服务器错误
在配置 .htaccess 规则时，一个常见的错误是导致“500 Internal Server Error”。这通常是由于重写循环引起的。
例如，如果将上述规则顺序颠倒，或者缺少关键的 RewriteCond 来限制重写，可能会出现以下情况：假设您请求 /news/45。
您的旧规则 RewriteRule ^(.*)$ $1.php [NC,L] 可能会将 /news/45 重写为 /news/45.php。然后，如果请求再次被处理，它可能又被重写为 /news/45.php.php，如此循环下去，直到达到Apache的重写限制，从而触发500错误。
原始问题中用户尝试的 RewriteRule ^news.php?id=([0-9]+) /news/$1 [NC,L] 实际上不会导致500错误，因为它在语法上是正确的，但逻辑是反向的，它尝试匹配带有查询字符串的URL，而 RewriteRule 的模式匹配的是 REQUEST_URI，不包含查询字符串。因此，这条规则永远不会匹配任何请求，也就不会触发任何重写行为。真正的500错误是由于错误的规则组合导致的重写循环。
正确的规则顺序和条件判断是避免此类错误的关键。首先处理从“美化URL”到“真实URL”的转换，然后处理通用的“无扩展名到有扩展名”的转换，并确保后者不会对已经有扩展名的URL进行操作。
完整的.htaccess配置示例
综合以上所有规则，一个健壮且能处理多种URL美化场景的 .htaccess 文件内容如下：
# 禁用 MultiViews 以确保自定义重写规则的优先级Options -MultiViewsRewriteEngine on# 第一步：将美化URL（如 /news/45）重写回原始带参数格式（news.php?id=45）# 这条规则应放在最前面，因为它处理的是特定模式的漂亮URLRewriteRule ^news/(d+)$ news.php?id=$1 [L]# 第二步：处理无扩展名的PHP文件URL（如 /about 重写为 /about.php）# 确保请求的URI不包含文件扩展名，并且存在对应的.php文件RewriteCond %{REQUEST_URI} !.w{2,3}$RewriteCond %{DOCUMENT_ROOT}/$1.php -fRewriteRule (.*) $1.php [L]
总结
通过精心配置 .htaccess 文件中的 RewriteRule 和 RewriteCond，我们可以有效地隐藏文件扩展名，并将动态查询参数转换为更具语义化的路径。这不仅提升了网站的用户体验，也对搜索引擎优化大有裨益。在实施这些规则时，务必注意规则的顺序和条件判断，特别是要禁用 MultiViews 并使用 RewriteCond 来避免重写循环，从而确保网站的稳定运行。在部署到生产环境之前，务必在开发环境中充分测试所有重写规则。
以上就是深入理解 .htaccess：隐藏PHP扩展名及URL参数重写教程的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1325693.html
微信扫一扫 
支付宝扫一扫 
