zend-mvc-plugin-flashmessenger

Plugin for creating and exposing flash messages via zend-mvc controllers.

$ composer require zendframework/zend-mvc-plugin-flashmessenger

Installation

Install via composer:


$ composer require zendframework/zend-mvc-plugin-flashmessenger
          

If you are using the zend-component-installer, you're done!

If not, you will need to add the component as a module to your application. Add the entry 'Zend\Mvc\Plugin\FlashMessenger' to your list of modules in your application configuration (typically one of config/application.config.php or config/modules.config.php).

Usage

The FlashMessenger is a plugin designed to create and retrieve self-expiring, session-based messages. It exposes a number of methods:

  • setSessionManager(Zend\Session\ManagerInterface $manager) : FlashMessenger: Allows you to specify an alternate session manager, if desired.
  • getSessionManager() : Zend\Session\ManagerInterface: Allows you to retrieve the session manager registered.
  • getContainer() : Zend\Session\Container: Returns the Zend\Session\Container instance in which the flash messages are stored.
  • setNamespace(string $namespace = 'default') : FlashMessenger: Allows you to specify a specific namespace in the container in which to store or from which to retrieve flash messages.
  • getNamespace() : string: retrieves the name of the flash message namespace.
  • addMessage(string $message) : FlashMessenger: Allows you to add a message to the current namespace of the session container.
  • hasMessages() : bool: Lets you determine if there are any flash messages from the current namespace in the session container.
  • getMessages() : array: Retrieves the flash messages from the current namespace of the session container
  • clearMessages() : bool: Clears all flash messages in current namespace of the session container. Returns true if messages were cleared, false if none existed.
  • hasCurrentMessages() : bool: Indicates whether any messages were added during the current request.
  • getCurrentMessages() : array: Retrieves any messages added during the current request.
  • clearCurrentMessages() : bool: Removes any messages added during the current request. Returns true if current messages were cleared, false if none existed.
  • clearMessagesFromContainer() : bool: Clear all messages from the container. Returns true if any messages were cleared, false if none existed.

This plugin also provides four meaningful namespaces, namely: INFO, ERROR, WARNING, and SUCCESS. The following functions are related to these namespaces:

  • addInfoMessage(string $message): FlashMessenger: Add a message to "info" namespace.
  • hasCurrentInfoMessages() : bool: Check to see if messages have been added to "info" namespace within this request.
  • addWarningMessage(string $message) : FlashMessenger: Add a message to "warning" namespace.
  • hasCurrentWarningMessages() : bool: Check to see if messages have been added to "warning" namespace within this request.
  • addErrorMessage(string $message) : FlashMessenger: Add a message to "error" namespace.
  • hasCurrentErrorMessages() : bool: Check to see if messages have been added to "error" namespace within this request.
  • addSuccessMessage(string $message) : FlashMessenger: Add a message to "success" namespace.
  • hasCurrentSuccessMessages() :bool: Check to see if messages have been added to "success" namespace within this request.

Additionally, the FlashMessenger implements both IteratorAggregate and Countable, allowing you to iterate over and count the flash messages in the current namespace within the session container.

Examples


public function processAction()
{
    // ... do some work ...
    $this->flashMessenger()->addMessage('You are now logged in.');
    return $this->redirect()->toRoute('user-success');
}

public function successAction()
{
    $return = ['success' => true];
    $flashMessenger = $this->flashMessenger();
    if ($flashMessenger->hasMessages()) {
        $return['messages'] = $flashMessenger->getMessages();
    }
    return $return;
}
      

Copyright

© 2006-2016 by Zend, a Rogue Wave Company.

Contacts

Hide list