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,57 @@
+.. include:: /Includes.rst.txt
+
+.. _feature-92984:
+
+====================================================================
+Feature: #92984 - PSR-7 Request available in Frontend ContentObjects
+====================================================================
+
+See :issue:`92984`
+
+Description
+===========
+
+The main Request object of a web-based PHP process is now handed into all
+:php:`ContentObjects` and :php:`ContentObjectRenderer` classes.
+
+In addition, any kind of "userFunc" methods initiated from :php:`ContentObjectRenderer`,
+basically all custom Frontend PHP code, now receives the request object that was
+handed in as third method argument.
+
+The :php:`ContentObjectRenderer` API now has a :php:`getRequest()` method.
+
+Example:
+
+.. code-block:: typoscript
+
+   page.10 = USER
+   page.10.userFunc = MyVendor\MyPackage\Frontend\MyClass->myMethod
+
+.. code-block:: php
+
+   <?php
+
+   namespace MyVendor\MyPackage\Frontend;
+
+   class MyClass
+   {
+
+       public function myMethod(string $content, array $configuration, ServerRequestInterface $request)
+       {
+           $myValue = $request->getQueryParams()['myGetParameter'];
+           $normalizedParams = $request->getAttribute('normalizedParams');
+       }
+   }
+
+This functionality should be used in PHP code related to Frontend code instead of
+the superglobal variables like :php:`$_GET` / :php:`$_POST` / :php:`$_SERVER`, or TYPO3s
+API methods :php:`GeneralUtility::_GP()` and :php:`GeneralUtility::getIndpEnv()`.
+
+Impact
+======
+
+Any kind of custom Content Object in PHP code can now access the PSR-7 Request
+object to fetch information about the current request, making TYPO3 Frontend
+aware of PSR-7 standardized request objects.
+
+.. index:: Frontend, PHP-API, ext:frontend