Deprecation: #99416 - Various doctype related properties and methods¶
See forge#99416
Description¶
Due to the introduction of a unified definition of the DocType that should render HTML, XML or XHTML-compliant content either in TYPO3 frontend rendering or backend rendering, various methods and properties have been marked as deprecated, as they are superfluous now:
\TYPO3\CMS\Core\Page\PageRenderer->setRenderXhtml()
\TYPO3\CMS\Core\Page\PageRenderer->getRenderXhtml()
\TYPO3\CMS\Core\Page\PageRenderer->setMetaCharsetTag()
\TYPO3\CMS\Core\Page\PageRenderer->getMetaCharsetTag()
\TYPO3\CMS\Core\Page\PageRenderer->setCharSet()
\TYPO3\CMS\Core\Page\PageRenderer->getCharSet()
\TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController->xhtmlDoctype
\TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController->xhtmlVersion
Impact¶
Calling one of the methods or accessing / writing one of the properties mentioned will trigger a PHP deprecation message.
Affected installations¶
TYPO3 installations with custom extensions reading or writing these properties or methods directly in PHP, which is unlikely.
Migration¶
Use PageRenderer->setDocType()
to manipulate the output in
a programmatic way, or use PageRenderer->getDocType()
to read the
current doctype — for example "is the current page HTML5 compliant".
Various TypoScript properties will instruct the PageRenderer
as before,
there is no need to use other configuration options. However, it is recommended to use
config.doctype
in favor of config.xhtmlDoctype
in
TypoScript as it considers more possible options.