深入理解 .htaccess：隐藏PHP扩展名及URL参数重写教程

本教程详细阐述如何利用 `.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。

火龙果写作

用火龙果，轻松写作，通过校对、改写、扩展等功能实现高质量内容生产。

106

查看详情

# 处理无扩展名的".php" URLs
RewriteCond %{REQUEST_URI} !\.\w{2,3}$
RewriteCond %{DOCUMENT_ROOT}/$1.php -f
RewriteRule (.*) $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。

1. 您的旧规则 RewriteRule ^(.*)$ $1.php [NC,L] 可能会将 /news/45 重写为 /news/45.php。
2. 然后，如果请求再次被处理，它可能又被重写为 /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 -MultiViews

RewriteEngine on

# 第一步：将美化URL（如 /news/45）重写回原始带参数格式（news.php?id=45）
# 这条规则应放在最前面，因为它处理的是特定模式的漂亮URL
RewriteRule ^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 -f
RewriteRule (.*) $1.php [L]

总结

通过精心配置 .htaccess 文件中的 RewriteRule 和 RewriteCond，我们可以有效地隐藏文件扩展名，并将动态查询参数转换为更具语义化的路径。这不仅提升了网站的用户体验，也对搜索引擎优化大有裨益。在实施这些规则时，务必注意规则的顺序和条件判断，特别是要禁用 MultiViews 并使用 RewriteCond 来避免重写循环，从而确保网站的稳定运行。在部署到生产环境之前，务必在开发环境中充分测试所有重写规则。

以上就是深入理解 .htaccess：隐藏PHP扩展名及URL参数重写教程的详细内容，更多请关注php中文网其它相关文章！