引言
在现代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
src/Controllers/UserController.class.php
配置.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，动态加载控制器，并调用相应的方法。
$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()函数用于在实例化和调用前进行检查，增强程序的健壮性，避免“类不存在”或“方法不存在”的致命错误。
