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.