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 das
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
$outer->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
]]>