repo_zf1/documentation/manual/fr/module_specs/Zend_Controller-ActionHelpers-FlashMessenger.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect3 id="zend.controller.actionhelpers.flashmessenger">
    <title>FlashMessenger</title>

    <sect4 id="zend.controller.actionhelper.flashmessenger.introduction">
        <title>Introduction</title>

        <para>
            L'aide <emphasis>FlashMessenger</emphasis> vous permet de fournir les messages dont
            l'utilisateur pourrait avoir besoin dans la requête suivante. Pour accomplir ceci,
            <emphasis>FlashMessenger</emphasis> utilise
            <classname>Zend_Session_Namespace</classname> pour
            stocker les messages à retrouver dans la prochaine requête. C'est généralement une
            bonne idée si vous planifiez d'utiliser <classname>Zend_Session</classname> ou
            <classname>Zend_Session_Namespace</classname>, que vous initialisez avec
            <methodname>Zend_Session::start()</methodname> dans votre fichier d'amorçage. (Reportez
            vous à la documentation de
            <link linkend="zend.session.advanced_usage.starting_a_session">Zend_Session</link>pour
            plus de détails sur son utilisation.)
        </para>
    </sect4>

    <sect4 id="zend.controller.actionhelper.flashmessenger.basicusage">
        <title>Exemple d'utilisation basique</title>

        <para>
            L'exemple ci-dessous vous montre l'utilisation du flash messenger dans sa forme
            la plus basique. Quand l'action <filename>/some/my</filename> est appelée, il ajoute
            le message "Sauvegarde réalisée&#160;!". Une requête suivante vers l'action
            <filename>/some/my-next-request</filename> le retrouvera (ainsi que le détruira).
        </para>

        <programlisting language="php"><![CDATA[
class SomeController extends Zend_Controller_Action
{
    /**
     * FlashMessenger
     *
     * @var Zend_Controller_Action_Helper_FlashMessenger
     */
    protected $_flashMessenger = null;

    public function init()
    {
        $this->_flashMessenger = $this->_helper
                                      ->getHelper('FlashMessenger');
        $this->initView();
    }

    public function myAction()
    {
        /**
         * Méthode par défaut por obtenir l'instance de
         * Zend_Controller_Action_Helper_FlashMessenger à la demande
         */
        $this->_flashMessenger->addMessage('Sauvegarde réalisée !');
    }

    public function myNextRequestAction()
    {
        $this->view->messages = $this->_flashMessenger->getMessages();
        $this->render();
    }
}
]]></programlisting>
    </sect4>
</sect3>