在现代Web开发中，为了提升用户体验和搜索引擎优化（SEO），URL美化是不可或缺的一环。Apache的mod_rewrite模块通过.htaccess文件提供了强大的URL重写能力，允许我们将动态参数化的URL（如https://example.com/?q=something）转换为更具语义化的路径（如https://example.com/something）。然而，在实践中，开发者常会遇到一些陷阱，导致重写规则未能按预期工作。

理解常见重写规则的陷阱

许多初学者在尝试将/?q=something重写为/something时，可能会尝试使用如下的.htaccess规则：

RewriteEngine On
RewriteRule ^(.*) index\.php?q=$1

并配合如下的index.php代码来获取参数：

然而，这种配置经常会导致浏览器显示“index.php”而不是预期的内容。这是因为RewriteRule ^(.*) index\.php?q=$1中的正则表达式^(.*)过于宽泛。在Apache的.htaccess文件（即目录上下文）中，mod_rewrite引擎可能会对请求进行多次处理。

当一个请求，例如/something，到达服务器时，它首先会被RewriteRule ^(.*) index\.php?q=$1匹配并重写为index.php?q=something。此时，重写引擎可能不会立即停止，而是会再次处理这个内部重写后的URL。由于index.php本身也符合^(.*)这个模式，重写引擎会再次将其匹配，并尝试重写为index.php?q=index.php。最终，$_GET['q']获取到的值就变成了index.php，从而导致显示错误。

优化重写规则：避免匹配文件路径

为了解决上述问题，我们需要一个更精确的正则表达式，以避免匹配到实际的文件名（如index.php）或静态资源（如.css, .js, .jpg等）。一个有效的解决方案是排除包含点（.）的路径，因为文件名通常都包含点。

以下是优化后的.htaccess重写规则：

RewriteEngine On
RewriteBase /
RewriteRule ^([^.]*)$ index.php?q=$1 [L]

我们来详细解析这条规则：

• RewriteEngine On: 启用Apache的重写引擎。
• RewriteBase /: 定义重写规则的基础URL。这在您的.htaccess文件位于网站根目录时通常是/。如果您的网站部署在子目录中（例如https://example.com/myapp/），则应设置为/myapp/。
• *`RewriteRule ^([^.])$ index.php?q=$1 [L]`**: 这是核心重写规则。
  • ^: 匹配URL路径的开始。
  • *`([^.])`**: 这是关键部分。
    • [: 字符类的开始。
    • ^.: 匹配除了点（.）之外的任何字符。
    • *: 匹配前一个字符（即非点字符）零次或多次。
    • ): 捕获组的结束。这个捕获组会将匹配到的内容存储在$1中。
  • $: 匹配URL路径的结束。
  • index.php?q=$1: 这是替换字符串。它将匹配到的内容（通过$1引用）作为q参数的值传递给index.php。
  • [L]: Last标志。它告诉mod_rewrite这是最后一条规则，如果此规则匹配成功，则停止处理后续的重写规则。这对于避免无限循环和确保规则按预期执行至关重要。

通过^([^.]*)$这个正则表达式，我们确保只有不包含点且匹配整个路径的URL才会被重写。这意味着像/something这样的URL会被匹配，而index.php、style.css或image.jpg等文件路径则不会被匹配，从而避免了重写冲突和无限循环。

完整示例代码

.htaccess文件内容：

# 启用重写引擎
RewriteEngine On

# 设置重写基础路径，如果.htaccess在网站根目录，通常是 /
RewriteBase /

# 如果请求的文件或目录存在，则跳过重写规则
# 这可以防止重写实际存在的文件和目录，例如CSS、JS文件或图片
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d

# 重写规则：将不含点的路径重写到index.php，并传递参数
# 例如：/test-path 会被重写为 index.php?q=test-path
RewriteRule ^([^.]*)$ index.php?q=$1 [L]

index.php文件内容：

    
    
    


    
当前路径参数 (`$_GET['q']`):
    


    
尝试访问以下URL：
    

        
https://example.com/test-path
        
https://example.com/another-example-slug
        
https://example.com/path/with/slashes
    
    
注意：直接访问 index.php 或其他静态文件（如 style.css）不会被重写。

将这两个文件放置在您的Web服务器根目录，并确保Apache配置正确。

注意事项

1. mod_rewrite模块启用: 确保您的Apache服务器已经启用了mod_rewrite模块。通常，您可以在Apache的配置文件（如httpd.conf或特定站点的配置文件）中找到LoadModule rewrite_module modules/mod_rewrite.so这一行并确保其未被注释。
2. AllowOverride All: 为了让.htaccess文件生效，您需要确保Apache的虚拟主机或目录配置中，AllowOverride指令被设置为All或至少包含FileInfo。例如：

   
       Options Indexes FollowSymLinks
       AllowOverride All
       Require all granted
   

3. 缓存问题: 在测试重写规则时，浏览器和服务器可能会缓存旧的重写结果。在修改.htaccess后，建议清除浏览器缓存，并重启Apache服务器（如果条件允许）。
4. 更复杂的URL模式: 上述规则适用于URL中不包含点的情况。如果您的URL路径本身就可能包含点（例如/article.v2/），则需要更复杂的正则表达式来区分路径中的点和文件扩展名中的点。在这种情况下，通常会结合RewriteCond来检查文件是否存在。
5. 安全性: 在PHP代码中，当从$_GET等超全局变量获取用户输入并将其输出到HTML时，务必使用htmlspecialchars()或类似函数进行编码，以防止跨站脚本（XSS）攻击。

总结

通过本教程，您应该已经掌握了如何使用Apache的mod_rewrite模块将带有?q=参数的URL重写为简洁的路径形式，并理解了常见陷阱的产生原因及解决方案。核心在于使用精确的正则表达式^([^.]*)$来避免重写冲突，并利用[L]标志确保规则的正确执行。理解这些原理将帮助您更有效地管理和美化您的网站URL结构。