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,80 @@
+.. include:: /Includes.rst.txt
+
+.. _deprecation-99586-1673990657:
+
+==================================================================
+Deprecation: #99586 - Registration of upgrade wizards via $GLOBALS
+==================================================================
+
+See :issue:`99586`
+
+Description
+===========
+
+Registration of upgrade wizards via
+:php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/install']['update']`,
+usually placed in an extension's :file:`ext_localconf.php` has been deprecated
+in favor of the :ref:`new service tag <feature-99586-1673989775>`.
+
+Additionally, the :php:`\TYPO3\CMS\Install\Updates\UpgradeWizardInterface`, which all upgrade wizards must
+implement, does no longer require the :php:`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
+:php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/install']['update']`
+will no longer be recognized in TYPO3 v13.
+
+The definition of the :php:`getIdentifier()` method has no effect anymore.
+
+
+Affected installations
+======================
+
+All installations registering custom upgrade wizards using
+:php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/install']['update']`.
+
+All installations implementing the :php:`getIdentifier()` method in their
+upgrade wizards.
+
+
+Migration
+=========
+
+Use the new service tag to register custom upgrade wizards and remove the
+registration via
+:php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/install']['update']`.
+
+Before
+~~~~~~
+
+..  code-block:: php
+    :caption: EXT:my_extension/ext_localconf.php
+
+    $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/install']['update']['myUpgradeWizard']
+        = \MyVendor\MyExtension\Updates\MyUpgradeWizard::class;
+
+After
+~~~~~
+
+..  code-block:: php
+    :caption: EXT:my_extension/Classes/Updates/MyUpgradeWizard.php
+
+    namespace MyVendor\MyExtension\Updates;
+
+    use TYPO3\CMS\Install\Attribute\UpgradeWizard;
+    use TYPO3\CMS\Install\Updates\UpgradeWizardInterface;
+
+    #[UpgradeWizard('myUpgradeWizard')]
+    class MyUpgradeWizard implements UpgradeWizardInterface
+    {
+
+    }
+
+Drop any :php:`getIdentifier()` method in custom upgrade wizards.
+
+.. index:: Backend, PHP-API, FullyScanned, ext:install