TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:09 +02:00
commit af8cc155b5
6818 changed files with 642608 additions and 0 deletions
@@ -0,0 +1,60 @@
+.. include:: /Includes.rst.txt
+
+.. _breaking-102715-1703254781:
+
+===================================================================
+Breaking: #102715 - Frontend "determineId()" related events changed
+===================================================================
+
+See :issue:`102715`
+
+Description
+===========
+
+With the continued refactoring of :php:`\TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController`,
+the following events have been adapted:
+
+* :php:`\TYPO3\CMS\Frontend\Event\BeforePageIsResolvedEvent`
+* :php:`\TYPO3\CMS\Frontend\Event\AfterPageWithRootLineIsResolvedEvent`
+* :php:`\TYPO3\CMS\Frontend\Event\AfterPageAndLanguageIsResolvedEvent`
+
+The three events no longer retrieve an instance of :php:`TypoScriptFrontendController`, the
+getter methods :php:`getController()` have been removed: The controller is instantiated
+*after* the events have been dispatched, event listeners can no longer work with this
+object.
+
+Instead, the events now contain an instance of the new :abbr:`DTO (Data Transfer Object)`
+:php:`\TYPO3\CMS\Frontend\Page\PageInformation`, which can be retrieved and
+manipulated by event listeners if necessary.
+
+Impact
+======
+
+Calling :php:`getController()` by consumers of above events will raise a fatal
+PHP error.
+
+Also note the events may not be dispatched anymore when the middleware
+:php:`\TYPO3\CMS\Frontend\Middleware\TypoScriptFrontendInitialization` creates
+early responses.
+
+
+Affected installations
+======================
+
+Those events are in place for a couple of special cases during early frontend rendering.
+Most instances will not be affected, but some extensions may register event listeners.
+
+
+Migration
+=========
+
+Use method :php:`getPageInformation()` instead to retrieve 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 :php:`setPageInformation()`.
+
+In case middleware :php:`TypoScriptFrontendInitialization` no longer dispatches an event
+when it created an early response on its own, an own middleware can be added around
+that middleware to retrieve and further manipulate a response if needed.
+
+
+.. index:: Frontend, PHP-API, PartiallyScanned, ext:frontend