使用mod_rewrite实现PHP文件扩展名隐藏与优雅URL重写

本教程详细介绍了如何利用apache的`mod_rewrite`模块在`.htaccess`文件中配置url重写规则，以实现php文件扩展名（如`.php`）的隐藏，并将查询字符串参数（如`?id=45`）转换为更友好的路径段（如`/45`）。文章将提供完整的配置示例，并深入解析规则逻辑，同时强调避免常见的重写循环错误和正确处理`multiviews`选项，帮助开发者构建更简洁、更具seo友好性的网站url结构。

理解URL重写与干净URL的重要性

在Web开发中，为了提升用户体验、增强网站的SEO表现以及提供更清晰的URL结构，我们常常需要对URL进行重写。例如，将带有.php扩展名的文件（如www.example.com/about.php）显示为不带扩展名的形式（www.example.com/about），或者将带有查询字符串参数的URL（如example.com/news.php?id=45）转换为路径段形式（example.com/news/45）。Apache服务器通过mod_rewrite模块和.htaccess文件提供了强大的URL重写功能。

基础：隐藏PHP文件扩展名

首先，我们来实现最基础的功能：隐藏.php文件扩展名。这意味着当用户访问www.example.com/about时，服务器实际上会处理www.example.com/about.php。

以下是实现此功能的.htaccess规则：

RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME}\.php -f
RewriteRule ^(.*)$ $1.php [NC,L] 

规则解析：

立即学习“PHP免费学习笔记（深入）”；

• RewriteEngine on：启用Apache的重写引擎。
• RewriteCond %{REQUEST_FILENAME} !-d：这是一个条件指令。它检查当前请求的文件名（%{REQUEST_FILENAME}）是否不是一个目录（!-d）。如果请求的是一个目录，则不应用后续的重写规则。
• RewriteCond %{REQUEST_FILENAME}\.php -f：这是第二个条件指令。它检查在当前请求的文件名后面加上.php扩展名后，该文件是否存在于服务器文件系统中（-f）。
• RewriteRule ^(.*)$ $1.php [NC,L]：这是重写规则本身。
  • ^(.*)$：匹配任何请求路径。$1捕获了整个路径。
  • $1.php：将匹配到的路径后面加上.php扩展名，作为实际处理的文件。
  • [NC,L]：是标志位。
    • NC (No Case)：表示不区分大小写匹配。
    • L (Last)：表示如果此规则匹配并执行，则停止处理后续的重写规则。

这条规则的组合确保了只有当请求的路径不是目录，并且其对应的.php文件确实存在时，才会进行内部重写。

进阶：将查询参数重写为路径段

在隐藏.php扩展名的基础上，我们希望进一步优化URL，将example.com/news.php?id=45这样的URL显示为example.com/news/45。这需要引入一个新的重写规则，并且需要注意规则的顺序和潜在的冲突。

常见的错误和500内部服务器错误分析：

许多开发者可能会尝试类似RewriteRule ^news.php?id=([0-9]+) /news/$1 [NC,L]这样的规则。然而，这种规则是无效的，因为它尝试在RewriteRule的匹配模式中直接匹配查询字符串（?id=([0-9]+)）。RewriteRule的第一个参数只匹配URL的路径部分，不包括查询字符串。查询字符串需要通过RewriteCond结合%{QUERY_STRING}变量来处理。

此外，更重要的是，当结合之前的扩展名隐藏规则时，如果请求/news/45，原始规则可能会导致重写循环：

1. 用户请求 /news/45。
2. 扩展名隐藏规则匹配，尝试将 /news/45 重写为 /news/45.php。
3. 如果 /news/45.php 存在，则处理 /news/45.php。
4. 但如果 /news/45.php 再次被视为一个没有扩展名的请求，它又会被重写为 /news/45.php.php，如此循环下去，最终导致服务器达到重写限制并返回500内部服务器错误。

为了避免这种重写循环，并正确实现查询参数到路径段的转换，我们需要更精细的控制和规则顺序。

完整的.htaccess配置示例

以下是推荐的完整.htaccess配置，能够同时实现扩展名隐藏和查询参数重写，并避免常见的错误：

火龙果写作

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

106

查看详情

# 必须禁用MultiViews，否则 "/news/45" 可能无法正常工作
Options -MultiViews

RewriteEngine on

# 规则1: 将 "/news/45" 这样的请求内部重写为 "news.php?id=45"
# 这是外部URL到内部实际处理URL的映射
RewriteRule ^news/(\d+)$ news.php?id=$1 [L]

