Deprecation: #94619 - Extbase ObjectManager¶
See forge#94619
Description¶
The Extbase ObjectManager as the legacy core object lifecycle and dependency injection solution has been marked discouraged with TYPO3 v10 and its introduction of the Symfony based dependency injection solution already.
TYPO3 v11 no longer uses the Extbase ObjectManager - only in a couple of places as fallback for third party extensions. The entire construct has now been marked as deprecated and will be removed with v12:
TYPO3\CMS\Extbase\Object\ObjectManagerInterface
- Main interfaceTYPO3\CMS\Extbase\Object\ObjectManager
- Main implementationTYPO3\CMS\Extbase\Object\Container\Container
- Internal lifecycle managementTYPO3\CMS\Extbase\Object\Exception
- Base exceptionTYPO3\CMS\Extbase\Object\Exception\CannotBuildObjectException
- Detail exceptionTYPO3\CMS\Extbase\Object\Container\Exception\CannotReconstituteObjectException
- Detail exceptionTYPO3\CMS\Extbase\Object\Container\Exception\UnknownObjectException
- Detail exceptionTYPO3\CMS\Extbase\SignalSlot\Exception\InvalidSlotException
- Detail exception, obsolete by deprecation of Extbase signal slot dispatcher already.TYPO3\CMS\Extbase\SignalSlot\Exception\InvalidSlotReturnException
- Detail exception, obsolete by deprecation of Extbase signal slot dispatcher already.
Impact¶
Directly or indirectly calling \TYPO3\CMS\Extbase\Object\ObjectManager->get()
will trigger a PHP E_USER_DEPRECATED
error.
Affected Installations¶
Extensions that have been properly cleaned up for TYPO3 v10 compatibility are not affected.
Extensions still relying on Extbase ObjectManager are strongly encouraged to
switch to \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance()
and
Symfony based DI instead.
The extension scanner will find usages of the above classes and interfaces and shows them as deprecated with a strong match.
Migration¶
Documentation of migration paths have been established with TYPO3 v10 documentation already. The TYPO3 explained dependency injection section and the ObjectManager->get() v10 changelog entry are especially helpful.