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,58 @@
+..  include:: /Includes.rst.txt
+
+..  _breaking-107783-1760945127:
+
+=======================================================================================
+Breaking: #107783 - Registration of metadata extractors via `registerExtractionService`
+=======================================================================================
+
+See :issue:`107783`
+
+Description
+===========
+
+The method
+:php:`\TYPO3\CMS\Core\Resource\Index\ExtractorRegistry::registerExtractionService()`
+has been removed in favor of automatic registration via the interface
+:php:`\TYPO3\CMS\Core\Resource\Index\ExtractorInterface`.
+
+Registration of metadata extractors now happens automatically when a class
+implements the required interface
+:php-short:`\TYPO3\CMS\Core\Resource\Index\ExtractorInterface`. No further
+registration is necessary.
+
+Impact
+======
+
+Any call to :php:`ExtractorRegistry::registerExtractionService()` is now a
+no-op and has no effect in TYPO3 v14.0+. Metadata extractors are automatically
+registered via the interface.
+
+Affected installations
+======================
+
+TYPO3 installations with custom extensions that register metadata extractor
+classes via the mentioned method in :file:`ext_localconf.php`.
+
+The extension scanner will report such usages.
+
+Migration
+=========
+
+The method has been removed without deprecation in order to allow extensions
+to work with TYPO3 v13 (using the registration method) and v14+ (using automatic
+interface-based registration) without additional deprecations.
+
+Remove the manual registration from :file:`ext_localconf.php`:
+
+..  code-block:: diff
+    :caption: EXT:my_ext/ext_localconf.php
+
+    - $extractorRegistry = GeneralUtility::makeInstance(ExtractorRegistry::class);
+    - $extractorRegistry->registerExtractionService(MyExtractor::class);
+
+Since custom extractors already implement the required interface
+:php-short:`\TYPO3\CMS\Core\Resource\Index\ExtractorInterface`, no further
+changes are required inside the extractor class itself.
+
+..  index:: FAL, PHP-API, FullyScanned, ext:core