引言
在现代Web开发中，路由系统是构建任何Web应用的基础。它负责将用户请求的URL映射到应用程序中相应的代码逻辑（通常是控制器及其方法）。一个设计良好的路由系统不仅能让URL更具可读性和语义化，还能提高应用程序的模块化和可维护性。本教程旨在帮助您从零开始构建一个简单而实用的PHP路由框架，解决在实现过程中可能遇到的常见问题，例如“未定义变量”错误和文件引用不当。
核心概念
在深入实现之前，了解以下核心概念至关重要：
- URL重写（URL Rewriting）：通过Web服务器（如Apache或Nginx）的配置，将所有请求统一导向一个前端控制器（通常是index.php），从而实现“美观”的URL，隐藏文件扩展名和内部结构。
- $_SERVER超全局变量：PHP提供的一个包含服务器和执行环境信息的数组。其中$_SERVER['REQUEST_URI']包含了当前页面的URI（统一资源标识符），是解析请求路径的关键。
- URL路径解析：将REQUEST_URI分割成控制器名和方法名，以便动态地加载和调用相应的处理逻辑。
- 动态加载与反射：PHP允许在运行时根据字符串变量动态地包含文件、实例化类和调用方法，这是实现灵活路由的核心机制。
- HTTP状态码：用于表示Web服务器对请求的响应状态。例如，200 OK表示成功，404 Not Found表示请求的资源不存在。
环境准备与项目结构
为了更好地组织代码，我们建议采用以下简单的项目结构：
. ├── .htaccess # Apache URL重写配置文件 ├── src/ # 应用程序核心文件目录 │ ├── index.php # 前端控制器，处理所有请求 │ └── Controllers/ # 存放控制器类的目录 │ ├── HomeController.class.php │ └── UserController.class.php └── ... # 其他文件或目录（如视图、模型等）
示例控制器文件
立即学习“PHP免费学习笔记（深入）”；
在src/Controllers/目录下创建以下两个控制器文件：
src/Controllers/HomeController.class.php
<?php
class HomeController
{
public function index()
{
echo '这是主页！';
}
}src/Controllers/UserController.class.php
<?php
class UserController
{
public function login()
{
echo '这是用户登录页面！';
}
}配置.htaccess进行URL重写
在项目根目录创建或编辑.htaccess文件，以确保所有请求都被重写到src/index.php。
.htaccess文件内容
RewriteEngine On
# 排除真实存在的文件和目录，防止它们也被重写
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-l
# 将所有请求重写到 src/index.php
# $1 捕获了原始请求路径，并作为 'url' 参数传递给 index.php
RewriteRule ^(.+)$ src/index.php?url=$1 [QSA,L]
# 设置默认文档为 src/index.php，当访问根目录时使用
DirectoryIndex src/index.php规则解释：
- RewriteEngine On：启用Apache的重写引擎。
- RewriteCond %{REQUEST_FILENAME} !-d：如果请求的不是一个真实存在的目录，则继续执行。
- RewriteCond %{REQUEST_FILENAME} !-f：如果请求的不是一个真实存在的文件，则继续执行。
- RewriteCond %{REQUEST_FILENAME} !-l：如果请求的不是一个真实存在的符号链接，则继续执行。
- RewriteRule ^(.+)$ src/index.php?url=$1 [QSA,L]：这是核心规则。它捕获任何非空路径（.+），并将其作为url参数传递给src/index.php。[QSA]表示追加原始查询字符串，[L]表示这是最后一条规则。
- DirectoryIndex src/index.php：当用户访问根目录（如localhost/）时，默认加载src/index.php。
实现核心路由逻辑 (src/index.php)
src/index.php是整个路由系统的核心。它负责解析URL，动态加载控制器，并调用相应的方法。
<?php
// 1. 获取并解析请求URI
// $_SERVER['REQUEST_URI'] 示例: "/", "/user/login"
$linkExplode = explode("/", $_SERVER['REQUEST_URI']);
// 2. 确定控制器和方法
// 原始问题中的错误：
// if (empty($linkExplode[1] && empty($linkExplode[2]))) { ... }
// 这种写法会导致逻辑判断错误，因为它会先计算 `linkExplode[1] && linkExplode[2]` 的布尔值，
// 然后再判断这个布尔值是否为空。正确的做法是分别检查每个元素。
// 修正后的控制器和方法确定逻辑
// 对于 "/user/login"，$linkExplode 会是 ['','user','login']
// 对于 "/"， $linkExplode 会是 ['','']
$controller = isset($linkExplode[1]) && !empty($linkExplode[1]) ? $linkExplode[1] : "Home";
$method = isset($linkExplode[2]) && !empty($linkExplode[2]) ? $linkExplode[2] : "index";
// 3. 构建控制器文件路径和类名
// 确保控制器文件名和类名遵循一致的命名约定
$controllerFileName = './Controllers/' . ucfirst($controller) . 'Controller.class.php';
$className = ucfirst($controller) . 'Controller';
// 4. 动态加载控制器并调用方法
if (file_exists($controllerFileName)) {
// 使用 require_once 避免重复引入文件
require_once($controllerFileName);
// 检查类是否存在，增加健壮性
if (class_exists($className)) {
$classInstance = new $className();
// 检查方法是否存在于控制器中
if (method_exists($classInstance, $method)) {
$classInstance->$method(); // 调用控制器方法
} else {
// 方法不存在，返回404
http_response_code(404);
echo "404 Not Found: 方法 '$method' 在控制器 '$className' 中不存在。";
die();
}
} else {
// 类文件存在但类名不匹配，通常是命名约定问题
http_response_code(404);
echo "404 Not Found: 类 '$className' 未在文件 '$controllerFileName' 中找到。";
die();
}
} else {
// 控制器文件不存在，返回404
http_response_code(404);
echo "404 Not Found: 控制器 '$controller' 不存在。";
die();
}代码解析与优化：
- URL解析：explode("/", $_SERVER['REQUEST_URI'])将请求URI分割成数组。例如，/user/login会被分割成['', 'user', 'login']。因此，控制器名通常在$linkExplode[1]，方法名在$linkExplode[2]。
- 健壮的变量检查：使用isset($linkExplode[index]) && !empty($linkExplode[index])来安全地获取数组元素。这比单独使用empty()更可靠，可以避免在索引不存在时产生Undefined offset警告。
- 默认路由：当URL路径为空（例如访问localhost/）时，将控制器默认设置为Home，方法默认设置为index，以实现默认页面的访问。
-
动态文件引用：
- ucfirst($controller)确保控制器名首字母大写，符合PHP类名规范。
- './Controllers/' . ucfirst($controller) . 'Controller.class.php'动态构建控制器文件的完整路径。注意： 原始问题中存在将'Homecontroller'或'UserController'硬编码到文件名中的错误，这里已修正为统一的'Controller.class.php'后缀。
- require_once()用于引入控制器文件，_once可以防止在某些复杂场景下文件被重复引入导致类重复定义错误。
-
动态类实例化与方法调用：
- class_exists()和method_exists()函数用于在实例化和调用前进行检查，增强程序的健壮性，避免“类不存在”或“方法不存在”的致命错误。
