TYPO3 CMS  TYPO3_8-7
TYPO3\CMS\Core\Messaging\FlashMessageQueue Class Reference
Inheritance diagram for TYPO3\CMS\Core\Messaging\FlashMessageQueue:

Public Member Functions

 __construct ($identifier)
 
 getIdentifier ()
 
 enqueue ($message)
 
 addMessage (FlashMessage $message)
 
 dequeue ()
 
 getAllMessages ($severity=null)
 
 getAllMessagesAndFlush ($severity=null)
 
 renderFlashMessages (FlashMessageRendererInterface $flashMessageRenderer=null)
 
 toArray ()
 
 clear ($severity=null)
 

Protected Member Functions

 addFlashMessageToSession (FlashMessage $message)
 
 storeFlashMessagesInSession (array $flashMessages=null)
 
 removeAllFlashMessagesFromSession ($severity=null)
 
 getFlashMessagesFromSession ()
 
 getUserByContext ()
 

Protected Attributes

 $identifier
 

Detailed Description

A class which collects and renders flash messages.

Definition at line 24 of file FlashMessageQueue.php.

Constructor & Destructor Documentation

◆ __construct()

TYPO3\CMS\Core\Messaging\FlashMessageQueue::__construct (   $identifier)
Parameters
string$identifierThe unique identifier for this queue

Definition at line 36 of file FlashMessageQueue.php.

References TYPO3\CMS\Core\Messaging\FlashMessageQueue\$identifier.

Member Function Documentation

◆ addFlashMessageToSession()

TYPO3\CMS\Core\Messaging\FlashMessageQueue::addFlashMessageToSession ( FlashMessage  $message)
protected

Adds the given flash message to the array of flash messages that will be stored in the session.

Parameters
FlashMessage$message

Definition at line 93 of file FlashMessageQueue.php.

References TYPO3\CMS\Core\Messaging\FlashMessageQueue\getFlashMessagesFromSession(), and TYPO3\CMS\Core\Messaging\FlashMessageQueue\storeFlashMessagesInSession().

Referenced by TYPO3\CMS\Core\Messaging\FlashMessageQueue\enqueue().

◆ addMessage()

TYPO3\CMS\Core\Messaging\FlashMessageQueue::addMessage ( FlashMessage  $message)
Parameters
FlashMessage$message

Definition at line 74 of file FlashMessageQueue.php.

References TYPO3\CMS\Core\Messaging\FlashMessageQueue\enqueue().

◆ clear()

TYPO3\CMS\Core\Messaging\FlashMessageQueue::clear (   $severity = null)

Removes all items from the queue

Parameters
int$severityOptional severity, must be one of constants

Definition at line 236 of file FlashMessageQueue.php.

Referenced by TYPO3\CMS\Core\Messaging\FlashMessageQueue\getAllMessagesAndFlush().

◆ dequeue()

TYPO3\CMS\Core\Messaging\FlashMessageQueue::dequeue ( )

This method is empty, as it will not move any flash message (e.g. from the session)

Definition at line 82 of file FlashMessageQueue.php.

◆ enqueue()

TYPO3\CMS\Core\Messaging\FlashMessageQueue::enqueue (   $message)

Adds a message either to the BE_USER session (if the $message has the storeInSession flag set) or it enqueues the message.

Parameters
FlashMessage$messageInstance of , representing a message
Exceptions

Definition at line 56 of file FlashMessageQueue.php.

References TYPO3\CMS\Core\Messaging\FlashMessageQueue\addFlashMessageToSession().

Referenced by TYPO3\CMS\Core\Messaging\FlashMessageQueue\addMessage(), and TYPO3\CMS\Core\FormProtection\FormProtectionFactory\isFrontendSession().

◆ getAllMessages()

TYPO3\CMS\Core\Messaging\FlashMessageQueue::getAllMessages (   $severity = null)

Returns all messages from the current PHP session and from the current request.

Parameters
int$severityOptional severity, must be one of constants
Returns
FlashMessage[]

Definition at line 106 of file FlashMessageQueue.php.

