|
|
@@ -8,63 +8,65 @@
|
|
|
<title>Introduction</title>
|
|
|
|
|
|
<para>
|
|
|
- L'aide <code>Redirector</code> vous permet d'utiliser un objet de redirection qui
|
|
|
- remplit tous les besoins de votre application, nécessaires à une redirection vers une
|
|
|
- nouvelle <acronym>URL</acronym>. Il fournit de nombreux avantages par rapport à la méthode
|
|
|
- <methodname>_redirect()</methodname>, comme la capacité de préconfigurer le comportement du site
|
|
|
- dans l'objet <code>Redirector</code> ou d'utiliser l'interface intégrée
|
|
|
- <methodname>gotoSimple($action, $controller, $module, $params)</methodname> similaire à
|
|
|
- <methodname>Zend_Controller_Action::_forward()</methodname>.
|
|
|
+ L'aide <emphasis>Redirector</emphasis> vous permet d'utiliser un objet de redirection
|
|
|
+ qui remplit tous les besoins de votre application, nécessaires à une redirection vers
|
|
|
+ une nouvelle <acronym>URL</acronym>. Il fournit de nombreux avantages par rapport à la
|
|
|
+ méthode <methodname>_redirect()</methodname>, comme la capacité de préconfigurer le
|
|
|
+ comportement du site dans l'objet redirecteur ou d'utiliser l'interface intégrée
|
|
|
+ <methodname>gotoSimple($action, $controller, $module, $params)</methodname>
|
|
|
+ similaire à <methodname>Zend_Controller_Action::_forward()</methodname>.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- <code>Redirector</code> possède une certain nombre de méthodes qui peuvent être
|
|
|
+ <emphasis>Redirector</emphasis> possède une certain nombre de méthodes qui peuvent être
|
|
|
utilisées pour affecter le comportement de la redirection :
|
|
|
</para>
|
|
|
|
|
|
<itemizedlist>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>setCode()</methodname> peut être utilisée pour paramétrer le code <acronym>HTTP</acronym> de
|
|
|
- la réponse à utiliser pendant la redirection.
|
|
|
+ <methodname>setCode()</methodname> peut être utilisée pour paramétrer le code
|
|
|
+ <acronym>HTTP</acronym> de la réponse à utiliser pendant la redirection.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>setExit()</methodname> peut être utilisée pour forcer un
|
|
|
- <methodname>exit()</methodname> juste après la redirection. Par défaut ceci vaut
|
|
|
- <constant>TRUE</constant>.
|
|
|
+ <methodname>exit()</methodname> juste après la redirection. Par défaut ceci
|
|
|
+ vaut <constant>TRUE</constant>.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>setGotoSimple()</methodname> peut être utilisée pour paramétrer l'URL par
|
|
|
- défaut à utiliser si aucune n'est fournie à <methodname>gotoSimple()</methodname>. Elle
|
|
|
- utilise les <acronym>API</acronym> de
|
|
|
- <methodname>Zend_Controller_Action::_forward()</methodname> :
|
|
|
- <code>setGotoSimple($action, $controller = null, $module = null, array $params
|
|
|
- = array());</code>
|
|
|
+ <methodname>setGotoSimple()</methodname> peut être utilisée pour paramétrer
|
|
|
+ l'<acronym>URL</acronym> par défaut à utiliser si aucune n'est fournie à
|
|
|
+ <methodname>gotoSimple()</methodname>. Elle utilise les <acronym>API</acronym>
|
|
|
+ de <methodname>Zend_Controller_Action::_forward()</methodname> :
|
|
|
+ <methodname>setGotoSimple($action, $controller = null, $module = null,
|
|
|
+ array $params = array())</methodname>
|
|
|
</para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>setGotoRoute()</methodname> peut être utilisée pour paramétrer une <acronym>URL</acronym>
|
|
|
- basée sur une route enregistrée. Fournissez un tableau de paires clé/valeur et
|
|
|
- une route nommée, et elle assemblera une <acronym>URL</acronym> suivant le type de la route et sa
|
|
|
- définition.
|
|
|
+ <methodname>setGotoRoute()</methodname> peut être utilisée pour paramétrer
|
|
|
+ une <acronym>URL</acronym> basée sur une route enregistrée. Fournissez un
|
|
|
+ tableau de paires clé / valeur et une route nommée, et elle assemblera
|
|
|
+ une <acronym>URL</acronym> suivant le type de la route et sa définition.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>setGotoUrl()</methodname> peut être utilisée pour paramétrer l'URL par
|
|
|
- défaut à utiliser si aucune n'est fournie à <methodname>gotoUrl()</methodname>. Accepte une
|
|
|
- chaîne unique correspondant à une <acronym>URL</acronym>.
|
|
|
+ <methodname>setGotoUrl()</methodname> peut être utilisée pour paramétrer
|
|
|
+ l'<acronym>URL</acronym> par défaut à utiliser si aucune n'est fournie à
|
|
|
+ <methodname>gotoUrl()</methodname>. Accepte une chaîne unique correspondant
|
|
|
+ à une <acronym>URL</acronym>.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>setPrependBase()</methodname> peut être utilisée pour ajouter une chaîne
|
|
|
- au début de l'URL de base de l'objet requête pour les <acronym>URL</acronym>s spécifiées avec
|
|
|
+ <methodname>setPrependBase()</methodname> peut être utilisée pour ajouter une
|
|
|
+ chaîne au début de l'<acronym>URL</acronym> de base de l'objet requête pour
|
|
|
+ les <acronym>URL</acronym>s spécifiées avec
|
|
|
<methodname>setGotoUrl()</methodname>, <methodname>gotoUrl()</methodname>, ou
|
|
|
<methodname>gotoUrlAndExit()</methodname>.
|
|
|
</para>
|
|
|
@@ -72,49 +74,52 @@
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>setUseAbsoluteUri()</methodname> peut être utilisée pour forcer le
|
|
|
- <code>Redirector</code> à utiliser des <acronym>URI</acronym> absolus pour la redirection. Quand
|
|
|
- cette option est choisie, elle utilise les valeurs de
|
|
|
- <varname>$_SERVER['HTTP_HOST']</varname>, <varname>$_SERVER['SERVER_PORT']</varname>, et
|
|
|
- <varname>$_SERVER['HTTPS']</varname> pour former un <acronym>URI</acronym> complet à partir de l'URL
|
|
|
- spécifiée par une des méthodes de redirection. Cette option est inactive par
|
|
|
- défaut, mais pourra être activée par défaut dans les prochaines
|
|
|
- releases.
|
|
|
+ <emphasis>Redirector</emphasis> à utiliser des <acronym>URI</acronym> absolus
|
|
|
+ pour la redirection. Quand cette option est choisie, elle utilise les valeurs
|
|
|
+ de <varname>$_SERVER['HTTP_HOST']</varname>,
|
|
|
+ <varname>$_SERVER['SERVER_PORT']</varname>, et
|
|
|
+ <varname>$_SERVER['HTTPS']</varname> pour former un <acronym>URI</acronym>
|
|
|
+ complet à partir de l'<acronym>URL</acronym> spécifiée par une des méthodes
|
|
|
+ de redirection. Cette option est inactive par défaut, mais pourra être activée
|
|
|
+ par défaut dans les prochaines releases.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
</itemizedlist>
|
|
|
|
|
|
<para>
|
|
|
- De plus, il y a une variété de méthodes dans le <code>Redirector</code> pour
|
|
|
- réaliser les redirections actuelles :
|
|
|
+ De plus, il y a une variété de méthodes dans le redirecteur pour réaliser les
|
|
|
+ redirections actuelles :
|
|
|
</para>
|
|
|
|
|
|
<itemizedlist>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>gotoSimple()</methodname> utilise <methodname>setGotoSimple()</methodname> (<code>API
|
|
|
- de type _forward()</code>) pour construire une <acronym>URL</acronym> et réaliser une
|
|
|
- redirection.
|
|
|
+ <methodname>gotoSimple()</methodname> utilise
|
|
|
+ <methodname>setGotoSimple()</methodname> (<acronym>API</acronym> de type
|
|
|
+ <methodname>_forward()</methodname>) pour construire une <acronym>URL</acronym>
|
|
|
+ et réaliser une redirection.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>gotoRoute()</methodname> utilise <methodname>setGotoRoute()</methodname>
|
|
|
- (<code>assemblage de route</code>) pour construire une <acronym>URL</acronym> et réaliser une
|
|
|
+ <methodname>gotoRoute()</methodname> utilise
|
|
|
+ <methodname>setGotoRoute()</methodname> (<emphasis>assemblage de
|
|
|
+ route</emphasis>) pour construire une <acronym>URL</acronym> et réaliser une
|
|
|
redirection.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>gotoUrl()</methodname> utilise <methodname>setGotoUrl()</methodname> (<code>URL sous
|
|
|
- forme de chaîne</code>) pour construire une <acronym>URL</acronym> et réaliser une
|
|
|
- redirection.
|
|
|
+ <methodname>gotoUrl()</methodname> utilise <methodname>setGotoUrl()</methodname>
|
|
|
+ (<emphasis> <acronym>URL</acronym> sous forme de chaîne</emphasis>) pour
|
|
|
+ construire une <acronym>URL</acronym> et réaliser une redirection.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
</itemizedlist>
|
|
|
|
|
|
<para>
|
|
|
- Enfin, vous pouvez déterminer l'URL de la redirection courante à tout moment en
|
|
|
- utilisant <methodname>getRedirectUrl()</methodname>.
|
|
|
+ Enfin, vous pouvez déterminer l'<acronym>URL</acronym> de la redirection courante à
|
|
|
+ tout moment en utilisant <methodname>getRedirectUrl()</methodname>.
|
|
|
</para>
|
|
|
</sect4>
|
|
|
|
|
|
@@ -126,10 +131,10 @@
|
|
|
<title>Options de réglage</title>
|
|
|
|
|
|
<para>
|
|
|
- Cet exemple surcharge de multiples options, incluant le réglage du code de
|
|
|
- statut <acronym>HTTP</acronym> à utiliser dans la redirection ("303"), le retrait du <code>exit</code>
|
|
|
- par défaut après la redirection, et la définition d'une <acronym>URL</acronym> par défaut à utiliser
|
|
|
- lors d'une redirection.
|
|
|
+ Cet exemple surcharge de multiples options, incluant le réglage du code de statut
|
|
|
+ <acronym>HTTP</acronym> à utiliser dans la redirection ("303"), pas de sortie
|
|
|
+ par défaut après la redirection, et la définition d'une <acronym>URL</acronym>
|
|
|
+ par défaut à utiliser lors d'une redirection.
|
|
|
</para>
|
|
|
|
|
|
<programlisting language="php"><![CDATA[
|
|
|
@@ -173,7 +178,8 @@ class SomeController extends Zend_Controller_Action
|
|
|
|
|
|
<para>
|
|
|
Cet exemple suppose que vous utilisez les paramètres par défaut, ce qui
|
|
|
- inclut que toute redirection sera suivie d'un <methodname>exit()</methodname> immédiat.
|
|
|
+ inclut que toute redirection sera suivie d'un <methodname>exit()</methodname>
|
|
|
+ immédiat.
|
|
|
</para>
|
|
|
|
|
|
<programlisting language="php"><![CDATA[
|
|
|
@@ -210,10 +216,11 @@ class AlternativeController extends Zend_Controller_Action
|
|
|
<title>Utilisation de l'API _forward() de goto()</title>
|
|
|
|
|
|
<para>
|
|
|
- L'API de <methodname>gotoSimple()</methodname> imite celle de
|
|
|
- <methodname>Zend_Controller_Action::_forward()</methodname>. La différence principale
|
|
|
- est qu'elle construit une <acronym>URL</acronym> à partir des paramètres fournis, et du format de
|
|
|
- route par défaut <code>:module/:controller/:action/*</code> du routeur. Il réalise
|
|
|
+ L'<acronym>API</acronym> de <methodname>gotoSimple()</methodname> imite celle de
|
|
|
+ <methodname>Zend_Controller_Action::_forward()</methodname>. La différence
|
|
|
+ principale est qu'elle construit une <acronym>URL</acronym> à partir des paramètres
|
|
|
+ fournis, et du format de route par défaut
|
|
|
+ <filename>:module/:controller/:action/*</filename> du routeur. Il réalise
|
|
|
alors une redirection au lieu d'enchaîner l'action.
|
|
|
</para>
|
|
|
|
|
|
@@ -254,9 +261,9 @@ class ForwardController extends Zend_Controller_Action
|
|
|
|
|
|
<para>
|
|
|
L'exemple suivant utilise la méthode <methodname>assemble()</methodname> du
|
|
|
- <link linkend="zend.controller.router">routeur</link>pour créer une <acronym>URL</acronym> basée sur
|
|
|
- un tableau associatif de paramètres fournis. Il suppose que la route suivante a été
|
|
|
- enregistrée :
|
|
|
+ <link linkend="zend.controller.router">routeur</link>pour créer une
|
|
|
+ <acronym>URL</acronym> basée sur un tableau associatif de paramètres fournis.
|
|
|
+ Il suppose que la route suivante a été enregistrée :
|
|
|
</para>
|
|
|
|
|
|
<programlisting language="php"><![CDATA[
|
|
|
@@ -271,7 +278,8 @@ $router->addRoute('blogArchive', $route);
|
|
|
|
|
|
<para>
|
|
|
En donnant un tableau avec l'année réglée à 2006, le mois à 4, le jour à 24
|
|
|
- et l'ID à 42, il construira l'URL <code>/blog/2006/4/24/42</code>.
|
|
|
+ et l'ID à 42, il construira l'<acronym>URL</acronym>
|
|
|
+ <filename>/blog/2006/4/24/42</filename>.
|
|
|
</para>
|
|
|
|
|
|
<programlisting language="php"><![CDATA[
|