PHP无内置路由,但可用几行代码实现基础URL路由分发;核心是将请求路径映射到处理函数,步骤为获取路径、匹配规则、执行逻辑,并支持静态与正则路径及参数传递。

PHP本身没有内置的路由系统,但用几行代码就能实现基础的URL路由分发,适合小型项目或学习原理。
理解路由的核心逻辑
路由本质是把用户请求的URL路径,映射到对应的处理函数或控制器方法。关键步骤就三步:获取当前请求路径、匹配预定义规则、执行对应逻辑。
PHP中常用 $_SERVER['REQUEST_URI'] 获取原始路径(含查询参数),用 parse_url() 提取干净的路径部分即可开始匹配。
手写一个支持GET路由的简易路由器
以下是一个无依赖、可直接运行的示例:
立即学习“PHP免费学习笔记(深入)”;
回调函数
$routes = [
'/' => fn() => echo '首页',
'/about' => fn() => echo '关于页面',
'/user/(\d+)' => fn($id) => echo "用户ID:$id",
];
// 获取当前请求路径(去除查询参数)
$path = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
// 遍历路由表,尝试正则匹配
foreach ($routes as $pattern => $handler) {
if (preg_match('#^' . $pattern . '$#', $path, $matches)) {
array_shift($matches); // 去掉完整匹配项
call_user_func($handler, ...$matches);
exit;
}
}
echo '404 - 页面未找到';
?>
说明:
- 支持静态路径(如 /about)和带参数的正则路径(如 /user/(\d+))
- $matches 中捕获的参数会自动传给回调函数
- 匹配成功即 exit,避免后续路由干扰
扩展建议:加一层请求方法判断
真实项目中需区分 GET、POST 等方法。可在路由定义中加入方法字段:
$routes = [
['GET', '/', fn() => echo '首页'],
['POST', '/login', fn() => echo '处理登录'],
];
// 匹配时加条件:$method === $_SERVER['REQUEST_METHOD']
这样就能自然支持 RESTful 风格的基础路由结构。
注意事项与边界情况
实际使用时注意几点:
- 确保 Web 服务器(如 Apache/Nginx)已将所有请求重写到入口文件(如 index.php)
- 路径末尾斜杠是否统一(/user 和 /user/ 被视为不同路径)
- 中文或特殊字符需考虑 URL 编码,rawurldecode() 可提前处理
- 生产环境建议加上路由缓存或更严格的路径规范化
基本上就这些。不复杂但容易忽略细节,动手写一遍比看十篇教程更管用。











