在现代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代码来获取参数：
<?php // index.php echo $_GET['q']; ?>
然而，这种配置经常会导致浏览器显示“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文件内容：
<?php
// index.php
// 安全地获取 'q' 参数，防止未定义索引警告
$q_param = isset($_GET['q']) ? $_GET['q'] : '未指定内容';
// 对输出进行HTML实体编码，防止XSS攻击
$display_param = htmlspecialchars($q_param, ENT_QUOTES, 'UTF-8');
?>
<!DOCTYPE html>
<html lang="en" dir="ltr">
<head>
<meta charset="utf-8">
<title>URL重写示例</title>
<style>
body { font-family: Arial, sans-serif; margin: 40px; }
code { background-color: #f0f0f0; padding: 2px 4px; border-radius: 3px; }
a { color: #007bff; text-decoration: none; }
a:hover { text-decoration: underline; }
</style>
</head>
<body>
<h1>当前路径参数 (`$_GET['q']`):</h1>
<p><code><?php echo $display_param; ?></code></p>
<h2>尝试访问以下URL：</h2>
<ul>
<li><a href="/test-path"><code>https://example.com/test-path</code></a></li>
<li><a href="/another-example-slug"><code>https://example.com/another-example-slug</code></a></li>
<li><a href="/path/with/slashes"><code>https://example.com/path/with/slashes</code></a></li>
</ul>
<p>注意：直接访问 <code>index.php</code> 或其他静态文件（如 <code>style.css</code>）不会被重写。</p>
</body>
</html>将这两个文件放置在您的Web服务器根目录，并确保Apache配置正确。
注意事项
- mod_rewrite模块启用: 确保您的Apache服务器已经启用了mod_rewrite模块。通常，您可以在Apache的配置文件（如httpd.conf或特定站点的配置文件）中找到LoadModule rewrite_module modules/mod_rewrite.so这一行并确保其未被注释。
-
AllowOverride All: 为了让.htaccess文件生效，您需要确保Apache的虚拟主机或目录配置中，AllowOverride指令被设置为All或至少包含FileInfo。例如：
<Directory /var/www/html> Options Indexes FollowSymLinks AllowOverride All Require all granted </Directory> - 缓存问题: 在测试重写规则时，浏览器和服务器可能会缓存旧的重写结果。在修改.htaccess后，建议清除浏览器缓存，并重启Apache服务器（如果条件允许）。
- 更复杂的URL模式: 上述规则适用于URL中不包含点的情况。如果您的URL路径本身就可能包含点（例如/article.v2/），则需要更复杂的正则表达式来区分路径中的点和文件扩展名中的点。在这种情况下，通常会结合RewriteCond来检查文件是否存在。
- 安全性: 在PHP代码中，当从$_GET等超全局变量获取用户输入并将其输出到HTML时，务必使用htmlspecialchars()或类似函数进行编码，以防止跨站脚本（XSS）攻击。
总结
通过本教程，您应该已经掌握了如何使用Apache的mod_rewrite模块将带有?q=参数的URL重写为简洁的路径形式，并理解了常见陷阱的产生原因及解决方案。核心在于使用精确的正则表达式^([^.]*)$来避免重写冲突，并利用[L]标志确保规则的正确执行。理解这些原理将帮助您更有效地管理和美化您的网站URL结构。
