本文详解如何通过Apache的.htaccess重写规则与PHP统一入口文件协同工作，将形如 /link-one 的简洁URL映射到数据库驱动的内容页面，避免硬编码路径、提升SEO与可维护性。
本文详解如何通过apache的.htaccess重写规则与php统一入口文件协同工作，将形如 `/link-one` 的简洁url映射到数据库驱动的内容页面，避免硬编码路径、提升seo与可维护性。
在现代PHP动态网站开发中，“伪静态”或“友好URL”（如 /about、/blog/my-first-post）已不仅是美观需求，更是SEO优化与架构可维护性的关键基础。其核心逻辑在于：所有请求先经由服务器重写规则统一导向单一入口文件（如 index.php），再由PHP解析路径、提取语义化标识符（slug），最终动态加载对应内容。本文将手把手带你完成这一流程，解决你遇到的 404 错误与参数传递失效问题。
✅ 正确配置 .htaccess：确保重写生效且安全
你原始的 .htaccess 规则存在两个关键缺陷：
- 缺少 [L]（Last）标志 → 可能触发后续规则冲突或无限循环；
- 缺少 [QSA]（Query String Append）→ 丢失原始查询参数（如 ?ref=source）；
- 未排除真实静态资源（CSS/JS/图片）→ 可能错误重写 /style.css 导致 404。
请将根目录下的 .htaccess 替换为以下健壮版本：
<ifmodule mod_rewrite.c>
RewriteEngine On
RewriteBase /
# 排除真实存在的文件（如 .css, .js, .png）
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]
# 兜底：所有其他请求交由 index.php 处理，并保留原始查询参数
RewriteRule ^ index.php [QSA,L]
</ifmodule>
⚠️ 重要前提检查（缺一不可）：
- Apache 已启用 mod_rewrite 模块（Ubuntu/Debian 执行 sudo a2enmod rewrite）；
- 虚拟主机配置中对应目录的 AllowOverride 必须设为 All（而非 None 或 FileInfo）；
- .htaccess 文件名严格为 .htaccess（Windows 记事本保存时需用英文引号包裹：".htaccess"）。
✅ 重构 index.php：安全解析路径 + 动态注入参数
你原代码中 require '/views/page.php?page_slug=link-one' 是语法错误：PHP 的 require 只能加载文件，无法传递 HTTP 查询参数。正确做法是——在包含前手动设置 $_GET 全局变量，使被包含脚本（如 page.php）如同直接访问 ?page_slug=link-one 一样正常运行。
以下是推荐的 index.php 实现（支持扩展、清晰易读）：
<?php // 1. 安全解析请求路径（去除查询字符串）
$path = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
// 2. 标准化路径：移除末尾斜杠，统一格式
$path = rtrim($path, '/');
// 3. 定义路由映射表（生产环境建议从数据库或配置文件加载）
$routes = [
'/' => ['controller' => 'index', 'params' => []],
'/link-one' => ['controller' => 'page', 'params' => ['page_slug' => 'link-one']],
'/link-two' => ['controller' => 'page', 'params' => ['page_slug' => 'link-two']],
// 可扩展更多路由...
];
// 4. 匹配路由并执行
if (array_key_exists($path, $routes)) {
$route = $routes[$path];
// 注入 GET 参数（模拟真实查询）
$_GET = array_merge($_GET, $route['params']);
// 加载对应视图/控制器
$viewFile = __DIR__ . '/views/' . $route['controller'] . '.php';
if (file_exists($viewFile)) {
require $viewFile;
} else {
http_response_code(404);
echo "页面未找到：{$viewFile}";
}
} else {
http_response_code(404);
require __DIR__ . '/views/404.php';
}
? 为什么用 parse_url(..., PHP_URL_PATH)？
直接读取 $_SERVER['REQUEST_URI'] 可能包含查询字符串（如 /link-one?utm=abc），而路由匹配应仅基于路径部分。parse_url() 确保精准提取 /link-one，避免误判。
✅ 进阶建议：迈向可扩展的动态路由
当前方案适用于少量固定页面。若需支持任意 slug（如 /products/*、/blog/*），推荐升级为正则匹配式路由：
// 示例：动态捕获 /article/{slug} 路径
$uri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
if (preg_match('#^/article/([^/]+)$#', $uri, $matches)) {
$_GET['page_slug'] = $matches[1];
require __DIR__ . '/views/page.php';
exit;
}
同时，page.php 应改为从 $_GET['page_slug'] 查询数据库：
<?php // views/page.php
$slug = $_GET['page_slug'] ?? '';
if (empty($slug)) {
http_response_code(400);
die('缺少页面标识符');
}
// ✅ 安全查询（务必使用 PDO 预处理防止 SQL 注入）
$stmt = $pdo->prepare("SELECT * FROM pages WHERE slug = ?");
$stmt->execute([$slug]);
$page = $stmt->fetch(PDO::FETCH_ASSOC);
if (!$page) {
http_response_code(404);
require __DIR__ . '/404.php';
exit;
}
// 渲染页面
echo "<h1>{$page['title']}</h1>";
echo "<p>{$page['content']}</p>";
? 总结：关键原则与避坑指南
- URL重写 ≠ PHP逻辑：.htaccess 只负责“转发”，PHP 才负责“解析与响应”；
- 永远不要在 require 中拼接查询参数：改用 $_GET 注入；
- 路径解析必须剥离查询字符串：parse_url(..., PHP_URL_PATH) 是黄金标准；
- 静态资源优先放行：.htaccess 中显式跳过真实文件/目录，避免 404；
-
生产环境禁用 .htaccess：Nginx 或 Apache 主配置更高效；Apache 下应设 AllowOverride None 并将规则移至
块内。
遵循以上实践，你将获得一个轻量、可靠、可扩展的动态路由基础——它既是个人项目的快速启动器，也是通向 Laravel、Symfony 等成熟框架的坚实台阶。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
