PHP download

Download the PHP package waffle-commons/error-handler without Composer

On this page you can find all versions of the php package waffle-commons/error-handler. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Table of contents
Download waffle-commons/error-handler
More information about waffle-commons/error-handler
Files in waffle-commons/error-handler

Vendor waffle-commons
Package error-handler
Short Description PSR-15 error handling for Waffle Commons: RFC 7807 application/problem+json responses, PSR-3 logging, and debug-safe rendering that never leaks internals in production.
License MIT

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:

If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.

Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
To use Composer is sometimes complicated. Especially for beginners.
Composer needs much resources. Sometimes they are not available on a simple webspace.
If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.

Please rate this library. Is it a good library?

Example code of waffle-commons/error-handler

Informations about the package error-handler

Waffle Error Handler Component

Release: 0.1.0-beta6 | CHANGELOG.md PSR Compliance: PSR-15 (middleware), PSR-3 (logging), RFC 7807 (application/problem+json), RFC 7231 (Allow header on 405)

The outermost middleware in every Waffle pipeline. Catches Throwable thrown deeper in the stack, logs it via the injected PSR-3 logger, and renders an RFC 7807 "Problem Details" JSON response.

📦 Installation

🧱 Surface

Class	Role
`Waffle\Commons\ErrorHandler\Middleware\ErrorHandlerMiddleware`	PSR-15 middleware. Wraps `$handler->handle()` in `try/catch(Throwable)`, logs, then delegates to the renderer.
`Waffle\Commons\ErrorHandler\Renderer\JsonErrorRenderer`	`final readonly` renderer implementing `ErrorRendererInterface`. Produces RFC 7807 JSON.

🚀 Wiring it up

📦 RFC 7807 payload

JsonErrorRenderer::render(Throwable $e, ServerRequestInterface $request) always emits the canonical RFC 7807 shape, encoded with JSON_THROW_ON_ERROR | JSON_UNESCAPED_SLASHES:

Extensions added by Waffle:

If the exception implements Waffle\Commons\Contracts\Exception\Validation\ValidationExceptionInterface and getField() returns non-null, a field key is added to the payload (RFC-011).
If $debug = true, additional trace, file, line keys are added.
In production ($debug = false), any 5xx detail is masked to "An internal server error occurred." to avoid leaking implementation details.

🧩 Status-code resolution

JsonErrorRenderer::determineStatusCode(Throwable $e) walks well-known exception interfaces (e.g. ValidationExceptionInterface → 422, RouteNotFoundExceptionInterface → 404, MethodNotAllowedExceptionInterface → 405, \InvalidArgumentException → 400) and falls back to 500 for unknown throwables. The matching is interface-based — your application exceptions can opt in by implementing the right contract interface. For a MethodNotAllowedExceptionInterface, the renderer also emits an RFC 7231 Allow header (e.g. Allow: GET, HEAD, OPTIONS, POST).

🐘 PHP 8.5 features used

final readonly class JsonErrorRenderer — the renderer holds an injected ResponseFactoryInterface and a bool $debug flag, both readonly.
Strict-typed constructor + return types.
JSON_THROW_ON_ERROR for fail-fast encoding.

🧭 Architectural boundary (`mago guard`)

An active dependency perimeter is enforced on every CI run by vendor/bin/mago guard (bundled into composer mago; zero baselines). The rules live in mago.toml under [guard.perimeter] — a forbidden use statement fails the build, not a reviewer.

Production code under Waffle\Commons\ErrorHandler may depend only on:

Waffle\Commons\ErrorHandler\** — itself
Waffle\Commons\Contracts\** — the shared contracts package, the only Waffle dependency permitted
Psr\** — PSR interfaces (PSR-7 / PSR-15 / PSR-17)
@global + Psl\** — PHP core and the PHP Standard Library

Test code under WaffleTests\Commons\ErrorHandler is unrestricted (@all). Structural rules are guarded too: interfaces must be named *Interface, Exception\** classes must end in *Exception, and any Enum\** namespace may hold only enum declarations.

Contract-first, component-agnostic by construction: components compose through waffle-commons/contracts, never directly through one another.

🧪 Testing

📚 Documentation

Central framework docs live in the waffle-commons/documentation repository:

Reference: error-handler

📄 License

MIT — see LICENSE.md.

All versions of error-handler with dependencies

PHP Build Version

Package Version

Version 0.1.0-beta6 Release 08. Sep 2026
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of error-handler from vendor waffle-commons

Requires php Version ^8.5
waffle-commons/contracts Version self.version
psr/http-message Version ^2.0
psr/http-factory Version ^1.1
psr/log Version ^3.0

Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package waffle-commons/error-handler contains the following files

Loading the files please wait ...