Yaf_Route_Interface::assemble

(Yaf >=2.3.0)

Yaf_Route_Interface::assemble组装一个请求

说明

abstract public function Yaf_Route_Interface::assemble(array $info, array $query = ?): string

此方法根据参数 info 返回一个 url,并根据参数 query 向 url 追加查询字符串。

路由应该根据自己的路由规则来实现这个方法,做一个逆向的过程。

参数

info

query

返回值

示例

示例 #1 Yaf_Route_Interface::assemble() 示例

<?php
class RewriteRoute implements Yaf_Route_Interface {

    private $_match;
    private $_route;

    public function __construct(string $match, array $route) {
        $this->_match = $match;
        $this->_route = $route;
    }

    public function route(Yaf_Request_Abstract $request): bool {
        if (!preg_match($this->_match, $request->getRequestUri(), $matches)) {
            return false;
        }

        foreach ($this->_route as $key => $value) {
            if (is_string($value) && ':' === $value[0]) {
                $value = $matches[substr($value, 1)];
            }
            $request->setParam($key, $value);
        }
        $request->setRouted();

        return true;
    }

    /* 将路由规则逆向还原为一个 URL */
    public function assemble(array $info, ?array $query = null): string {
        $url = "/product";
        if (isset($info[':name'])) {
            $url .= "/" . $info[':name'];
        }

        if (!empty($query)) {
            $url .= "?" . http_build_query($query);
        }

        return $url;
    }
}

$router = new Yaf_Router();
$router->addRoute("custom",
    new RewriteRoute("#^/product#", array("controller" => "product"))
);

var_dump($router->getRoute("custom")->assemble(
    array(':name' => 'book'),
    array('page' => 2)
));
?>

以上示例的输出类似于:

string(20) "/product/book?page=2"