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,46 @@
+
+.. include:: /Includes.rst.txt
+
+.. _deprecation-51482:
+
+==========================================
+Deprecation: #51482 - Script-based modules
+==========================================
+
+See :issue:`51482`
+
+Description
+===========
+
+Pseudo-modules that are registered via `ExtensionManagementUtility::addModulePath()` and
+modules that are registered via `ExtensionManagementUtility::addModule()` using the fourth parameter
+as a custom script-path have been marked as deprecated.
+
+The method `ExtensionManagementUtility::addModulePath()` itself has been marked as deprecated.
+
+
+Impact
+======
+
+All existing modules which are not registered via Routing will trigger a deprecation entry on registration
+of the module and when calling the module directly.
+
+
+Affected Installations
+======================
+
+All third-party extensions registering a wizard, module or route without using routeTarget or Routes.php,
+which have been introduced with TYPO3 CMS 7.
+
+
+Migration
+=========
+
+Use Configuration/Backend/Routes.php to register wizards and use
+`ExtensionManagementUtility::addModule()` when registering a routePath option in the fifth parameter to
+use the proper PSR-7 compatible way of registering and calling modules.
+Make sure to use UriBuilder and `BackendUtility::getModuleUrl()` to link to these modules instead of
+hard-linking to the script names.
+
+
+.. index:: PHP-API, Backend