理解URL重写与mod_rewrite
URL重写是Web服务器的一项强大功能，它允许我们将复杂的、动态的URL转换为更易读、更利于搜索引擎优化的静态外观URL，同时保持后端处理逻辑不变。Apache服务器通过mod_rewrite模块提供这一能力，通常通过网站根目录下的.htaccess文件进行配置。
我们的目标是将形如 https://example.com/?q=something 的URL在浏览器地址栏显示为 https://example.com/something，但服务器内部实际处理的仍然是 index.php?q=something。
常见错误与问题分析
许多初学者在尝试实现此类重写时，可能会遇到一个常见的问题：当使用类似 RewriteRule ^(.*) index\.php?q=$1 的规则时，最终浏览器显示或内部处理的URL可能会变成 index.php，而不是预期的 /something。
为什么会这样？
问题出在 ^(.*) 这个过于宽泛的正则表达式上。在 .htaccess 文件（即目录上下文）中，mod_rewrite 引擎可能会对请求进行多次处理。当一个请求（例如 /something）被成功重写为 index.php?q=something 后，mod_rewrite 引擎可能会在内部进行“二次重写”。此时，index.php 本身也会被 ^(.*) 匹配到，导致 index.php 被再次重写为 index.php?q=index.php。这不仅会导致显示错误，也可能造成不必要的循环或性能问题。
解决方案：精确匹配与避免循环
为了解决上述问题，我们需要一个更精确的正则表达式，它能够匹配期望的URL路径，同时避免匹配到 index.php 或其他静态资源文件（如CSS、JS、图片等）。
一个有效的解决方案是排除包含点号（.）的路径，因为大多数文件扩展名都包含点号。
核心 RewriteRule：
RewriteEngine On RewriteRule ^([^.]*)$ index.php?q=$1 [L]
让我们分解这条规则：
- RewriteEngine On: 启用Apache的重写引擎。这是任何重写规则生效的前提。
- ^([^.]*)$: 这是正则表达式部分，用于匹配请求的URL路径。
- ^: 匹配字符串的开始。
- ([^.]*): 这是一个捕获组。
- [^.]: 匹配除了点号（.）之外的任何字符。
- *: 匹配前一个字符零次或多次。
- $: 匹配字符串的结束。
- 结合起来，^([^.]*)$ 意味着它会匹配整个字符串，只要字符串中不包含点号。这巧妙地排除了 index.php、style.css、image.jpg 等带有文件扩展名的路径。
- index.php?q=$1: 这是替换字符串。
- index.php?q=: 这是目标PHP脚本及其参数名。
- $1: 引用正则表达式中第一个捕获组（即 ([^.]*)）匹配到的内容。如果请求是 /something，那么 $1 就是 something。
- 注意：在替换字符串中，点号（.）不需要进行转义，因为它不被视为正则表达式的一部分。
- [L]: 这是一个标志（flag），表示“Last”。它的作用是告诉mod_rewrite引擎，如果这条规则被匹配并执行了重写，那么就停止处理后续的重写规则。这对于避免不必要的重写循环至关重要，特别是当存在多条重写规则时。
完整的 .htaccess 配置示例
# 确保mod_rewrite模块已启用
<IfModule mod_rewrite.c>
RewriteEngine On
# 如果请求的是一个实际存在的文件或目录，则跳过重写
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# 将不含点号的URL路径重写到index.php?q=参数
# 例如：/something -> index.php?q=something
RewriteRule ^([^.]*)$ index.php?q=$1 [L]
</IfModule>RewriteCond 的作用：
- RewriteCond %{REQUEST_FILENAME} !-f: 这条条件规则表示，如果请求的文件名（%{REQUEST_FILENAME}）不是一个真实存在的文件（!-f），则继续执行下一条规则。
- RewriteCond %{REQUEST_FILENAME} !-d: 这条条件规则表示，如果请求的文件名不是一个真实存在的目录（!-d），则继续执行下一条规则。
这两条 RewriteCond 的目的是防止将对实际文件（如CSS、JS、图片等）或目录的请求重写到 index.php，确保静态资源能够被正常访问。
对应的 PHP 代码示例
为了接收重写后的参数，index.php 文件需要通过 $_GET['q'] 来获取数据。
<!DOCTYPE html>
<html lang="en" dir="ltr">
<head>
<meta charset="utf-8">
<title>动态内容展示</title>
</head>
<body>
<?php
if (isset($_GET['q'])) {
echo "您请求的内容是： " . htmlspecialchars($_GET['q']);
} else {
echo "未指定内容。";
}
?>
</body>
</html>当用户访问 https://example.com/something 时，服务器内部会处理 index.php?q=something，PHP脚本将输出 "您请求的内容是： something"。
注意事项与最佳实践
- 服务器环境： 确保您的Apache服务器已启用 mod_rewrite 模块，并且允许在 .htaccess 文件中使用 AllowOverride All。
- 规则顺序： 在 .htaccess 文件中，规则的顺序很重要。通常，更具体的规则应放在更通用的规则之前。
- 缓存问题： 在测试重写规则时，浏览器和服务器的缓存都可能导致旧的配置生效。请务必清除浏览器缓存，并在必要时重启Apache服务器（尽管.htaccess修改通常无需重启）。
- 调试： 如果重写不生效，可以尝试在Apache的错误日志中查找相关信息，或者在 RewriteRule 后面添加 [R=301,L]（临时重定向）来观察重写后的URL是否符合预期，调试完成后再移除 R=301。
- 安全性： 在处理用户输入时（如$_GET['q']），务必进行适当的验证和过滤（例如使用 htmlspecialchars() 或 strip_tags()），以防止跨站脚本攻击（XSS）等安全漏洞。
- URL结构： 本教程的规则适用于将 /something 这样的路径重写到 index.php?q=something。如果您的URL结构更复杂（例如 /category/item），则需要更复杂的正则表达式。
总结
通过本文的讲解，您应该已经掌握了如何使用 .htaccess 和 mod_rewrite 来实现简洁的URL重写，将带有 ?q= 参数的动态URL转换为更友好的静态外观URL。关键在于使用精确的正则表达式 ^([^.]*)$ 来避免重写循环，并结合 [L] 标志确保规则的正确执行。理解这些核心概念将帮助您构建更优雅、更高效的Web应用程序。
