Der Dispatcher
Überblick
Dispatching ist der Prozess, das Request Objekt
Zend_Controller_Request_Abstract zu übernehmen, die dort enthaltenen
Modul, Controller und Aktion Namen sowie die optionalen Parameter zu extrahieren und
dann den Controller zu instanzieren und die Aktion dieses Controllers aufzurufen.
Wenn kein Modul, kein Controller oder keine Aktion gefunden wurde, werden dafür
Standardwerte verwendet. Zend_Controller_Dispatcher_Standard legt
index für jede der Controller und Action Standardwerte fest und
default für den Standardwert des Moduls, erlaubt dem Entwickler aber auch,
diese durch Verwendung der setDefaultController(),
setDefaultAction() und setDefaultModule() Methoden zu
verändern.
Standard Module
Bei der Erstellung von modularen Anwendungen kann es sein das man auch einen
Namespace für eigene Standard Module haben will (die Standardkonfiguration ist, das
das Standardmodul keinen Namensraum hat). Ab 1.5.0, kann das
durch Spezifizierung von prefixDefaultModule auf true, entweder im
Front Kontroller oder im Dispatcher, getan werden:
setParam('prefixDefaultModule', true);
// Im Dispatcher:
$dispatcher->setParam('prefixDefaultModule', true);
]]>
Das erlaubt es existierende Module als Standardmodule für eine Anwendung
wiederzuverwenden.
Dispatching läuft innerhalb einer Schleife im Front Controller ab. Vor dem Dispatching
fragt der Front Controller den Request ab, um benutzerspezifizierte Werte für Modul,
Controller, Aktion und optionale Parameter zu finden. Dann startet er die Dispatch
Schleife, um die Anfrage zu verarbeiten.
Zu Beginn jeden Durchlaufes setzt er im Request Objekt einen Schalter, der angibt, dass
die Aktion verarbeitet worden ist. Wenn eine Aktion oder ein pre/postDispatch Plugin
diesen Schalter zurücksetzt, wird die Dispatch Schleife fortgesetzt und versucht, die
neue Anfrage zu verarbeiten. Durch Ändern des Controllers und / oder der Aktion im
Request Objekt und Zuürcksetzen des Verarbeitungsstatus, kann der Entwickler eine zu
durchlaufende Anfragekette definieren.
Die Controller Methode, die solch eine Verarbeitung kontrolliert lautet
_forward(); rufe diese Methode von einer beliebigen pre/postDispatch()
oderAktionsmethode auf und übergebe Aktion, Controller, Modul und beliebige optionale
Parameter, die du zur neuen Aktion übersenden möchtest:
_forward('bar', null, null, array('baz' => 'bogus'));
}
public function barAction()
{
// Weiterleiten zu einer Aktion in einem anderen Controller:
// FooController::bazAction(), im aktuellen Modul:
$this->_forward('baz', 'foo', null, array('baz' => 'bogus'));
}
public function bazAction()
{
// weiterleiten zu einer Aktion in einem anderen Controller in einem
// anderen Modul Foo_BarController::bazAction():
$this->_forward('baz', 'bar', 'foo', array('baz' => 'bogus'));
}
]]>
Erben vom Dispatcher
Zend_Controller_Front ruft zuerst den Router auf, um die erste Aktion
für den Request zu ermitteln. Danach startet es die Dispatch Schleife, welche
den Dispatcher aufruft, um die Aktion zu verarbeiten.
Der Dispatcher benötigt eine Vielzahl von Daten um seine Arbeit zu erledigen - er muß wissen wie die
Namen von Controller und Aktionen formatiert werden sollen, wo nach Dateien der Controller Klassen
gesucht wird, ob ein übergebener Modulname gültig ist oder nicht, und eine API um festzustellen ob eine
gegebene Anfrage, basierend auf den anderen vorhandenen Informationen, bearbeitbar ist.
Zend_Controller_Dispatcher_Interface definiert die folgenden Methoden die für jede
Dispatcher Implementierung benötigt werden:
In den meisten Fällen sollte trotzdem einfach die abstrakte Klasse
Zend_Controller_Dispatcher_Abstract erweitert werden, und welcher jede davon schon
definiert wurde, oder Zend_Controller_Dispatcher_Standard um Funktionalitäten des
Standard Dispatchers zu modifizieren.
Mögliche Gründe um den Dispatcher zu erweitern beinhaltet den Wunsch eine anderes Klassen oder
Methoden Namensschema in den eigenen Aktion Controllern zu verwenden, oder den Wunsch ein anderes
Verarbeitungs Paradigma wie das Verarbeiten zu Aktionsdateien unter den Controller Verzeichnissen
(statt auf Klassen Methoden zu verarbeiten).