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,56 @@
+.. include:: /Includes.rst.txt
+
+.. _breaking-97926-1657726187:
+
+========================================================
+Breaking: #97926 - Extbase QuerySettings methods removed
+========================================================
+
+See :issue:`97926`
+
+Description
+===========
+
+Extbase's Persistence functionality is basing ORM queries on certain settings
+usually fetched from :php:`QuerySettingsInterface`, with a default
+implementation :php:`Typo3QuerySettings`.
+
+The interface itself has changed so that it now requires two new methods:
+
+:php:`QuerySettingsInterface::getLanguageAspect(): LanguageAspect`
+:php:`QuerySettingsInterface::setLanguageAspect(LanguageAspect $aspect)`
+
+The LanguageAspect covers both the overlay functionality and setting the
+language ID.
+
+For this reason, the following methods are removed from
+:php:`QuerySettingsInterface`:
+
+- :php:`QuerySettingsInterface::getLanguageOverlayMode()`
+- :php:`QuerySettingsInterface::setLanguageOverlayMode($languageOverlayMode)`
+- :php:`QuerySettingsInterface::getLanguageUid()`
+- :php:`QuerySettingsInterface::setLanguageUid($languageUid)`
+
+All adaptions have been made to the default implementation in
+:php:`Typo3QuerySettings`, however the removed methods from the interface are kept
+within the implementation to avoid fatal PHP errors.
+
+Impact
+======
+
+Any custom implementation of :php:`QuerySettingsInterface` needs to implement
+the newly defined methods of the interface.
+
+Affected installations
+======================
+
+TYPO3 installations with custom Extbase extensions dealing with QuerySettings
+that are adjusted with the methods used above.
+
+Migration
+=========
+
+Switch the affected extensions via PHP to calling the newly added methods, as this is
+how TYPO3 Core behaves the most reliable.
+
+.. index:: PHP-API, FullyScanned, ext:extbase