Feature: #94117 - Improve Extbase type converter registration

See forge#94117

Description

Extbase type converters are an important part of the Extbase data and property mapping mechanism. Those converters usually convert data from simple types to objects or other simple types.

Extension authors can add their own type converters. This was previously done by registering the type converter class in the ext_localconf.php file and adding the configuration, such as the sourceType, the targetType or the priority as class properties, accessible via public methods.

This has now been improved. Type converters are now registered as container services in the extension's Services.yaml file by tagging the service with extbase.type_converter and adding the configuration as tag attributes.

This means, the registration via php:\TYPO3\CMS\Extbase\Utility\ExtensionUtility::registerTypeConverter() can be removed together with the configuration related class properties and methods. See changelog for more information.

Impact

Registration is now done in your Services.yaml like the following:

services:
  Vendor\Extension\Property\TypeConverter\MyBooleanConverter:
    tag:
      - name: extbase.type_converter
        priority: 10
        target: boolean
        sources: boolean,string

Tip

Tag arguments (priority, target, sources, etc.) have to be simple types. Don't register the sources as array but as comma separated list as shown in the example.

Note

Since the configuration (priority, target and sources) are now done at this place, respective type converter properties are now superfluous and will also no longer be evaluated. See the deprecation changelog for more information.