构建友好URL：使用.htaccess与PHP实现动态路由-php教程-PHP中文网

构建友好URL：使用.htaccess与PHP实现动态路由

本文详解如何通过Apache的.htaccess重写规则与PHP前端控制器协同工作，将形如 /link-one 的简洁URL映射到动态内容页面，避免文件路径硬编码，提升SEO与可维护性。核心在于分离URL语义与物理文件结构，并安全传递路由参数。

本文详解如何通过apache的.htaccess重写规则与php前端控制器协同工作，将形如 `/link-one` 的简洁url映射到动态内容页面，避免文件路径硬编码，提升seo与可维护性。核心在于分离url语义与物理文件结构，并安全传递路由参数。

在现代PHP项目中，直接暴露 ?page_slug=xxx 这类查询参数的URL不仅不利于搜索引擎收录，也降低了用户可读性与分享意愿。真正的“友好URL”（Friendly URL）应表现为语义清晰、层级明确的路径结构，例如 /products/iphone-15 或 /blog/introduction-to-routing。要实现这一目标，需结合服务器端URL重写与PHP路由逻辑——二者缺一不可。

一、正确配置 .htaccess 实现请求拦截

您当前的 .htaccess 规则存在两个关键问题：

RewriteRule ^(.*)$ index.php 缺少 [L] 标志，可能导致后续规则被意外触发；
未启用 QSA（Query String Append），导致原始URL中的查询参数（如 /about?ref=source）丢失；
未排除真实存在的静态资源（如CSS、JS、图片），可能造成误重写。

推荐使用以下健壮配置（置于网站根目录）：

# .htaccess
RewriteEngine On
RewriteBase /

# 排除真实存在的文件和目录（如 /css/style.css, /images/logo.png）
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d

# 将所有非静态请求重写至 index.php，并保留原始查询字符串
RewriteRule ^ index.php [QSA,L]

✅ 说明：[QSA] 确保 /contact?utm_medium=email 中的 utm_medium 参数仍可通过 $_GET 访问；[L] 表示“最后一条规则”，防止冲突；RewriteBase / 适配根目录部署（若部署在子目录如 /myapp/，请改为 RewriteBase /myapp/）。

二、在 index.php 中安全解析并分发路由

原始代码中直接 require '/views/page.php?page_slug=link-one' 是错误的——PHP require 语句不支持带查询字符串的路径，该写法会被解释为文件名的一部分，必然报错。

Accessibility Review

对设计或页面进行 WCAG 2.1 AA 无障碍审计。触发关键词：“audit accessibility”、 “check a11y”、 “is this accessible?” 或在审查设计时使用。

下载

正确做法是：提取纯净路径 → 映射逻辑 → 注入参数 → 包含脚本。以下是优化后的 index.php 示例：

<?php // index.php —— 前端控制器（Front Controller）

// 1. 解析请求路径（去除查询参数，仅保留路径部分）
$path = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);

// 2. 清理路径：移除开头斜杠并标准化（可选）
$path = trim($path, '/');

// 3. 定义路由映射表（生产环境建议从配置文件或数据库加载）
$routes = [
    ''          => ['controller' => 'index', 'params' => []],
    'link-one'  => ['controller' => 'page',  'params' => ['page_slug' => 'link-one']],
    'link-two'  => ['controller' => 'page',  'params' => ['page_slug' => 'link-two']],
    'about'     => ['controller' => 'page',  'params' => ['page_slug' => 'about']],
];

// 4. 匹配路由并执行
if (isset($routes[$path])) {
    $route = $routes[$path];

    // 动态注入 GET 参数（使 page.php 能像正常接收 ?page_slug=xxx 一样工作）
    $_GET = array_merge($_GET, $route['params']);

    // 加载对应视图/控制器
    $viewFile = __DIR__ . '/views/' . $route['controller'] . '.php';
    if (file_exists($viewFile)) {
        require $viewFile;
    } else {
        http_response_code(404);
        echo "404: View file not found — {$viewFile}";
    }
} else {
    http_response_code(404);
    require __DIR__ . '/views/404.php';
}

⚠️ 重要注意事项：

parse_url(..., PHP_URL_PATH) 是获取路径的唯一可靠方式，避免手动字符串分割带来的安全隐患；

不要将用户输入（如 $path）直接拼接进 require，必须严格校验或白名单匹配，防止路径遍历攻击（如 ../../../etc/passwd）；

生产环境中，路由表应从配置文件（JSON/YAML）或数据库读取，支持热更新与管理后台；

若需支持动态 slug（如 /article/{slug}），应在 $routes 中使用正则匹配（见下文扩展）。

三、进阶：支持正则动态路由（可选）

当页面数量庞大时，硬编码路由不现实。可引入简单正则匹配：

// 在路由匹配逻辑中追加：
foreach ($routes as $pattern => $config) {
    if (is_string($pattern) && preg_match('#^' . $pattern . '$#', $path, $matches)) {
        // 移除匹配组0（完整匹配），只保留捕获组
        array_shift($matches);
        $_GET = array_merge($_GET, $config['params'] ?? [], $matches);
        $viewFile = __DIR__ . '/views/' . $config['controller'] . '.php';
        if (file_exists($viewFile)) require $viewFile;
        exit;
    }
}
// 示例路由：'article/([a-z0-9\-]+)' => ['controller' => 'article', 'params' => []]