class Messenger in Drupal 8

The messenger service.

Hierarchy

• class \Drupal\Core\Messenger\Messenger implements MessengerInterface

1 file declares its use of Messenger

MessengerLegacyTest.php in core/tests/Drupal/KernelTests/Core/Messenger/MessengerLegacyTest.php

1 string reference to 'Messenger'

core.services.yml in core/core.services.yml

core/core.services.yml

1 service uses Messenger

messenger in core/core.services.yml

Drupal\Core\Messenger\Messenger

File

core/lib/Drupal/Core/Messenger/Messenger.php, line 13

Namespace

Drupal\Core\Messenger

class Messenger implements MessengerInterface {

  /**
   * The flash bag.
   *
   * @var \Symfony\Component\HttpFoundation\Session\Flash\FlashBagInterface
   */
  protected $flashBag;

  /**
   * The kill switch.
   *
   * @var \Drupal\Core\PageCache\ResponsePolicy\KillSwitch
   */
  protected $killSwitch;

  /**
   * Messenger constructor.
   *
   * @param \Symfony\Component\HttpFoundation\Session\Flash\FlashBagInterface $flash_bag
   *   The flash bag.
   * @param \Drupal\Core\PageCache\ResponsePolicy\KillSwitch $killSwitch
   *   The kill switch.
   */
  public function __construct(FlashBagInterface $flash_bag, KillSwitch $killSwitch) {
    $this->flashBag = $flash_bag;
    $this->killSwitch = $killSwitch;
  }

  /**
   * {@inheritdoc}
   */
  public function addError($message, $repeat = FALSE) {
    return $this
      ->addMessage($message, static::TYPE_ERROR, $repeat);
  }

  /**
   * {@inheritdoc}
   */
  public function addMessage($message, $type = self::TYPE_STATUS, $repeat = FALSE) {
    if (!$message instanceof Markup && $message instanceof MarkupInterface) {
      $message = Markup::create((string) $message);
    }

    // Do not use strict type checking so that equivalent string and
    // MarkupInterface objects are detected.
    if ($repeat || !in_array($message, $this->flashBag
      ->peek($type))) {
      $this->flashBag
        ->add($type, $message);
    }

    // Mark this page as being uncacheable.
    $this->killSwitch
      ->trigger();
    return $this;
  }

  /**
   * {@inheritdoc}
   */
  public function addStatus($message, $repeat = FALSE) {
    return $this
      ->addMessage($message, static::TYPE_STATUS, $repeat);
  }

  /**
   * {@inheritdoc}
   */
  public function addWarning($message, $repeat = FALSE) {
    return $this
      ->addMessage($message, static::TYPE_WARNING, $repeat);
  }

  /**
   * {@inheritdoc}
   */
  public function all() {
    return $this->flashBag
      ->peekAll();
  }

  /**
   * {@inheritdoc}
   */
  public function deleteAll() {
    return $this->flashBag
      ->clear();
  }

  /**
   * {@inheritdoc}
   */
  public function deleteByType($type) {

    // Flash bag gets and clears flash messages from the stack.
    return $this->flashBag
      ->get($type);
  }

  /**
   * {@inheritdoc}
   */
  public function messagesByType($type) {
    return $this->flashBag
      ->peek($type);
  }

}

Members

Name	Modifiers	Type	Description	Overrides
Messenger::$flashBag	protected	property	The flash bag.
Messenger::$killSwitch	protected	property	The kill switch.
Messenger::addError	public	function	Adds a new error message to the queue. Overrides MessengerInterface::addError
Messenger::addMessage	public	function	Adds a new message to the queue. Overrides MessengerInterface::addMessage
Messenger::addStatus	public	function	Adds a new status message to the queue. Overrides MessengerInterface::addStatus
Messenger::addWarning	public	function	Adds a new warning message to the queue. Overrides MessengerInterface::addWarning
Messenger::all	public	function	Gets all messages. Overrides MessengerInterface::all
Messenger::deleteAll	public	function	Deletes all messages. Overrides MessengerInterface::deleteAll
Messenger::deleteByType	public	function	Deletes all messages of a certain type. Overrides MessengerInterface::deleteByType
Messenger::messagesByType	public	function	Gets all messages of a certain type. Overrides MessengerInterface::messagesByType
Messenger::__construct	public	function	Messenger constructor.
MessengerInterface::TYPE_ERROR		constant	An error.
MessengerInterface::TYPE_STATUS		constant	A status message.
MessengerInterface::TYPE_WARNING		constant	A warning.