[TASK] Centralize sys_domain resolving
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Deprecation-85892-VariousMethodsRegardingSysDomainResolving.rst
1 .. include:: ../../Includes.txt
2
3 ====================================================================
4 Deprecation: #85892 - Various methods regarding sys_domain-resolving
5 ====================================================================
6
7 See :issue:`85892`
8
9 Description
10 ===========
11
12 Various methods specific for handling `sys_domain` records have been deprecated. As the new site handling is in place in favor of using `sys_domain`
13 records, these methods have been centralized in a :php:`LegacyDomainResolver` class, which is however marked as internal.
14
15 Instead, generating URLs should be done via the new PageUriBuilder and Routing API (still in progress), which covers both the new
16 site handling and the specific sys_domain record.
17
18 The following methods have been deprecated:
19 * :php:`TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController->domainNameMatchesCurrentRequest()`
20 * :php:`TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController->getDomainDataForPid()`
21 * :php:`TYPO3\CMS\Backend\Utility\BackendUtility::getDomainStartPage()`
22 * :php:`TYPO3\CMS\Backend\Utility\BackendUtility::firstDomainRecord()`
23
24
25 Impact
26 ======
27
28 Calling any of the methods will trigger a deprecation message.
29
30
31 Affected Installations
32 ======================
33
34 Any installation with custom functionality regarding sys_domain handling where any of the methods above are used.
35
36
37 Migration
38 =========
39
40 Migrate to either the new Routing API (finalized for 9 LTS) or implement the functionality in your own, or use the :php:`LegacyDomainResolver` class,
41 but since the concept of sys_domain handling will be removed in TYPO3 v10.0, consider use the Site handling functionality instead.
42
43 .. index:: FullyScanned