typo3/sysext/core/Documentation/Changelog/9.5/Deprecation-86389-GeneralUtility_GETsetAndTSFE-mergingWithGetVars.rst

   1 .. include:: ../../Includes.txt
   2
   3 ==============================================================================
   4 Deprecation: #86389 - GeneralUtility::_GETset() and TSFE->mergingWithGetVars()
   5 ==============================================================================
   6
   7 See :issue:`86389`
   8
   9 Description
  10 ===========
  11
  12 Two methods related to setting global :php:`$_GET` parameters have been marked as deprecated:
  13
  14 * :php:`TYPO3\CMS\Core\Utility\GeneralUtility::_GETset()`
  15 * :php:`TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController->mergingWithGetVars()`
  16
  17 The two methods are wrappers to set the :php:`$_GET` properties, however, this concept has been superseded
  18 by using the PSR-7 request object within PSR-15 middlewares to replace the variables.
  19
  20
  21 Impact
  22 ======
  23
  24 Calling any of the two methods within PHP will trigger a PHP :php:`E_USER_DEPRECATED` error.
  25
  26
  27 Affected Installations
  28 ======================
  29
  30 Any installation making use of these methods within a TYPO3 extension, e.g. RealURL.
  31
  32
  33 Migration
  34 =========
  35
  36 Implement a custom PSR-15 middleware to update the PSR-7 request object, and to manually set :php:`$_GET` on top,
  37 as long as TYPO3 still supports :php:`GeneralUtility::_GP()`, although these methods will vanish in the near future.
  38
  39 Relying on the request object, and using PSR-15 middlewares to manipulate request parameters is more future-proof
  40 for extensions and TYPO3 sites.
  41
  42 .. index:: Frontend, PHP-API, FullyScanned