Deprecation: #99586 - Registration of upgrade wizards via $GLOBALS¶
See forge#99586
Description¶
Registration of upgrade wizards via
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/install']['update']
,
usually placed in an extension's ext_localconf.php
has been deprecated
in favor of the new service tag.
Additionally, the \TYPO3\CMS\Install\Updates\UpgradeWizardInterface
, which all upgrade wizards must
implement, does no longer require the getIdentifier()
method. TYPO3 does
not use this method anymore since an upgrade wizard's identifier is now
defined using the new service tag.
Impact¶
Upgrade wizards, registered via
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/install']['update']
will no longer be recognized in TYPO3 v13.
The definition of the getIdentifier()
method has no effect anymore.
Affected installations¶
All installations registering custom upgrade wizards using
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/install']['update']
.
All installations implementing the getIdentifier()
method in their
upgrade wizards.
Migration¶
Use the new service tag to register custom upgrade wizards and remove the
registration via
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/install']['update']
.
Before¶
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/install']['update']['myUpgradeWizard']
= \MyVendor\MyExtension\Updates\MyUpgradeWizard::class;
After¶
namespace MyVendor\MyExtension\Updates;
use TYPO3\CMS\Install\Attribute\UpgradeWizard;
use TYPO3\CMS\Install\Updates\UpgradeWizardInterface;
#[UpgradeWizard('myUpgradeWizard')]
class MyUpgradeWizard implements UpgradeWizardInterface
{
}
Drop any getIdentifier()
method in custom upgrade wizards.