netlogix/nxerrorhandler

Error handler with static pages for TYPO3

Installs: 10 673

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 3

Forks: 0

Open Issues: 3

Type:typo3-cms-extension

7.0.2 2024-06-26 07:22 UTC

README

stability-wip TYPO3 V12 Minimum PHP Version GitHub CI status

Improves error handling in TYPO3 by using statically rendered error documents for output to reduce strain on the server.

This extension is a work in progress.

Usage

Add this to your config/system/settings.php

return [
    'EXTENSIONS' => [
        'nxerrorhandler' => [
            'exceptionHandlerComponents' => [
                \Netlogix\Nxerrorhandler\ErrorHandler\Component\ExtbaseArgumentsToBadRequestComponent::class,
                \Netlogix\Nxerrorhandler\ErrorHandler\Component\StaticDocumentComponent::class,
            ],
        ]
    ],
    'SYS' => [
        'productionExceptionHandler' => \Netlogix\Nxerrorhandler\ErrorHandler\GeneralExceptionHandler::class
    ],
];

Note: This will register the ExceptionHandler for all contexts including backend requests. If you want to restrict it to frontend requests only then add this line to config/system/additional.php instead:

    if (TYPO3_REQUESTTYPE & TYPO3_REQUESTTYPE_FE) {
        $GLOBALS['TYPO3_CONF_VARS']['SYS']['productionExceptionHandler'] = \Netlogix\Nxerrorhandler\ErrorHandler\GeneralExceptionHandler::class;
    }

Add this to your config/sites/sitename/config.yaml

errorHandling:
    - errorCode: '400'
      errorHandler: PHP
      errorPhpClassFQCN: Netlogix\Nxerrorhandler\Error\PageContentErrorHandler
      errorContentSource: 't3://page?uid=99'
    - errorCode: '404'
      errorHandler: PHP
      errorPhpClassFQCN: Netlogix\Nxerrorhandler\Error\PageContentErrorHandler
      errorContentSource: 't3://page?uid=99'
    - errorCode: '500'
      errorHandler: PHP
      errorPhpClassFQCN: Netlogix\Nxerrorhandler\Error\PageContentErrorHandler
      errorContentSource: 't3://page?uid=99'