Zend_Controller_Router_Route_Hostname
Zend_Controller_Router_Route_Hostname est la route par nom
d'hôte du framework. Elle fonctionne de la même manière que la route standard, mais elle
utilise le nom d'hôte de l'URL appelé au lieu du chemin.
Utilisons l'exemple d'une route standard et regardons ce que cela donnerais en
utilisant le nom d'hôte. Au lieu d'appeler l'utilisateur par le chemin, nous voulons être
capable d'appeler http://toto.users.example.com pour voir les informations
concernant l'utilisateur "toto"
'profile',
'action' => 'userinfo'
)
);
$plainPathRoute = new Zend_Controller_Router_Route_Static('');
$router->addRoute('user', $hostnameRoute->chain($plainPathRoute);
]]>
Le premier paramètre dans le constructeur
Zend_Controller_Router_Route_Hostname est la définition d'une route
qui correspondra à un nom d'hôte. Les définitions de route consistent en des parties
statiques et des parties dynamiques séparées par le caractère point ("."). Les
parties dynamiques, appelées variables, sont marquées en précédant le nom de variable par
le caractère deux-points (":") : :username. Les parties
statiques sont de simples textes : user.
Les routes par nom d'hôtes peuvent, mais ne devraient pas être utilisées comme ceci.
La raison à cela est que qu'une route par nom d'hôte seule ne correspondra à aucun chemin.
Donc vous devez donc chaîner le chemin d'une route à une route par nom d'hôte. Ceci est
réalisé comme dans l'exemple ci-dessous en appelant
$hostnameRoute->chain($pathRoute);. En faisant ceci,
$hostnameRoute n'est pas modifié, mais une nouvelle route
(Zend_Controller_Router_Route_Chain) est retournée, qui peut ainsi
être fournie au routeur.
Priorité des paramètres
Lors du chaînage de routes ensemble, comme la route par nom d'hôte avec la route
par chemin ("path"), les paramètres de la route par nom d'hôte ont une priorité plus
haute que les paramètres de la route par chemin. Ainsi si vous définissez un contrôleur
dans les deux routes, le contrôleur de la route par nom d'hôte sera sélectionné.
Routes par nom d'hôtes avec Zend_Config
Pour chaîner ensemble les routes par nom d'hôte et les routes par chemin, il
existe un paramètre additionnel pour la configuration nommé chains.
Celui-ci est simplement une liste de routes, qui peuvent être chaînées avec la route
parente. Ni la route parente, ni la route enfant ne seront ajoutées directement au
routeur mais seulement la route chaînée. Le nom de la route chaînée dans le routeur
sera la concaténation du nom de la route parente, d'un tiret ("-") et du
nom de la route enfant. Un fichier simple de configuration de type XML ressemblera à
ceci :
www.example.com
imprint
users.example.com
:username
misc
]]>
Ceci donnera trois routes www-index, www-imprint et
users-profile qui fonctionneront seulement avec le bon nom d'hôte et la
route misc, qui fonctionnera avec n'importe quel nom d'hôte.