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,127 @@
+..  include:: /Includes.rst.txt
+
+..  _deprecation-109438-1774951763:
+
+====================================================
+Deprecation: #109438 - ext_tables.php in extensions
+====================================================
+
+See :issue:`109438`
+
+Description
+===========
+
+Extensions that still ship an :file:`ext_tables.php` file will now trigger
+a PHP :php:`E_USER_DEPRECATED` error when the file is loaded during
+a non-cached request or cache warm-up.
+
+The :file:`ext_tables.php` file was historically used to register backend
+modules, page doktypes, user settings, and other runtime configuration.
+All of these use cases now have dedicated alternatives in modern TYPO3:
+
+*  Backend modules: :file:`Configuration/Backend/Modules.php`
+*  Backend routes: :file:`Configuration/Backend/Routes.php`
+*  User settings: :file:`Configuration/TCA/Overrides/be_users.php`
+   (see :issue:`108843`)
+*  Page doktype allowed record types: :file:`Configuration/TCA/Overrides/pages.php`
+   (see :issue:`108557`)
+
+Impact
+======
+
+A PHP :php:`E_USER_DEPRECATED` error is triggered for every third-party
+extension that still provides an :file:`ext_tables.php` file whenever
+:file:`ext_tables.php` files are loaded without caching, for example during
+cache warm-up or in a development context.
+
+Support for :file:`ext_tables.php` will be removed in TYPO3 v15.0.
+
+Affected installations
+======================
+
+All installations with third-party extensions that still ship an
+:file:`ext_tables.php` file.
+
+Migration
+=========
+
+Move all registration from :file:`ext_tables.php` to the appropriate
+configuration files.
+
+User settings
+-------------
+
+User settings previously registered via
+:php:`TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addFieldsToUserSettings()` in
+:file:`ext_tables.php` should now be registered via
+:php:`TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addUserSetting()` in
+:file:`Configuration/TCA/Overrides/be_users.php`.
+
+Before:
+
+..  code-block:: php
+    :caption: ext_tables.php
+
+    use TYPO3\CMS\Core\Utility\ExtensionManagementUtility;
+
+    $GLOBALS['TYPO3_USER_SETTINGS']['columns']['myCustomSetting'] = [
+        'type' => 'check',
+        'label' => 'LLL:EXT:my_ext/Resources/Private/Language/locallang.xlf:myCustomSetting',
+    ];
+    ExtensionManagementUtility::addFieldsToUserSettings(
+        'myCustomSetting',
+        'after:emailMeAtLogin'
+    );
+
+
+After:
+
+..  code-block:: php
+    :caption: Configuration/TCA/Overrides/be_users.php
+
+    use TYPO3\CMS\Core\Utility\ExtensionManagementUtility;
+
+    ExtensionManagementUtility::addUserSetting(
+        'myCustomSetting',
+        [
+            'label' => 'LLL:EXT:my_ext/Resources/Private/Language/locallang.xlf:myCustomSetting',
+            'config' => [
+                'type' => 'check',
+                'renderType' => 'checkboxToggle',
+            ],
+        ],
+        'after:emailMeAtLogin'
+    );
+
+Page doktype allowed record types
+----------------------------------
+
+Page doktypes previously registered via :php:`PageDoktypeRegistry->add()` in
+:file:`ext_tables.php` should now use the TCA option
+:php:`allowedRecordTypes` in :file:`Configuration/TCA/Overrides/pages.php`.
+
+Before:
+
+..  code-block:: php
+    :caption: ext_tables.php
+
+    \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance(
+        \TYPO3\CMS\Core\DataHandling\PageDoktypeRegistry::class
+    )->add(116, [
+        'allowedTables' => ['tt_content', 'my_custom_record'],
+    ]);
+
+After:
+
+..  code-block:: php
+    :caption: Configuration/TCA/Overrides/pages.php
+
+    $GLOBALS['TCA']['pages']['types']['116']['allowedRecordTypes'] = [
+        'tt_content',
+        'my_custom_record',
+    ];
+
+Once all registrations have been moved, the :file:`ext_tables.php` file
+can be removed from the extension.
+
+..  index:: PHP-API, NotScanned, ext:core