[TASK] Deprecate Redirecting UrlHandler Hook Concept
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Deprecation-85124-RedirectingUrlHandlerHookConcept.rst
1 .. include:: ../../Includes.txt
2
3 =========================================================
4 Deprecation: #85124 - Redirecting urlHandler Hook Concept
5 =========================================================
6
7 See :issue:`85124`
8
9 Description
10 ===========
11
12 The URL handler concept introduced in TYPO3 v7 to allow pages to do redirects has been deprecated in favor
13 of using PSR-7 / PSR-15 middlewares.
14
15 The Redirect URL handlers were used for e.g. jumpURLs, pages that should redirect to a external URL
16 or special handlings registered via the :php:`\TYPO3\CMS\Frontend\Http\UrlHandlerInterface`.
17
18 All functionality and methods have been marked as deprecated and will be removed in TYPO3 v10.0.
19
20
21 Impact
22 ======
23
24 Calling :php:`$TSFE->initializeRedirectUrlHandlers()` and :php:`$TSFE->redirectToExternalUrl()` will trigger
25 deprecation warnings.
26
27
28 Affected Installations
29 ======================
30
31 TYPO3 Installations with extensions registering a urlHandler via
32 `$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['urlProcessing']['urlHandlers']`.
33
34
35 Migration
36 =========
37
38 Check the extension scanner if the site is affected and migrate to a PSR-15 middleware.
39
40 .. index:: Frontend, PHP-API, FullyScanned