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,44 @@
+.. include:: /Includes.rst.txt
+
+.. _deprecation-99638-1674127318:
+
+===================================================
+Deprecation: #99638 - Environment::getBackendPath()
+===================================================
+
+See :issue:`99638`
+
+Description
+===========
+
+TYPO3's backend path `/typo3` is currently resolved statically in
+:php:`Environment::getBackendPath()` to return the full path to the
+backend entrypoint.
+
+However, as TYPO3's code base is evolving, the usages to the hardcoded path have been reduced
+and the functionality is now migrated into a new :php:`BackendEntryPointResolver` class,
+which allows for dynamically adjusting the entry point in the future.
+
+
+Impact
+======
+
+Calling the method will trigger a PHP deprecation warning.
+
+
+Affected installations
+======================
+
+TYPO3 installations with custom extensions using the method in PHP code.
+
+
+Migration
+=========
+
+Check for the extension scanner, and see if the code is necessary, or if any alternative,
+such as the :php:`\TYPO3\CMS\Core\Routing\BackendEntryPointResolver`
+or :php:`\TYPO3\CMS\Core\Http\NormalizedParams` might be better
+suited as third-party extensions should not rely on the hard-coded paths to resources from
+:file:`typo3/*` anymore.
+
+.. index:: PHP-API, FullyScanned, ext:core