Note: This repository is part of Dazzle Project - the next-gen library for PHP. The project's purpose is to provide PHP developers with a set of complete tools to build functional async applications. Please, make sure you read the attached README carefully and it is guaranteed you will be surprised how easy to use and powerful it is. In the meantime, you might want to check out the rest of our async libraries in Dazzle repository for the full extent of Dazzle experience.

Dazzle Throwable is a component that provides unified throwable hierarchy and additional helpers.

Dazzle Throwable features:

• Custom hierarchy of Throwables created in mind of unifying error and exception handling in PHP5 and PHP7,
• Custom human-readable format for stack trace and exception trace,
• Support for chaining Throwables,
• Built-in ErrorHandler,
• Built-in ExceptionHandler,
• Implementation of throwable objects proxy,
• ...and more.

Provided throwable hierarchy:

Throwable
    Error
        FatalError
        WarningError
        NoticeError
    Exception
        LogicException
            IllegalCallException
            IllegalFieldException
            InstantiationException
            InvalidArgumentException
            InvalidFormatException
            ResourceException
            ResourceOccupiedException
            ResourceUndefinedException
        RuntimeException
            CancellationException
            ExecutionException
            OutOfBoundsException
            OverflowException
            ReadException
            RejectionException
            TimeoutException
            UndeflowException
            UnexpectedValueException
            WriteException

Dazzle Throwable requires:

• PHP-5.6 or PHP-7.0+,
• UNIX or Windows OS.

To install this library make sure you have composer installed, then run following command:

$> composer require dazzle-php/throwable

Tests can be run via:

$> vendor/bin/phpunit -d memory_limit=1024M

Versioning of Dazzle libraries is described in versioning section of Dazzle Project index repository. Please, refer there for detailed information on the subject.

Thank you for considering contributing to this repository!

• The contribution guide can be found in the contribution tips.
• Open tickets can be found in issues section.
• Current contributors are listed in graphs section
• To contact the author(s) see the information attached in composer.json file.

Dazzle Throwable is open-sourced software licensed under the MIT license.

"Everything is possible. The impossible just takes longer." ― Dan Brown