如何通过.htaccess实现多控制器带参数的URL重写？

嘿，你已经搞定了基础的URL重写，很不错！要实现支持任意多控制器还能携带参数的URL，咱们只需要调整.htaccess的规则，让它更灵活，同时处理一些边缘场景（比如只访问控制器、静态文件不被干扰等）。

完整的.htaccess配置 #

RewriteEngine On

# 排除静态文件和目录，避免重写CSS/JS/图片等资源
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d

# 规则1：匹配带参数的URL（如 /controller/action/param1/value1/param2/value2）
RewriteRule ^([a-zA-Z0-9_-]+)/([a-zA-Z0-9_-]+)/?(.*)$ index.php?c=$1&a=$2&$3 [QSA,NC,L]

# 规则2：匹配仅含控制器的URL（如 /controller），默认指向index方法
RewriteRule ^([a-zA-Z0-9_-]+)/?$ index.php?c=$1&a=index [NC,L]

规则详解 #

咱们逐个拆解这些配置的作用：

1. 静态资源排除：

   • RewriteCond %{REQUEST_FILENAME} !-f：如果请求的是一个实际存在的文件（比如style.css），不执行重写
   • RewriteCond %{REQUEST_FILENAME} !-d：如果请求的是一个实际存在的目录（比如/images/），不执行重写
     这一步很关键，不然你的静态资源会被当成控制器/方法处理，导致无法加载。

2. 带参数的URL规则：

   • 正则^([a-zA-Z0-9_-]+)/([a-zA-Z0-9_-]+)/?(.*)$：
     • ([a-zA-Z0-9_-]+)：匹配控制器名和方法名，支持大小写字母、数字、下划线和横杠（覆盖大多数命名场景）
     • /?：允许方法名后面有可选的斜杠（比如/user/detail和/user/detail/都能匹配）
     • (.*)：捕获方法名后面的所有参数部分（比如param1/value1/param2/value2）
   • 标志说明：
     • QSA：Query String Append，保留原URL的查询字符串（比如/user/detail?id=1会被重写为index.php?c=user&a=detail&id=1）
     • NC：不区分大小写，兼容不同大小写的URL访问
     • L：Last，匹配到该规则后停止后续规则处理，避免冲突

3. 仅控制器的URL规则：

   • 当用户访问/user时，会自动映射到index.php?c=user&a=index，也就是默认调用控制器的index方法，符合常见的MVC习惯。

PHP中处理路径参数 #

上面的规则会把路径里的参数（比如param1/value1）传到index.php的空键参数里，咱们需要在PHP里把它解析成键值对：

// 获取控制器和方法，设置默认值防止报错
$controller = $_GET['c'] ?? 'Home';
$action = $_GET['a'] ?? 'index';

// 解析路径参数
$paramString = $_GET[''] ?? '';
$paramPairs = [];
if (!empty($paramString)) {
    $params = explode('/', trim($paramString, '/'));
    // 把数组按「键-值」分组
    for ($i = 0; $i < count($params); $i += 2) {
        if (isset($params[$i+1])) {
            $paramPairs[$params[$i]] = $params[$i+1];
        }
    }
    // 合并到$_GET，方便后续使用
    $_GET = array_merge($_GET, $paramPairs);
    unset($_GET['']); // 移除空键的无用参数
}

// 后续的控制器实例化、方法调用逻辑...

这样配置后，你就可以轻松支持任意多个控制器，同时兼容路径风格和查询字符串风格的参数了。如果需要支持更复杂的场景（比如嵌套控制器），只需要调整正则表达式的分组即可。

内容的提问来源于stack exchange，提问作者Lukasz Formela