Zend_Controller_Router_Route_Chain
Zend_Controller_Router_Route_Chain ist eine Route die es erlaubt
mehrere Routen miteinander zu verketten. Das erlaubt es Hostname-Routen und Pfad-Routen zu
verketten, oder zum Beispiel mehrere Pfad-Routen. Verkettung kann entweder
program-technisch oder mit einer Konfigurationsdatei durchgeführt werden.
Priorität der Parameter
Wenn Routen wie die Hostnameroute und die Pfadroute zusammengekettet werden, haben die
Parameter der Hostnameroute eine höhere Priorität als die Parameter der Pfadroute.
Deshalb wird, wenn man im Hostnamen und in der Pfadroute einen Controller definiert,
der Controller der Hostnameroute ausgewählt.
Wenn Programmtechnisch verkettet wird, gibt es zwei Wege das zu tun. Der erste besteht
darin eine neue Instanz von Zend_Controller_Router_Route_Chain zu
erstellen und dann die chain() Methode mehrere Male mit allen
Routen aufzurufen die zusammen verkettet werden sollen. Der andere Weg besteht darin die
erste Route zu nehmen, z.B. eine Hostname Route, und die chain()
Methode mit der Route auf Ihr aufzurufen, die angehängt werden soll. Das verändert die
Hostname Route nicht, gibt aber eine neue Instanz von
Zend_Controller_Router_Route_Chain zurück, die dann beide Routen
verkettet hat:
chain($hostnameRoute)
->chain($pathRoute);
// Zweiter Weg, direkt verketten
$chainedRoute = $hostnameRoute->chain($pathRoute);
]]>
Wenn Routen miteinander verkettet werden, ist Ihr Trennzeichen ein
Schrägstrich. Es kann Fälle geben in denen man ein anderes Trennzeichen verwenden will:
chain($secondRoute, '-');
// Zusammenbauen der Route: "foo-bar"
echo $chainedRoute->assemble();
]]>
Verkettete Routen über Zend_Config
Um Routen in einer Config Datei miteinander zu verketten gibt es zusätzliche Parameter
für die Konfiguration von Ihnen. Der einfachere Weg ist die Verwendung des
chains Parameters. Dieser ist einfach eine Liste von Routen, die
mit der Eltern-Route verkettet werden. Weder die Eltern-, noch die Kind-Routen werden
dem Router direkt hinzugefügt sondern nur die resultierende verkettete Route. Der Name
der verketteten Route im Router ist standardmäßig der Name der Eltern-Route und der Name
der Kind-Route verbunden mit einem Bindestrich (-). Eine einfache Konfiguration würde
in XML wie folgt aussehen:
www.example.com
:language
imprint
users.example.com
:username
misc
]]>
Das führt zu den drei Routen www-language-index,
www-language-imprint und users-language-profile
die nur basierend auf dem Hostnamen und der Route misc passen, was
wiederum mit jedem Hostnamen passt.
Der alternative Weg der Erstellung einer verketteten Route ist der über den
chain Parameter, was wiederum nur mit dem Chain-Route Typ direkt
verwendet werden kann, und auch im Root Level funktioniert:
www.example.com
:language
imprint
www, language, index
www, language, imprint
]]>
Man kann auch den chain Parameter als Array übergeben statt die
Routen mit einem Komma zu seperieren:
www
language
index
www
language
imprint
]]>
Wenn man Chain-Routen mit Zend_Config konfiguriert und will dass
das Trennzeichen ein anderes als ein Unterstrich ist, dann muss man dises Trennzeichen
separat spezifizieren:
array(
'type' => 'Zend_Controller_Router_Route_Static',
'route' => 'foo',
'chains' => array(
'subRouteName' => array(
'type' => 'Zend_Controller_Router_Route_Static',
'route' => 'bar',
'defaults' => array(
'module' => 'module',
'controller' => 'controller',
'action' => 'action'
)
)
)
)
));
// Das Trennzeichen vor dem hinzufügen der Config setzen
$router->setChainNameSeparator('_separator_')
// Config hinzufügen
$router->addConfig($config);
// Der Name unserer Route ist jetzt: chainName_separator_subRouteName
echo $this->_router->assemble(array(), 'chainName_separator_subRouteName');
// Die Prüfung: Ausgegeben wird /foo/bar
]]>