PHPackages                             kuria/error - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Debugging & Profiling](/categories/debugging)
4. /
5. kuria/error

ActiveLibrary[Debugging & Profiling](/categories/debugging)

kuria/error
===========

Makes handling and debugging PHP errors suck less

v4.2.4(1y ago)1920.0k↓23.7%12MITPHPPHP >=7.1

Since Dec 22Pushed 1y ago3 watchersCompare

[ Source](https://github.com/kuria/error)[ Packagist](https://packagist.org/packages/kuria/error)[ RSS](/packages/kuria-error/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (4)Versions (16)Used By (2)

Error handler
=============

[](#error-handler)

Makes handling and debugging PHP errors suck less.

[![Web error screen in debug mode](./doc/web-error-screen-debug.png)](./doc/web-error-screen-debug.png)

Contents

- [Features](#features)
- [Requirements](#requirements)
- [Usage example](#usage-example)
- [Event system](#event-system)
    - [Error handler events](#error-handler-events)
    - [Web error screen events](#web-error-screen-events)
    - [CLI error screen events](#cli-error-screen-events)
    - [Event listener examples](#event-listener-examples)

[Features](#id1)
----------------

[](#features)

- normal / debug mode
- converts PHP errors (warnings, notices, etc.) into exceptions
- respects the global `error_reporting` setting
- handles uncaught exceptions and fatal errors (including parse and out-of-memory errors)
- CLI error screen writes errors to stderr
- web error screen renders errors for web browsers

    - normal mode shows a generic error message:

        [![Web error screen in normal mode](./doc/web-error-screen.png)](./doc/web-error-screen.png)
    - debug mode shows all available info:

        [![Web error screen in debug mode](./doc/web-error-screen-debug.png)](./doc/web-error-screen-debug.png)

        - file paths and line numbers
        - highlighted code previews
        - stack traces
        - argument lists
        - output buffer (can be shown as HTML too)
        - plaintext trace (for copy-paste)
- event system that can be utilised to:

    - implement logging
    - suppress or force errors conditionally
    - change or add content to the error screens

[Requirements](#id2)
--------------------

[](#requirements)

- PHP 7.1+

[Usage example](#id3)
---------------------

[](#usage-example)

```