Page-based error handler

The page error handler displays the content of a page in case of a certain HTTP status. The content of this page is fetched via curl, cached and displayed in place of the missing page.

The page-based error handler is defined in TYPO3CMSCoreErrorPageErrorHandlerPageContentErrorHandler.

In order to prevent possible denial-of-service attacks when the page-based error handler is used, the content of the error page is cached in the TYPO3 page cache. Any dynamic content on the error page (for example content created by TypoScript or uncached plugins) will therefore also be cached.

If the error page contains dynamic content, TYPO3 administrators must ensure that no sensitive data (for example username of logged in frontend user) will be shown on the error page.

If dynamic content is required on the error page, it is recommended to implement a custom PHP based error handler.

Properties

The page-based error handler has the properties errorCode and errorHandler and the following:

errorContentSource

Datatype
string
Description
May be either an External URL or TYPO3 Page that will be fetched with curl and displayed in case of an error.
Example
t3://page?uid=123

Examples

Internal error page

Show the internal page with uid 145 on errors with HTML status 404. The content of this page will be fetched via curl and stored in the TYPO3 page cache. If the TYPO3 page contains dynamic data make sure no sensitive data is revealed.

Pages behind a basic-auth password therefore don’t work.

errorHandling:
  -
    errorCode: 404
    errorHandler: Page
    errorContentSource: 't3://page?uid=145'

External error page

Shows an external page on all errors with a HTML status not otherwise defined.

errorHandling:
  -
    errorCode: 0
    errorHandler: Page
    errorContentSource: 'https://typo3.org/404'