www.aleph1.co.uk Git - yaffs-website/blob - vendor/symfony/http-foundation/Session/Flash/FlashBagInterface.php

   1 <?php
   2
   3 /*
   4  * This file is part of the Symfony package.
   5  *
   6  * (c) Fabien Potencier <fabien@symfony.com>
   7  *
   8  * For the full copyright and license information, please view the LICENSE
   9  * file that was distributed with this source code.
  10  */
  11
  12 namespace Symfony\Component\HttpFoundation\Session\Flash;
  13
  14 use Symfony\Component\HttpFoundation\Session\SessionBagInterface;
  15
  16 /**
  17  * FlashBagInterface.
  18  *
  19  * @author Drak <drak@zikula.org>
  20  */
  21 interface FlashBagInterface extends SessionBagInterface
  22 {
  23     /**
  24      * Adds a flash message for type.
  25      *
  26      * @param string $type
  27      * @param string $message
  28      */
  29     public function add($type, $message);
  30
  31     /**
  32      * Registers a message for a given type.
  33      *
  34      * @param string       $type
  35      * @param string|array $message
  36      */
  37     public function set($type, $message);
  38
  39     /**
  40      * Gets flash messages for a given type.
  41      *
  42      * @param string $type    Message category type
  43      * @param array  $default Default value if $type does not exist
  44      *
  45      * @return array
  46      */
  47     public function peek($type, array $default = array());
  48
  49     /**
  50      * Gets all flash messages.
  51      *
  52      * @return array
  53      */
  54     public function peekAll();
  55
  56     /**
  57      * Gets and clears flash from the stack.
  58      *
  59      * @param string $type
  60      * @param array  $default Default value if $type does not exist
  61      *
  62      * @return array
  63      */
  64     public function get($type, array $default = array());
  65
  66     /**
  67      * Gets and clears flashes from the stack.
  68      *
  69      * @return array
  70      */
  71     public function all();
  72
  73     /**
  74      * Sets all flash messages.
  75      */
  76     public function setAll(array $messages);
  77
  78     /**
  79      * Has flash messages for a given type?
  80      *
  81      * @param string $type
  82      *
  83      * @return bool
  84      */
  85     public function has($type);
  86
  87     /**
  88      * Returns a list of all defined types.
  89      *
  90      * @return array
  91      */
  92     public function keys();
  93 }