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,75 @@
+.. include:: /Includes.rst.txt
+
+.. _deprecation-94654:
+
+====================================================
+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:
+
+* :php:`TYPO3\CMS\Extbase\Domain\Model\BackendUser`
+* :php:`TYPO3\CMS\Extbase\Domain\Model\BackendUserGroup`
+* :php:`TYPO3\CMS\Extbase\Domain\Model\FrontendUser`
+* :php:`TYPO3\CMS\Extbase\Domain\Model\FrontendUserGroup`
+* :php:`TYPO3\CMS\Extbase\Domain\Repository\BackendUserGroupRepository`
+* :php:`TYPO3\CMS\Extbase\Domain\Repository\BackendUserRepository`
+* :php:`TYPO3\CMS\Extbase\Domain\Repository\CategoryRepository`
+* :php:`TYPO3\CMS\Extbase\Domain\Repository\FrontendUserGroupRepository`
+* :php:`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
+:php:`TYPO3\CMS\Extbase\Persistence\Repository` instead and maybe copy
+body methods like :php:`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
+:php:`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 :file:`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
+:file:`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 :php:`recordType` in the mapping file at
+:file:`EXT:extbase/Configuration/Extbase/Persistence/Classes.php`.
+
+
+.. index:: PHP-API, FullyScanned, ext:extbase