[BUGFIX] Add more migration hints for config.tx_extbase.objects
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Deprecation-86270-ExtbaseXclassViaTypoScriptSettings.rst
1 .. include:: ../../Includes.txt
2
3 ==============================================================================
4 Deprecation: #86270 - config.tx_extbase.objects and plugin.tx_%plugin%.objects
5 ==============================================================================
6
7 See :issue:`86270`
8
9 Description
10 ===========
11
12 The :ts:`config.tx_extbase.objects` and :ts:`plugin.tx_%plugin%.objects` configuration options have been marked as deprecated.
13
14
15 Impact
16 ======
17
18 Configuring class overrides using :ts:`config.tx_extbase.objects` or :ts:`plugin.tx_%plugin%.objects` will log a
19 deprecation warning.
20
21
22 Affected Installations
23 ======================
24
25 All installations that make use of the TypoScript :ts:`config.tx_extbase.objects` or :ts:`plugin.tx_%plugin%.objects`
26 configuration options are affected.
27
28
29 Migration
30 =========
31
32 Use XCLASSes configured in :file:`ext_localconf.php` using
33 :php:`$GLOBALS['TYPO3_CONF_VARS']['SYS']['Objects']`.
34
35 Register implementations in the Extbase object container instead if you need to override classes
36 that are processed by the :php:`PropertyMapper` like domain models or if you rely on additional
37 injections:
38
39 .. code-block:: php
40
41    GeneralUtility::makeInstance(\TYPO3\CMS\Extbase\Object\Container\Container::class)
42        ->registerImplementation(Base::class, Override::class);
43
44 If you conditionally configured :ts:`config.tx_extbase.objects` or
45 :ts:`plugin.tx_%plugin%.objects`, then move that conditional logic into the
46 overriding class itself.
47
48 .. index:: TypoScript, NotScanned, ext:extbase