README

Application integration for Componenta error handling. The package registers debug-aware renderers and file/HTML logging listeners used by the base componenta/error-handler services.

The base error contracts, contexts, handlers, renderers, middleware, and response generators live in componenta/error-handler. This package wires them into a Componenta application through Componenta\Error\App\ConfigProvider.

Installation

composer require componenta/error-handler-app

The package exposes Componenta\Error\App\ConfigProvider through Composer metadata.

Debug Behavior

APP_DEBUG=true controls whether the HTTP renderer shows detailed exception output. When debug is disabled, the application renderer uses the safe templates/error/500.phtml template through Componenta\Error\Renderer\SafeRenderer.

Debug is resolved directly from the environment file by Componenta\Error\App\EnvDebugResolver, so the decision does not depend on already-built application configuration.

Values 1, true, yes, and on enable debug. Missing .env, missing APP_DEBUG, and any other value disable debug.

Logging

Componenta\Error\App\Listener\FileLogListener writes text logs. Componenta\Error\App\Listener\HtmlLogListener writes HTML snapshots for browser inspection. Paths are resolved through componenta/path-resolver.

FileLogListener is registered for HTTP and CLI errors. HtmlLogListener is registered only for HTTP errors and writes snapshots only when APP_DEBUG is enabled.

Registered Services

Componenta\Error\App\ConfigProvider configures:

This package does not replace the base handlers from componenta/error-handler; it only supplies application renderers and listeners used by those handlers.

Related Packages

• componenta/error-handler defines the core error handling contracts and runtime handlers.
• componenta/http-emitter emits HTTP responses.
• componenta/skeleton shows how application entry points log bootstrap failures and render the safe 500 template for HTTP flows.