symfony/error-handler

Provides tools to manage errors and ease debugging PHP code

v7.3.1 2025-06-13 07:48 UTC

Requires

• php: >=8.2
• psr/log: ^1|^2|^3
• symfony/var-dumper: ^6.4|^7.0

Requires (Dev)

• symfony/console: ^6.4|^7.0
• symfony/deprecation-contracts: ^2.5|^3
• symfony/http-kernel: ^6.4|^7.0
• symfony/serializer: ^6.4|^7.0
• symfony/webpack-encore-bundle: ^1.0|^2.0

Conflicts

• symfony/deprecation-contracts: <2.5
• symfony/http-kernel: <6.4

MIT

• Fabien Potencier
• Symfony Community

README

The ErrorHandler component provides tools to manage errors and ease debugging PHP code.

Getting Started

composer require symfony/error-handler

use Symfony\Component\ErrorHandler\Debug;
use Symfony\Component\ErrorHandler\ErrorHandler;
use Symfony\Component\ErrorHandler\DebugClassLoader;

Debug::enable();

// or enable only one feature
//ErrorHandler::register();
//DebugClassLoader::enable();

// If you want a custom generic template when debug is not enabled
// HtmlErrorRenderer::setTemplate('/path/to/custom/error.html.php');

$data = ErrorHandler::call(static function () use ($filename, $datetimeFormat) {
    // if any code executed inside this anonymous function fails, a PHP exception
    // will be thrown, even if the code uses the '@' PHP silence operator
    $data = json_decode(file_get_contents($filename), true);
    $data['read_at'] = date($datetimeFormat);
    file_put_contents($filename, json_encode($data));

    return $data;
});

Resources

• Contributing
• Report issues and send Pull Requests in the main Symfony repository