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,68 @@
+..  include:: /Includes.rst.txt
+
+..  _breaking-108084-1763033071:
+
+==============================================================
+Breaking: #108084 - Allow rootless paths in URI implementation
+==============================================================
+
+See :issue:`108084`
+
+Description
+===========
+
+Previously, the TYPO3 implementation of :php-short:`\Psr\Http\Message\UriInterface`
+always prefixed rootless paths (paths without a preceding slash) with a slash.
+With this normalization in place, it was impossible to represent rootless
+paths. This has now changed so that a slash is only prepended to the path
+when an authority (host name) is present.
+
+Example
+-------
+
+Input: `rootless/path/`
+
+..  code-block:: php
+    :caption: Examples with different URIs
+
+     use TYPO3\CMS\Core\Http\Uri;
+
+     $uri = new Uri('rootless/path/');
+     $uriAsString = (string)$uri;
+     // before: /rootless/path/
+     // after: rootless/path/
+
+     // Same behavior with authority
+     $uri = (new Uri('https://example.com'))->withPath('rootless/path/');
+     $uriAsString = (string)$uri;
+     // before: https://example.com/rootless/path/
+     // after: https://example.com/rootless/path/
+
+     // Colon in first path segment
+     $uri = new Uri('rootless:path/to/resource');
+     $uriAsString = (string)$uri;
+     // before: /rootless:path/to/resource/
+     // after: ./rootless:path/to/resource/
+
+Impact
+======
+
+Regarding top level TYPO3 API and functionality, nothing has changed. Required
+TYPO3 code has been adapted.
+
+Third party code that uses the :php-short:`\TYPO3\CMS\Core\Http\Uri` class
+directly will get different results when representing rootless paths without
+authority. Code that relied on the normalization done by TYPO3 before is
+likely to break.
+
+Since TYPO3 is always dealing with absolute paths, due to URL rewriting in the
+backend and the frontend, it is unlikely that much third party code relies on
+relative paths, so the impact is expected to be low.
+
+Affected installations
+======================
+
+Third party code that is using the :php-short:`\TYPO3\CMS\Core\Http\Uri` class
+directly and that is representing rootless paths without authority.
+
+..  index:: PHP-API, NotScanned, ext:core