Deprecation: #94654 - Generic Extbase domain classes

See Issue #94654

Description

Most Extbase “generic” domain model and repositories have been marked as deprecated: They are opinionated implementations and can’t be “correct” since the domains they are used in are unique.

The following classes have been marked as deprecated:

  • TYPO3\CMS\Extbase\Domain\Model\BackendUser
  • TYPO3\CMS\Extbase\Domain\Model\BackendUserGroup
  • TYPO3\CMS\Extbase\Domain\Model\FrontendUser
  • TYPO3\CMS\Extbase\Domain\Model\FrontendUserGroup
  • TYPO3\CMS\Extbase\Domain\Repository\BackendUserGroupRepository
  • TYPO3\CMS\Extbase\Domain\Repository\BackendUserRepository
  • TYPO3\CMS\Extbase\Domain\Repository\CategoryRepository
  • TYPO3\CMS\Extbase\Domain\Repository\FrontendUserGroupRepository
  • TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository

Impact

Using or extending the above classes is deprecated since TYPO3 v11. They will be removed with TYPO3 v12.

Affected Installations

Various Extbase based extensions may use or extend the classes. The extension scanner will find usages with a strong match.

Migration

The migration paths are usually straight forward.

Extensions that extend the repository classes should extend Extbase TYPO3\CMS\Extbase\Persistence\Repository instead and maybe copy body methods like initializeObject() if given and not overridden already.

Extensions that use the Extbase repositories directly should copy the class to their extension namespace and use the own ones instead.

Extensions that extend the model classes should extend TYPO3\CMS\Extbase\DomainObject\AbstractEntity instead and copy the properties, getters and setters they need from the Extbase classes. Those copied properties may need database mapping entries, which can be copied from EXT:extbase/Configuration/Extbase/Persistence/Classes.php.

Extensions that use the Extbase models directly should copy the class to their extension namespace, ideally strip them down to what the extension actually needs, and copy the needed mapping information from EXT:extbase/Configuration/Extbase/Persistence/Classes.php.

No database update of existing rows should be needed when transferring the models to an own namespace, since none of the Extbase models configured a recordType in the mapping file at EXT:extbase/Configuration/Extbase/Persistence/Classes.php.