References TYPO3\CMS\Core\Messaging\FlashMessageQueue\getFlashMessagesFromSession(), and TYPO3\CMS\Core\Messaging\FlashMessageQueue\toArray().

Referenced by TYPO3\CMS\Core\Messaging\FlashMessageQueue\getAllMessagesAndFlush().

◆ getAllMessagesAndFlush()

TYPO3\CMS\Core\Messaging\FlashMessageQueue::getAllMessagesAndFlush (   $severity = null)

Returns all messages from the current PHP session and from the current request. After fetching the messages the internal queue and the message queue in the session will be emptied.

Parameters
int$severityOptional severity, must be one of constants
Returns
FlashMessage[]

Definition at line 132 of file FlashMessageQueue.php.

References TYPO3\CMS\Core\Messaging\FlashMessageQueue\clear(), TYPO3\CMS\Core\Messaging\FlashMessageQueue\getAllMessages(), and TYPO3\CMS\Core\Messaging\FlashMessageQueue\removeAllFlashMessagesFromSession().

Referenced by TYPO3\CMS\Core\Messaging\FlashMessageQueue\renderFlashMessages().

◆ getFlashMessagesFromSession()

TYPO3\CMS\Core\Messaging\FlashMessageQueue::getFlashMessagesFromSession ( )
protected

◆ getIdentifier()

TYPO3\CMS\Core\Messaging\FlashMessageQueue::getIdentifier ( )
Returns
string

Definition at line 44 of file FlashMessageQueue.php.

References TYPO3\CMS\Core\Messaging\FlashMessageQueue\$identifier.

◆ getUserByContext()

TYPO3\CMS\Core\Messaging\FlashMessageQueue::getUserByContext ( )
protected

Gets user object by context

Returns
AbstractUserAuthentication

Definition at line 189 of file FlashMessageQueue.php.

References $GLOBALS.

Referenced by TYPO3\CMS\Core\Messaging\FlashMessageQueue\getFlashMessagesFromSession(), and TYPO3\CMS\Core\Messaging\FlashMessageQueue\storeFlashMessagesInSession().

◆ removeAllFlashMessagesFromSession()

TYPO3\CMS\Core\Messaging\FlashMessageQueue::removeAllFlashMessagesFromSession (   $severity = null)
protected

Removes all flash messages from the session

Parameters
int$severityOptional severity, must be one of constants

Definition at line 157 of file FlashMessageQueue.php.

References TYPO3\CMS\Core\Messaging\FlashMessageQueue\getFlashMessagesFromSession(), and TYPO3\CMS\Core\Messaging\FlashMessageQueue\storeFlashMessagesInSession().

Referenced by TYPO3\CMS\Core\Messaging\FlashMessageQueue\getAllMessagesAndFlush().

◆ renderFlashMessages()

TYPO3\CMS\Core\Messaging\FlashMessageQueue::renderFlashMessages ( FlashMessageRendererInterface  $flashMessageRenderer = null)

Fetches and renders all available flash messages from the queue.

Parameters
FlashMessageRendererInterface | null$flashMessageRenderer
Returns
string All flash messages in the queue rendered by context based FlashMessageRendererResolver.

Definition at line 200 of file FlashMessageQueue.php.

References TYPO3\CMS\Core\Messaging\FlashMessageQueue\getAllMessagesAndFlush(), and TYPO3\CMS\Core\Utility\GeneralUtility\makeInstance().

◆ storeFlashMessagesInSession()

TYPO3\CMS\Core\Messaging\FlashMessageQueue::storeFlashMessagesInSession ( array  $flashMessages = null)
protected

◆ toArray()

TYPO3\CMS\Core\Messaging\FlashMessageQueue::toArray ( )

Returns all items of the queue as array

Returns
FlashMessage[]

Definition at line 220 of file FlashMessageQueue.php.

Referenced by TYPO3\CMS\Core\Messaging\FlashMessageQueue\getAllMessages().

Member Data Documentation

◆ $identifier

TYPO3\CMS\Core\Messaging\FlashMessageQueue::$identifier
protected