b13 / evergreen-errors
Custom Error Handling for TYPO3
Installs: 5 995
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 7
Forks: 0
Open Issues: 0
Requires
- php: ^7.2 || ^8.0
- typo3/cms-core: ^9.5 || ^10.0 || ^11.0 || ^12.0 || ^13.0
README
TYPO3 has a built-in error handling system which sends 50x HTTP response codes when a PHP error or syntax error occurred, or an unhandled PHP Exception is sent.
This is perfect for really 99.9999% of the use-cases, however when using TYPO3 behind a CDN with a singular domain and various other systems, a CDN could be configured to treat 50x status codes as a bug for the whole domain, effectively blocking all access to the domain / zone.
For this reason, this extension is created which transfers 50x HTTP status codes to a 400 error code before emitting the result to the browser.
Installation
Install the extension via composer:
composer req b13/evergreen-errors
Then configure your TYPO3 installation to use the exception handler, by setting the
productionExceptionHandler
in your typo3conf/LocalConfiguration.php
or typo3conf/AdditionalConfiguration.php
file.
Here is an example for your AdditionalConfiguration.php / additional.php file:
$GLOBALS['TYPO3_CONF_VARS']['SYS']['productionExceptionHandler'] = \B13\EvergreenErrors\EvergreenExceptionHandler::class;
If you also want to enable this for your debug exception handler, use
$GLOBALS['TYPO3_CONF_VARS']['SYS']['debugExceptionHandler'] = \B13\EvergreenErrors\EvergreenDebugExceptionHandler::class;
License
The package is licensed under GPL v2+, same as the TYPO3 Core. For details see the LICENSE file in this repository.
Credits
This package was created by Benni Mack in 2021 for b13 GmbH.
Find more TYPO3 packages we have developed that help us deliver value in client projects. As part of the way we work, we focus on testing and best practices to ensure long-term performance, reliability, and results in all our code.