https://github.com/petrgrishin/url-builder
Url builder
https://github.com/petrgrishin/url-builder
Last synced: 5 months ago
JSON representation
Url builder
- Host: GitHub
- URL: https://github.com/petrgrishin/url-builder
- Owner: petrgrishin
- Created: 2014-08-04T18:45:35.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2014-08-11T12:40:39.000Z (almost 11 years ago)
- Last Synced: 2025-01-01T12:12:37.807Z (7 months ago)
- Language: PHP
- Size: 169 KB
- Stars: 2
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
url-builder
===========
[](https://travis-ci.org/petrgrishin/url-builder)
[](https://coveralls.io/r/petrgrishin/url-builder?branch=master)
Url builder
Установка
------------
Добавите зависимость для вашего проекта в composer.json:
```json
{
"require": {
"petrgrishin/url-builder": "~1.0"
}
}
```
Постановка проблемы
------------
Необходимо определить знание об адресе контроллеров в одном слое сисстемы. Это позволит быстро и безболезненно производить поиск и рефакторинг контроллеров и их адресов.
Реализовать проверку достаточности параметров построения адреса, если такое происходит в другом слое, например в представлении или клиентских скриптах.
Решение
------------
Все адреса контроллеров должны быть определены в самих контроллерах. При необходимости недостающие параметры можно заполнить в слое представления или клиентского скрипта. Для удобной работы необходимо определить помощника - построитель адресов.
Примеры использования
------------
#### Определение знания об адресе в контроллере
Базовый абстрактный контроллер. Реализация метода создания обектов построителя адреса
```php
class BaseController extends \CController {
public function createUrlBuilder($route, $params = array()) {
$urlBuilder = new SimpleUrlBuilder();
$urlBuilder
->setRoute($route)
->setParams($params);
return $urlBuilder;
}
}
```
Конкретный контроллер. Использование построителя адреса
```php
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');
}
}
```
Представление вывода каталога товаров
```php
/** @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(),
),
));
```