Files
cms-core/Documentation/Changelog/9.3/Deprecation-85113-LegacyBackendModuleRoutingMethods.rst

50 lines
1.2 KiB
ReStructuredText

.. include:: /Includes.rst.txt
.. _deprecation-85113:
===========================================================
Deprecation: #85113 - Legacy Backend Module Routing methods
===========================================================
See :issue:`85113`
Description
===========
In TYPO3 v9, Backend routing was unified to be handled via the "route" query string parameter. Backend modules
are now automatically registered to be a backend route.
The following methods are thus deprecated in favor of using the method above.
* :php:`BackendUtility::getModuleUrl()`
* :php:`UriBuilder->buildUriFromModule()`
Impact
======
Calling one of the deprecated methods above will trigger a PHP :php:`E_USER_DEPRECATED` error.
Affected Installations
======================
Any TYPO3 installation with a custom backend-related extension using one of the methods directly in a PHP context.
Migration
=========
Use :php:`UriBuilder->buildUriFromRoute($moduleIdentifier)` instead.
For example ::
BackendUtility::getModuleUrl('record_edit', $uriParameters);
becomes ::
$uriBuilder = GeneralUtility::makeInstance(UriBuilder::class);
$uriBuilder->buildUriFromRoute('record_edit', $uriParameters);
.. index:: Backend, PHP-API, FullyScanned