大网数据广告活动
PHP 语言与运行手册

Yaf_Router::route · 路由请求

· 52CE 我爱测

路由按注册顺序的倒序依次尝试。第一个认领该请求的路由胜出;随后请求被标记为已路由(参见 Yaf_Request_Abstract::setRouted()),并记录胜出的路由名,可通过 Yaf_Router::getCurrentRoute() 获取。

Yaf_Router::route

(Yaf >=1.0.0)

Yaf_Router::route — 路由请求

说明

public function Yaf_Router::route(Yaf_Request_Abstract $request): ?bool

使用已注册的路由对请求进行路由。

路由按注册顺序的倒序依次尝试。第一个认领该请求的路由胜出;随后请求被标记为已路由(参见 Yaf_Request_Abstract::setRouted()),并记录胜出的路由名,可通过 Yaf_Router::getCurrentRoute() 获取。

除非配置了自定义的默认路由,否则默认路由注册为 _default,即 Yaf_Route_Static。

参数

request

要路由的 Yaf_Request_Abstract 实例。

返回值

请求成功路由时返回 true,没有路由匹配时(例如畸形的 URI)返回 false,此时调度器会停止。

示例

示例 #1 Yaf_Router::route() 示例

<?php
class Bootstrap extends Yaf_Bootstrap_Abstract
{
    public function _initRoute(Yaf_Dispatcher $dispatcher)
    {
        $router = $dispatcher->getRouter();

        $router->addRoute("rewrite", new Yaf_Route_Rewrite(
            "/product/:id",
            ["controller" => "product", "action" => "detail"]
        ));

        /* 路由一个手工构造的请求,例如在单元测试中 */
        $request = new Yaf_Request_Simple("CLI", null, "index.php",
            "/product/123", null);

        if ($router->route($request)) {
            var_dump($router->getCurrentRoute());
            var_dump($request->getControllerName());
            var_dump($request->getActionName());
            var_dump($request->getParam("id"));
        } else {
            /* 没有路由匹配 */
        }
    }
}
?>

以上示例的输出类似于:

string(7) "rewrite"
string(7) "product"
string(6) "detail"
string(3) "123"

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。