# 规则2: 处理无扩展名的 ".php" URL
# 确保请求的URI不包含文件扩展名（避免循环）
RewriteCond %{REQUEST_URI} !\.\w{2,3}$
# 检查对应的 .php 文件是否存在
RewriteCond %{DOCUMENT_ROOT}/$1.php -f
# 将无扩展名的请求内部重写为带有 .php 扩展名的文件
RewriteRule (.*) $1.php [L]

规则解析与注意事项：

1. Options -MultiViews：

   • 这是至关重要的一步。MultiViews是Apache的一个选项，当启用时，如果请求一个不存在的文件名（例如/news/45），Apache会自动尝试查找同名但带有不同扩展名的文件（例如/news/45.php）。
   • 在我们的场景中，我们希望精确控制重写行为，而不是让Apache自动猜测。如果MultiViews启用，当请求/news/45时，Apache可能会在我们的RewriteRule之前或之后尝试找到/news/45.php，这可能导致意外的行为或冲突。因此，禁用MultiViews可以确保我们的RewriteRule能按预期工作。

2. RewriteEngine on：启用重写引擎。

3. 规则1：将 /news/45 重写为 news.php?id=45

   • RewriteRule ^news/(\d+)$ news.php?id=$1 [L]
   • ^news/(\d+)$：匹配以/news/开头，后面跟着一个或多个数字（\d+）的URL路径。(\d+)是一个捕获组，捕获到的数字将作为$1使用。
   • news.php?id=$1：将匹配到的路径重写为news.php?id=加上捕获到的数字。
   • [L] (Last)：表示这是最后一条规则，如果匹配成功，则停止处理后续规则。这条规则的目的是将用户友好的URL（如/news/45）内部映射到服务器实际处理的脚本和参数（news.php?id=45）。

4. 规则2：处理无扩展名的 .php URL

   • 这条规则与我们最初实现扩展名隐藏的规则类似，但经过了优化，以避免与规则1冲突，并防止重写循环。
   • RewriteCond %{REQUEST_URI} !\.\w{2,3}$：
     • 这是一个关键的条件。%{REQUEST_URI}是当前请求的完整URI路径（不包含域名和查询字符串）。
     • !\.\w{2,3}$：匹配不以点号（.）开头，后面跟着2到3个字母数字字符（\w{2,3}），再以行尾（$）结束的字符串。简而言之，它检查请求的URI是否不包含常见的文件扩展名（如.php, .html, .css, .js等）。这个条件是为了确保我们只对那些“看起来”没有扩展名的URL进行处理，从而避免将/news/45.php再次重写为/news/45.php.php。
   • RewriteCond %{DOCUMENT_ROOT}/$1.php -f：
     • 这与之前的条件相同，检查在服务器根目录（%{DOCUMENT_ROOT}）下，请求路径加上.php扩展名后，对应的文件是否存在。$1在这里指的是RewriteRule的第一个参数捕获的内容。
   • RewriteRule (.*) $1.php [L]：
     • 如果上述两个条件都满足，则将请求的任何路径（(.*)）内部重写为$1.php。$1捕获了整个请求路径。
     • [L]：同样表示如果此规则匹配并执行，则停止处理后续重写规则。

规则顺序的重要性：

在这个配置中，将“将查询参数重写为路径段”的规则（规则1）放在“处理无扩展名.php URL”的规则（规则2）之前是至关重要的。

• 如果规则1匹配，例如用户请求/news/45，它会被立即重写为news.php?id=45并停止处理。
• 如果规则1不匹配（例如用户请求/about），那么规则2会继续检查。规则2的第一个条件%{REQUEST_URI} !\.\w{2,3}$会检查/about是否没有扩展名（是），然后检查about.php是否存在（如果存在），最后将其重写为about.php。

这种顺序确保了特定模式（如/news/45）优先被处理，而更通用的无扩展名规则则作为后备。

总结

通过精心设计的mod_rewrite规则，我们可以实现灵活且强大的URL重写功能，从而提供更干净、更易于管理的网站URL。关键在于理解每个指令的作用、条件语句的逻辑，以及规则之间的交互和执行顺序。始终记得在配置URL重写时：

• 禁用MultiViews：以确保重写规则按预期工作。
• 避免重写循环：通过精确的条件判断和规则顺序来防止500错误。
• 测试与调试：在部署到生产环境之前，务必在开发环境中充分测试所有重写规则，并检查Apache的错误日志（error.log）以发现潜在问题。

遵循这些最佳实践，您将能够为您的Web应用程序构建一个优雅且高效的URL结构。

以上就是使用mod_rewrite实现PHP文件扩展名隐藏与优雅URL重写的详细内容，更多请关注php中文网其它相关文章！