[TASK] Deprecate various TSFE methods
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Deprecation-84965-VariousTypoScriptFrontendControllerMethods.rst
1 .. include:: ../../Includes.txt
2
3 ==================================================================
4 Deprecation: #84965 - Various TypoScriptFrontendController methods
5 ==================================================================
6
7 See :issue:`84965`
8
9 Description
10 ===========
11
12 A lot of functionality from TypoScriptFrontendController (a.k.a. `TSFE`) has been migrated
13 into new PSR-15 middlewares, which are flexible modules to modify a HTTP request workflow.
14
15 Most of the functionality which is now in a PSR-15-based middleware is related to setting up various
16 permission and GET/POST variable resolving.
17
18 The following methods within :php:`TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController` have been marked
19 as deprecated:
20
21 * connectToDB()
22 * checkAlternativeIdMethods()
23 * initializeBackendUser()
24 * handleDataSubmission()
25 * setCSS()
26 * convPOSTCharset()
27
28 All hooks previously located within these methods still work as expected, as they are now called within
29 a PSR-15 middleware.
30
31 Additionally, there are some methods within TSFE which have been marked as "internal" for a long time,
32 but had the PHP visibility "public" from a legacy code base. These methods, which are internal for TYPO3 Core
33 purposes, now have the visibility "protected".
34
35 - getPageAndRootline()
36 - checkRootlineForIncludeSection()
37 - setSysPageWhereClause()
38 - checkAndSetAlias()
39 - getHash()
40 - getLockHash()
41 - setUrlIdToken()
42
43
44 Impact
45 ======
46
47 Calling any of the deprecated methods above will trigger a PHP deprecation message.
48
49
50 Affected Installations
51 ======================
52
53 Any TYPO3 installation with a custom extension setting up or mimicking a custom frontend request by
54 calling TypoScriptFrontendController methods directly.
55
56
57 Migration
58 =========
59
60 Extensions that bootstrap their own frontend should ensure that the respective Middlewares are run,
61 e.g. via custom stacks or just by setting up the "frontend" middleware stack.
62
63 Additionally, extensions can create custom middlewares to modify a HTTP request or response as well.
64
65 .. index:: Frontend, PHP-API, FullyScanned, ext:frontend