README

URL 构建器

安装

将依赖添加到您的项目的 composer.json 文件中

{
    "require": {
        "petrgrishin/url-builder": "~1.0"
    }
}

问题陈述

需要在系统的一层中确定对控制器地址的了解。这将允许快速且无痛苦地搜索和重构控制器及其地址。

实现检查地址构建参数的充分性，如果这种情况发生在其他层，例如在视图或客户端脚本中。

解决方案

所有控制器地址都应该在控制器中定义。如果需要，可以在视图层或客户端脚本层填充缺失的参数。为了方便工作，需要定义一个地址构建助手。

使用示例

在控制器中定义地址了解

基本抽象控制器。实现创建地址构建器对象的方法

class BaseController extends \CController {

    public function createUrlBuilder($route, $params = array()) {
        $urlBuilder = new SimpleUrlBuilder();
        $urlBuilder
            ->setRoute($route)
            ->setParams($params);
        return $urlBuilder;
    }
}

具体控制器。使用地址构建器

class SiteController extends BaseController {

    public function actionIndex() {
        return $this->render('index', array(
            'urls' => array(
                'catalog' => $this->createUrlBuilder('site/catalog')
                    ->getUrl(),
                // передана готовая строка адреса /?r=site/catalog
            ),
        ));
    }
    
    public function actionCatalog() {
        return $this->render('about', array(
            'products' => Product::model()->findAll(),
            'urls' => array(
                'product' => $this->createUrlBuilder('site/product')
                    ->setRequired(array('id')),
                // передан объект построителя с необходимыми знаниями,
                // требуемые параметры заполняются в представлении
            ),
        ));
    }
    
    public function actionProduct($id) {
        return $this->render('product');
    }
}

输出商品目录视图

/** @var UrlBuilder $productUrlBuilder */
$productUrlBuilder = $this->getParam('urls.product');

foreach ($this->getParam('products') as $product) {
    $productUrl = $productUrlBuilder
        ->copy()
        ->setParam('id', $product->id)
        ->getUrl();
        
    print($productUrl);
    // строка адреса /?r=site/product&id=1
}

// или передать параметры построителя адреса в клиентский скрипт
$this->setJsParams(array(
    'urls' => array(
        'product' => $productUrlBuilder->toArray(),
    ),
));