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,117 @@
+..  include:: /Includes.rst.txt
+
+..  _breaking-108055-1762951248:
+
+==================================================================
+Breaking: #108055 - Removed PageRenderer related hooks and methods
+==================================================================
+
+See :issue:`108055`
+
+Description
+===========
+
+The removal of frontend asset concatenation and compression as described in
+:ref:`breaking-108055-1762346705` has some impact on the PHP API as well,
+mainly due to removed code.
+
+The following methods have been removed from the class
+:php-short:`\TYPO3\CMS\Core\Page\PageRenderer`:
+
+*   :php:`disableConcatenateCss()`
+*   :php:`enableConcatenateCss()`
+*   :php:`getConcatenateCss()`
+*   :php:`disableCompressCss()`
+*   :php:`enableCompressCss()`
+*   :php:`getCompressCss()`
+*   :php:`disableConcatenateJavascript()`
+*   :php:`enableConcatenateJavascript()`
+*   :php:`getConcatenateJavascript()`
+*   :php:`disableCompressJavascript()`
+*   :php:`enableCompressJavascript()`
+*   :php:`getCompressJavascript()`
+
+The following global configuration registry points have been removed:
+
+*   :php:`$GLOBALS['TYPO3_CONF_VARS']['FE']['cssConcatenateHandler']`
+*   :php:`$GLOBALS['TYPO3_CONF_VARS']['FE']['cssCompressHandler']`
+*   :php:`$GLOBALS['TYPO3_CONF_VARS']['FE']['jsConcatenateHandler']`
+*   :php:`$GLOBALS['TYPO3_CONF_VARS']['FE']['jsCompressHandler']`
+
+The following hook has been removed:
+
+*   :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_div.php']['minifyJavaScript']`
+
+The following methods of :php-short:`\TYPO3\CMS\Core\Page\PageRenderer` changed
+their signature. The noted arguments are now unused:
+
+*   :php:`addJsInlineCode()`: third argument unused
+*   :php:`addCssInlineBlock()`: third argument unused
+*   :php:`addJsFile()`: third and sixth argument unused
+*   :php:`addJsFooterInlineCode()`: third argument unused
+*   :php:`addJsFooterFile()`: third and sixth argument unused
+*   :php:`addJsLibrary()`: fourth and seventh argument unused
+*   :php:`addJsFooterLibrary()`: fourth and seventh argument unused
+*   :php:`addCssFile()`: fifth and eighth argument unused
+*   :php:`addCssLibrary()`: fifth and eighth argument unused
+
+Additionally, registered hooks for:
+
+*   :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_pagerenderer.php']['render-preProcess']`
+*   :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_pagerenderer.php']['render-postTransform']`
+*   :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_pagerenderer.php']['render-postProcess']`
+
+no longer receive the array keys :php:`compress` or
+:php:`excludeFromConcatenation` inside the following data array keys:
+
+*   :php:`jsFiles`
+*   :php:`jsInline`
+*   :php:`jsLibs`
+*   :php:`cssFiles`
+*   :php:`cssInline`
+*   :php:`cssLibs`
+
+Impact
+======
+
+Calling any of the removed methods listed above will raise PHP fatal errors.
+Registrations for removed hooks are no longer executed. Submitting ignored
+arguments has no effect anymore, and hook consumers receive slightly different
+data from the TYPO3 Core due to removed TypoScript configuration values.
+
+Affected installations
+======================
+
+Instances with extensions dealing with low level asset manipulation may be
+affected. The extension scanner will find affected extensions when they call
+removed methods or hooks.
+
+Migration
+=========
+
+There is no direct one-to-one migration in this case.
+
+In general, extensions must no longer expect the existence of code related to
+the TypoScript configuration options :typoscript:`config.compressCss`,
+:typoscript:`config.compressJs`, :typoscript:`config.concatenateCss`,
+:typoscript:`config.concatenateJs`, and the :typoscript:`resource` properties
+:typoscript:`disableCompression` and :typoscript:`excludeFromConcatenation`.
+
+The removed hooks and "handlers" can be turned into listeners of:
+
+*   :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_pagerenderer.php']['render-preProcess']`
+*   :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_pagerenderer.php']['render-postTransform']`
+*   :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_pagerenderer.php']['render-postProcess']`
+
+depending on their needs.
+
+Existing hook registrations of these three should check whether the
+implementations access the array keys :php:`compress` and
+:php:`excludeFromConcatenation` and avoid doing so. If required, affected code
+may need to determine TypoScript options from the :php:`$GLOBALS['TYPO3_REQUEST']`
+request attribute :php:`frontend.typoscript` directly.
+
+Another alternative is to avoid hook usage altogether by turning the
+implementations into PSR-15 middlewares instead.
+
+..  index:: PHP-API, PartiallyScanned, ext:core