BeforePageIsResolvedEvent

Changed in version 13.0

The event no longer receives an instance of TypoScriptFrontendController, the getController() method has been removed: The controller is instantiated after the event has been dispatched, event listeners can no longer work with this object.

Instead, the event now contains an instance of the new DTO \TYPO3\CMS\Frontend\Page\PageInformation, which can be retrieved and manipulated by event listeners, if necessary.

See Migration.

The PSR-14 event \TYPO3\CMS\Frontend\Event\BeforePageIsResolvedEvent is fired before the frontend process is trying to fully resolve a given page by its page ID and the request.

The events may not be dispatched anymore when the middleware \TYPO3\CMS\Frontend\Middleware\TypoScriptFrontendInitialization creates early responses.

Tip

There are three events in the process around the resolving of a page and its root line or language based on the incoming request. They are triggered in the following order:

Example

Note

Currently, we do not have an example for this event. If you can provide a useful one, please open an issue with your code snippets or a pull request.

API

class BeforePageIsResolvedEvent

Fully qualified name: \TYPO3\CMS\Frontend\Event\BeforePageIsResolvedEvent

A PSR-14 event fired before the frontend process is trying to fully resolve a given page by its page ID and the request.

Event Listeners can modify incoming parameters (such as $controller->id) or modify the context for resolving a page.

getRequest ( )

Returns: \Psr\Http\Message\ServerRequestInterface

getPageInformation ( )

Returns: \TYPO3\CMS\Frontend\Page\PageInformation

setPageInformation ( \TYPO3\CMS\Frontend\Page\PageInformation $pageInformation)

param $pageInformation: the pageInformation

Migration

Use the method getPageInformation() to retrieve the calculated page state at this point in the frontend rendering chain. Event listeners that manipulate that object should set it again within the event using setPageInformation().

In case the middleware TypoScriptFrontendInitialization no longer dispatches an event when it created an early response on its own, a custom middleware can be added around that middleware to retrieve and further manipulate a response if needed.