56 lines
1.9 KiB
ReStructuredText
56 lines
1.9 KiB
ReStructuredText
.. 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
|