componenta/error-handler-app

Componenta application integration for error handling and reporting

v1.0.0 2026-06-15 10:57 UTC

Requires

• php: ^8.4
• componenta/app: ^1.0
• componenta/config: ^1.0
• componenta/error-handler: ^1.0
• componenta/http-emitter: ^1.0
• componenta/path-resolver: ^1.0
• psr/container: ^2.0

Requires (Dev)

• pestphp/pest: ^4.0

MIT

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:

Key or service	Value
ErrorConfigKey::HTTP_LISTENERS	FileLogListener, HtmlLogListener
ErrorConfigKey::CLI_LISTENERS	FileLogListener
ErrorConfigKey::HTTP_RENDERER	PrettyPageRenderer(debug: true) in debug, otherwise SafeRenderer with templates/error/500.phtml.
ErrorConfigKey::CLI_RENDERER	PlainTextRenderer with debug flag from .env.
SafeRenderer::class	Safe renderer bound to templates/error/500.phtml.

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.