.. include:: /Includes.rst.txt

.. _deprecation-91012:

===========================================================================
Deprecation: #91012 - Various hooks related to TypoScriptFrontendController
===========================================================================

See :issue:`91012`

Description
===========

The following hooks related to class :php:`TypoScriptFrontendController`
and frontend-rendering have been marked as deprecated:

* :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_fe.php']['pageIndexing']`
* :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_fe.php']['isOutputting']`
* :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_fe.php']['tslib_fe-contentStrReplace']`
* :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_fe.php']['contentPostProc-output']`
* :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_fe.php']['hook_eofe']`

The following methods have been marked as deprecated as well, as they only
contain code relevant for executing the hooks:

* :php:`TypoScriptFrontendController->isOutputting()`
* :php:`TypoScriptFrontendController->processContentForOutput()`


Impact
======

If third-party extensions are using the hooks, a PHP :php:`E_USER_DEPRECATED` error will be triggered when the hook is executed.

Calling the two methods above will also trigger a PHP :php:`E_USER_DEPRECATED` error.


Affected Installations
======================

TYPO3 installations with custom extensions using the hooks or mentioned above, which is common if they haven't been using
PSR-15 middlewares or other hooks instead.


Migration
=========

The hook :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_fe.php']['pageIndexing']`
should be replaced by the :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_fe.php']['contentPostProc-cached']` hook
to index pages. However, please note that :php:`$TSFE->content` might contain UTF-8 content now,
instead of content already converted to the defined character set related to :typoscript:`metaCharset` TypoScript property.

Since TYPO3 v9, the emitter of HTTP responses is based on PSR-7, the hook :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_fe.php']['isOutputting']` can be removed, as
TYPO3 can be configured via PSR-15 middlewares to define whether
page content should be emitted / rendered or not.

The hook to dynamically replace content via :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_fe.php']['tslib_fe-contentStrReplace']`
is removed as it serves no purpose for TYPO3 Core anymore. If content should be dynamically modified, use a PSR-15 middleware instead.

The hook :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_fe.php']['contentPostProc-output']` is not needed as this can be built via a PSR-15 middleware instead, and
all content is returned via the RequestHandler of TYPO3 Frontend.

Extensions using hook :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_fe.php']['hook_eofe']` should
be converted to PSR-15 middlewares, as this allows to modify content and headers of a PSR-7 Response object.

The method :php:`TypoScriptFrontendController->isOutputting()` is obsolete and can be removed in third-party code.

The same applies to :php:`TypoScriptFrontendController->processContentForOutput()` which should only be used to trigger
legacy hooks still applied in the system.

.. index:: PHP-API, FullyScanned, ext:frontend
