Deprecation: #94654 - Generic Extbase domain classes
See forge#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\ Backend User \TYPO3\
CMS\ Extbase\ Domain\ Model\ Backend User Group \TYPO3\
CMS\ Extbase\ Domain\ Model\ Frontend User \TYPO3\
CMS\ Extbase\ Domain\ Model\ Frontend User Group \TYPO3\
CMS\ Extbase\ Domain\ Repository\ Backend User Group Repository \TYPO3\
CMS\ Extbase\ Domain\ Repository\ Backend User Repository \TYPO3\
CMS\ Extbase\ Domain\ Repository\ Category Repository \TYPO3\
CMS\ Extbase\ Domain\ Repository\ Frontend User Group Repository \TYPO3\
CMS\ Extbase\ Domain\ Repository\ Frontend User Repository
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\
instead and maybe copy
body methods like initialize
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\
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:
.
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:
.
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 record
in the mapping file at
EXT:
.