Breaking: #102755 - Improved getImageResource functionality

See forge#102755

Description

The hook $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_content.php']['getImgResource'] has been removed in favor of the new PSR-14 event \TYPO3\CMS\Frontend\ContentObject\Event\AfterImageResourceResolvedEvent.

The new event is using the new \TYPO3\CMS\Core\Imaging\ImageResource DTO, 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 ?ImageResource:

  • \TYPO3\CMS\Frontend\Imaging\GifBuilder->gifBuild()
  • \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 null or an instance of the 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 PSR-14 event to allow greater influence in the functionality.

Additionally, adjust your code to handle the new return types appropriately.