Система Zend_Controller построена с расчетом на расширение посредством либо создания подклассов от существующих, либо написания новых классов, которые реализуют интерфейсы Zend_Controller_Router_Interface и Zend_Controller_Dispatcher_Interface.

Возможными причинами для реализации нового маршрутизатора или диспетчера могут быть:

Пожалуйста, будьте осторожны при переписывании важных частей системы, особенно диспетчера. Одним из преимуществ Zend_Controller является то, что он устанавливает общие соглашения для разрабатываемых приложений. Если изменено слишком многое из поведения по умолчанию, нетоторые из этих преимуществ будут потеряны. Тем не менее, есть много разных потребностей, и одно решение не может соответствовать им всем, поэтому некоторая свобода допустима, если нужно.

Сильно приветствуется следование данным соглашениям в наименовании и хранении файлов при создании подклассов любых классов Zend_Controller. Выполнение этого будет гарантировать легкое понимание вашего проекта другим программистом, знакомым с Zend Framework.

/library
  /Zend
    /Controller
      Action.php
      Dispatcher.php
      Router.php

/library
  /Zend
  /Widget
    /Controller
      Router.php
      README.txt

Интерфейс Zend_Controller_Router_Interface дает определение только одному методу:

<?php

  /**
   * @param  Zend_Controller_Dispatcher_Interface
   * @throws Zend_Controller_Router_Exception
   * @return Zend_Controller_Dispatcher_Token|boolean
   */
  public function route(Zend_Controller_Dispatcher_Interface $dispatcher);

?>

Маршрутизация производится только один раз: когда запрос впервые получен системой. Целью маршрутизатора является генерация маркера Zend_Controller_Dispatch_Token, который определяет контроллер и действие в этом контроллере. Далее маркер передается диспетчеру. Если невозможно преобразовать маршрут в маркер диспетчеризации, то возвращается булево значение FALSE.

Некоторые маршрутизаторы могут обрабатывать динамические элементы и нуждаются в способе проверки того, является ли сгенерированный маркер возможным для диспетчеризации в настоящее время, до его возвращения. Поэтому маршрутизатор принимает объект диспетчера как единственный аргумент его метода route(). Объект диспетчера предоставляет метод isDispatchable() для этой проверки.

Zend_Controller_Front сначала будет вызывать маршрутизатор для получения первого маркера диспетчеризации, который он передаст диспетчеру. Диспетчер будет вызывать действие (создавая экземпляр контроллера) и после возвращать либо булево значение FALSE, либо другой маркер диспетчеризации.

Zend_Controller_Front повторно вызывает диспетчер, пока он возвращает маркер диспетчеризации. Это известно как цикл диспетчеризации. Он позволяет обрабатывать действия до тех пор, пока не будет выполнена вся работа.

Интерфейс Zend_Controller_Dispatcher_Interface дает определение двум методам:

<?php

/**
 * @param  Zend_Controller_Dispatcher_Token $route
 * @return boolean
 */
public function isDispatchable(Zend_Controller_Dispatcher_Token $route);

?>

isDispatchable() проверяет, является ли маркер возможным для диспетчеризации. Если является, то возвращается TRUE, иначе FALSE. Определение того, что возможно для диспетчеризации, зависит от класса, реализующего интерфейс. В случае реализации по умолчанию (Zend_Controller_Dispatcher) это означает, что файл контроллера существует, класс существует в этом файле и метод, реализующий действие, существует в этом классе.

<?php

/**
 * @param  Zend_Controller_Dispatcher_Token $route
 * @return Zend_Controller_Dispatcher_Token|boolean
 */
public function dispatch(Zend_Controller_Dispatcher_Token $route);

?>

dispatch() является рабочим методом. Этот метод должен выполнять действие контроллера. Он должен возвращать либо маркер диспетчеризации, либо FALSE, который указывает, что работа выполнена.