PHP构建简易路由器教学_PHP URL路由解析示例

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

PHP本身没有内置的路由系统,但用几行代码就能实现基础的URL路由分发,适合小型项目或学习原理。

理解路由的核心逻辑

路由本质是把用户请求的URL路径,映射到对应的处理函数或控制器方法。关键步骤就三步:获取当前请求路径、匹配预定义规则、执行对应逻辑。

PHP中常用 $_SERVER['REQUEST_URI'] 获取原始路径(含查询参数),用 parse_url() 提取干净的路径部分即可开始匹配。

手写一个支持GET路由的简易路由器

以下是一个无依赖、可直接运行的示例:

 回调函数
$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,避免后续路由干扰

扩展建议:加一层请求方法判断

真实项目中需区分 GETPOST 等方法。可在路由定义中加入方法字段:

$routes = [
    ['GET', '/',      fn() => echo '首页'],
    ['POST', '/login', fn() => echo '处理登录'],
];
// 匹配时加条件:$method === $_SERVER['REQUEST_METHOD']

这样就能自然支持 RESTful 风格的基础路由结构。

注意事项与边界情况

实际使用时注意几点:

  • 确保 Web 服务器(如 Apache/Nginx)已将所有请求重写到入口文件(如 index.php
  • 路径末尾斜杠是否统一(/user/user/ 被视为不同路径)
  • 中文或特殊字符需考虑 URL 编码,rawurldecode() 可提前处理
  • 生产环境建议加上路由缓存或更严格的路径规范化

基本上就这些。不复杂但容易忽略细节,动手写一遍比看十篇教程更管用。