Deprecation: #85892 - Various methods regarding sys_domain-resolving¶
See forge#85892
Description¶
Various methods specific for handling sys_domain
records have been marked as deprecated. As the new site handling is in place in favor of using sys_domain
records, these methods have been centralized in a LegacyDomainResolver
class, which is however marked as internal.
Instead, generating URLs should be done via the new PageUriBuilder and Routing API, which covers both the new site handling and the specific sys_domain record.
The following methods have been marked as deprecated:
TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController->domainNameMatchesCurrentRequest()
TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController->getDomainDataForPid()
TYPO3\CMS\Backend\Utility\BackendUtility::getDomainStartPage()
TYPO3\CMS\Backend\Utility\BackendUtility::firstDomainRecord()
Impact¶
Calling any of the methods will trigger a PHP E_USER_DEPRECATED
error.
Affected Installations¶
Any installation with custom functionality regarding sys_domain
handling where any of the methods mentioned above are used.
Migration¶
Migrate to either the new Routing API (finalized for 9 LTS) or implement the functionality in your own, or use the LegacyDomainResolver
class,
but since the concept of sys_domain handling will be removed in TYPO3 v10, consider use of the Site handling functionality instead.