4.3 Controller

4.3.1 Создание

4.3.2 Базовые методы и свойства

4.3.3 Служебные

4.3.1 Создание

Контроллеры располагаются в директории controllers модуля. Имена контроллеров должны соответствовать следующему соглашению: <Имя_модуля><Имя_контроллера>Controller (todo: описать, откуда берется <Имя_контроллера>, а то не совсем ясно что это за имя). Например, для модуля news контроллер view будет называться: newsViewController.

Контроллеры в ваших модулях должны наследоваться от базового абстрактного класса simpleController. Каждый контроллер должен реализовывать защищённый (protected) метод getView().

Таким образом, простейшим примером может выступать следующий контроллер, возвращающий клиенту строку Hello, world!:

class helloWorldController extends simpleController
{
    protected function getView()
    {
        return 'Hello, world!';
    }
}

В большинстве случаев вам не придется вручную создавать файлы и базовый код ваших контроллеров. Все эти действия выполнит встроенный в фреймворк инструмент скаффолдинга devToolbar (todo ссылка на тулбар)

4.3.2 Базовые методы и свойства

Для упрощения процесса разработки базовый класс simpleController предоставляет ряд методов и свойств.

Методы:

$this->setPager($newsFolderMapper, 10, true); // устанавливаем pager
$this->smarty->assign('news', $newsFolderMapper->getItems($newsFolder)); // ищем новости

<div class="pages">{$pager->toString()}</div>

return $this->fetch('news/list.tpl');

$url = new url('default');
return $this->redirect($url->get());

return $this->forward('admin', 'dashboard');

Свойства:

$id = $this->toolkit->getMapper('news', 'news');

$path = $this->request->getString('path');

$this->response->setCookie('cookie_name', 'cookie_data');

$this->smarty->assign('news', $newsFolderMapper->getItems($newsFolder));
$this->smarty->assign('folderPath', $newsFolder->getTreePath());

4.3.3 Служебные

• simple404Controller. Предназначен для вывода стандартной ошибки 404 "Запрашиваемый объект не найден".
  Если вам нужно отобразить 404 ошибку у себя в контроллере - следует использовать примерно такой код:

  $controller = new simple404Controller();
  return $controller->run();

  Также существует альтернативный способ передачи управления контроллеру 404 ошибки (todo ссылка на описание forward404):

  $mapper = $this->toolkit->getMapper('news', 'news');
  ...
  $this->forward404($mapper);

  В этом случае будет произведён поиск контроллера news404Controller в директории news/controllers. И в случае, если он будет найден - то будет вызван именно он. В противном случае - также будет вызываться simple404Controller.
  В качестве шаблона для этого контроллера используется файл simple/404.tpl, который вы, конечно же, можете переопределить у себя в проекте (подробнее)
  Также он автоматически вызывается для адресов, которые не были обработаны ни одним из роутов.
• simple403Controller. Предназначен для вывода стандартной ошибки 404 "Доступ запрещён".
  Если вам нужно отобразить 403 ошибку у себя в контроллере - следует использовать примерно такой код:

  $controller = new simple403Controller();
  return $controller->run();

  Также существует альтернативный способ передачи управления контроллеру 403 ошибки (todo ссылка на описание forward403):

  $mapper = $this->toolkit->getMapper('news', 'news');
  ...
  $this->forward403($mapper);

  В этом случае будет произведён поиск контроллера news403Controller в директории news/controllers. И в случае, если он будет найден - то будет вызван именно он. В противном случае - также будет вызываться simple403Controller.
  В качестве шаблона для этого контроллера используется файл simple/403.tpl, который вы, конечно же, можете переопределить у себя в проекте (подробнее)
  Также он автоматически вызывается для адресов, для которых в результате проверки прав достпупа был получен отказ (todo ссылка на роли).