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,55 @@
+.. include:: /Includes.rst.txt
+
+.. _breaking-102755-1704381963:
+
+===========================================================
+Breaking: #102755 - Improved getImageResource functionality
+===========================================================
+
+See :issue:`102755`
+
+Description
+===========
+
+The hook :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_content.php']['getImgResource']`
+has been removed in favor of the new PSR-14 event
+:php:`\TYPO3\CMS\Frontend\ContentObject\Event\AfterImageResourceResolvedEvent`.
+
+The new event is using the new :php:`\TYPO3\CMS\Core\Imaging\ImageResource` :abbr:`DTO (Data Transfer Object)`,
+which allows an improved API as developers do no longer have to deal with
+unnamed array keys but benefit from the object-oriented approach, using
+corresponding getter and setter. Therefore, the return types of the following
+methods have been changed to :php:`?ImageResource`:
+
+* :php:`\TYPO3\CMS\Frontend\Imaging\GifBuilder->gifBuild()`
+* :php:`\TYPO3\CMS\Frontend\ContentObject\ContentObjectRenderer->getImgResource()`
+
+Impact
+======
+
+Any registered hook implementation is not executed anymore
+in TYPO3 v13.0+.
+
+Calling the mentioned methods do now return either :php:`null` or an instance
+of the :php:`ImageResource` DTO.
+
+The new Event is also using the new DTO instead of an array.
+
+Affected Installations
+======================
+
+TYPO3 installations with custom extensions using this hook or calling
+mentioned methods directly.
+
+Migration
+=========
+
+The hook is removed without deprecation in order to allow extensions
+to work with TYPO3 v12 (using the hook) and v13+ (using the new event)
+when implementing the event as well without any further deprecations.
+Use the :doc:`PSR-14 event <../13.0/Feature-102755-PSR-14EventForModifyingGetImageResourceResult>`
+to allow greater influence in the functionality.
+
+Additionally, adjust your code to handle the new return types appropriately.
+
+.. index:: Frontend, PHP-API, FullyScanned, ext:frontend