# 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:

    // Erstellung zweier Routen
    $hostnameRoute = new Zend_Controller_Router_Route_Hostname(...);
    $pathRoute     = new Zend_Controller_Router_Route(...);

    // Erster Weg, mit Verkettung über die Chain Route
    $chainedRoute = new Zend_Controller_Router_Route_Chain();
    $chainedRoute->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:

    // Zwei Routen erstellen
    $firstRoute  = new Zend_Controller_Router_Route('foo');
    $secondRoute = new Zend_Controller_Router_Route('bar');

    // Sie mit einem anderen Trennzeichen miteinander verketten
    $chainedRoute = $firstRoute->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:

    <routes>
        <www type="Zend_Controller_Router_Route_Hostname">
            <route>www.example.com</route>
            <chains>
                <language type="Zend_Controller_Router_Route">
                    <route>:language</route>
                    <reqs language="[a-z]{2}">
                    <chains>
                        <index type="Zend_Controller_Router_Route_Static">
                            <route></route>
                            <defaults module="default" controller="index"
                                      action="index" />
                        </index>
                        <imprint type="Zend_Controller_Router_Route_Static">
                            <route>imprint</route>
                            <defaults module="default" controller="index"
                                      action="index" />
                        </imprint>
                    </chains>
                </language>
            </chains>
        </www>
        <users type="Zend_Controller_Router_Route_Hostname">
            <route>users.example.com</route>
            <chains>
                <profile type="Zend_Controller_Router_Route">
                    <route>:username</route>
                    <defaults module="users" controller="profile" action="index" />
                </profile>
            </chains>
        </users>
        <misc type="Zend_Controller_Router_Route_Static">
            <route>misc</route>
        </misc>
    </routes>

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:

    <routes>
        <www type="Zend_Controller_Router_Route_Chain">
            <route>www.example.com</route>
        </www>
        <language type="Zend_Controller_Router_Route">
            <route>:language</route>
            <reqs language="[a-z]{2}">
        </language>
        <index type="Zend_Controller_Router_Route_Static">
            <route></route>
            <defaults module="default" controller="index" action="index" />
        </index>
        <imprint type="Zend_Controller_Router_Route_Static">
            <route>imprint</route>
            <defaults module="default" controller="index" action="index" />
        </imprint>

        <www-index type="Zend_Controller_Router_Route_Chain">
            <chain>www, language, index</chain>
        </www-index>
        <www-imprint type="Zend_Controller_Router_Route_Chain">
            <chain>www, language, imprint</chain>
        </www-imprint>
    </routes>

Man kann auch den chain Parameter als Array übergeben statt die Routen mit einem Komma zu seperieren:

    <routes>
        <www-index type="Zend_Controller_Router_Route_Chain">
            <chain>www</chain>
            <chain>language</chain>
            <chain>index</chain>
        </www-index>
        <www-imprint type="Zend_Controller_Router_Route_Chain">
            <chain>www</chain>
            <chain>language</chain>
            <chain>imprint</chain>
        </www-imprint>
    </routes>

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:

    $config = new Zend_Config(array(
        'chainName' => 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