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,69 @@
+..  include:: /Includes.rst.txt
+
+..  _deprecation-109286-1773844395:
+
+================================================================
+Deprecation: #109286 - Explicit request handling in PageRenderer
+================================================================
+
+See :issue:`109286`
+
+Description
+===========
+
+Since TYPO3 v14.2 some methods of class :php:`TYPO3\CMS\Core\Page\PageRenderer`
+require an instance of :php-short:`\Psr\Http\Message\ServerRequestInterface` to
+be passed explicitly :
+
+setLanguage()
+-------------
+
+*   Old: :php:`PageRenderer->setLanguage(Locale $locale, ?ServerRequestInterface $request = null)`
+*   TYPO3 v14.2: :php:`PageRenderer->setLanguage(Locale $locale, ?ServerRequestInterface $request = null)`
+*   TYPO3 v15: :php:`PageRenderer->setLanguage(Locale $locale, ServerRequestInterface $request)`
+
+setDocType()
+------------
+
+*   Old: :php:`PageRenderer->setDocType(DocType $docType)`
+*   TYPO3 v14.2: :php:`PageRenderer->setDocType(DocType $docType, ?ServerRequestInterface $request = null)`
+*   TYPO3 v15: :php:`PageRenderer->setDocType(DocType $docType, ServerRequestInterface $request)`
+
+render()
+--------
+
+*   Old: :php:`PageRenderer->render()`
+*   TYPO3 v14.2: :php:`PageRenderer->render(?ServerRequestInterface $request = null)`
+*   TYPO3 v15: :php:`PageRenderer->render(ServerRequestInterface $request)`
+
+renderResponse()
+----------------
+
+*   Old: :php:`PageRenderer->renderResponse(int $code = 200, string $reasonPhrase = '')`
+*   TYPO3 v14.2: :php:`PageRenderer->render(ServerRequestInterface|int $requestOrCode = 200, int|string $codeOrReasonPhrase = '', string $reasonPhrase = '')`
+*   TYPO3 v15: :php:`PageRenderer->render(ServerRequestInterface $request, int $code = 200, string $reasonPhrase = '')`
+
+
+Impact
+======
+
+Request dependencies within
+:php-short:`TYPO3\CMS\Core\Page\PageRenderer` are no longer implicit via
+:php:`$GLOBALS['TYPO3_REQUEST']` and must now be passed explicitly. Not
+passing a request to the methods listed above will trigger a deprecation-level
+log entry in TYPO3 v14 and will result in a fatal PHP error in TYPO3 v15.
+
+Affected installations
+======================
+
+:php-short:`TYPO3\CMS\Core\Page\PageRenderer` is a low-level Core class. Many
+extensions use higher-level APIs and are therefore not directly affected by
+this change.
+
+Migration
+=========
+
+Adapt method calls to pass the
+:php-short:`\Psr\Http\Message\ServerRequestInterface` object explicitly.
+
+..  index:: Backend, Frontend, PHP-API, NotScanned, ext:core