Feature: #99586 - Registration of upgrade wizards via service tag¶
See forge#99586
Description¶
Upgrade wizards are used to execute one time migrations when
updating a TYPO3 installation. The registration was previously done
in an extension's ext_localconf.php
file. This has now been
improved by introducing the custom PHP attribute
\TYPO3\CMS\Install\Attribute\UpgradeWizard
. All upgrade wizards,
defining the new attribute, are automatically tagged and registered
in the service container. The registration via
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/install']['update']
has been deprecated.
The registration of an upgrade wizard is therefore now be done directly in the class by adding the new attribute with the upgrade wizard's unique identifier as constructor argument:
use TYPO3\CMS\Install\Attribute\UpgradeWizard;
use TYPO3\CMS\Install\Updates\UpgradeWizardInterface;
#[UpgradeWizard('myUpgradeWizard')]
class MyUpgradeWizard implements UpgradeWizardInterface
{
}
Note
All upgrade wizards have to implement the
\TYPO3\CMS\Install\Updates\UpgradeWizardInterface
.
Impact¶
It is now possible to tag upgrade wizards with the PHP attribute
\TYPO3\CMS\Install\Attribute\UpgradeWizard
to have them
auto-configured and auto-registered.