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,79 @@
+..  include:: /Includes.rst.txt
+
+..  _deprecation-107413-1725875222:
+
+==============================================================
+Deprecation: #107413 - PathUtility getRelativePath(to) methods
+==============================================================
+
+See :issue:`107413`
+
+Description
+===========
+
+The following methods in :php:`\TYPO3\CMS\Core\Utility\PathUtility` have been
+marked as deprecated and will be removed in TYPO3 v15.0:
+
+* :php:`PathUtility::getRelativePath()`
+* :php:`PathUtility::getRelativePathTo()`
+
+These methods are no longer needed, as TYPO3's path handling has been
+simplified due to the unification of the entry point URLs.
+
+Since TYPO3 v13, both frontend and backend use the same main entry point
+(:file:`htdocs/index.php`), making relative path calculations obsolete.
+
+Impact
+======
+
+Calling these methods will trigger a PHP deprecation warning. They will
+continue to work as before until they are removed in TYPO3 v15.0.
+
+Affected installations
+======================
+
+TYPO3 installations with custom extensions or code that directly call the
+deprecated methods are affected:
+
+* :php:`PathUtility::getRelativePath()`
+* :php:`PathUtility::getRelativePathTo()`
+
+The extension scanner will report any usage as a **strong match**.
+
+Migration
+=========
+
+Instead of calculating relative paths manually, use absolute paths or the
+appropriate TYPO3 APIs for path handling:
+
+* Use :php:`GeneralUtility::getFileAbsFileName()` for
+  extension resources
+* Use the `EXT:` prefix when referencing extension resources
+* Use :php:`PathUtility::getPublicResourceWebPath()` for
+  public extension resources
+* Reference paths relative to the public web path of the TYPO3 installation
+
+..  code-block:: php
+    :caption: Before (deprecated)
+
+    use TYPO3\CMS\Core\Utility\PathUtility;
+
+    $relativePath = PathUtility::getRelativePath($sourcePath, $targetPath);
+    $relativeToPath = PathUtility::getRelativePathTo($absolutePath);
+
+..  code-block:: php
+    :caption: After (recommended)
+
+    use TYPO3\CMS\Core\Utility\GeneralUtility;
+    use TYPO3\CMS\Core\Utility\PathUtility;
+
+    // Use absolute paths or appropriate TYPO3 APIs
+    $absolutePath = GeneralUtility::getFileAbsFileName(
+        'EXT:my_extension/Resources/Public/file.js'
+    );
+
+    $webPath = PathUtility::getPublicResourceWebPath(
+        'EXT:my_extension/Resources/Public/file.js'
+    );
+
+..  index:: PHP-API, FullyScanned, ext:core