https://github.com/dazzle-php/throwable
Dazzle Throwable Hierarchy
https://github.com/dazzle-php/throwable
error error-handling exception exception-handling php php-lib php7 throw
Last synced: 7 months ago
JSON representation
Dazzle Throwable Hierarchy
- Host: GitHub
- URL: https://github.com/dazzle-php/throwable
- Owner: dazzle-php
- License: mit
- Created: 2017-06-17T19:13:21.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-08-06T20:49:49.000Z (over 8 years ago)
- Last Synced: 2025-03-22T04:23:56.428Z (11 months ago)
- Topics: error, error-handling, exception, exception-handling, php, php-lib, php7, throw
- Language: PHP
- Homepage:
- Size: 52.7 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Dazzle Throwable Hierarchy
[](https://travis-ci.org/dazzle-php/throwable)
[](https://scrutinizer-ci.com/g/dazzle-php/throwable/?branch=master)
[](https://scrutinizer-ci.com/g/dazzle-php/throwable/?branch=master)
[](https://packagist.org/packages/dazzle-php/throwable)
[](https://packagist.org/packages/dazzle-php/throwable)
[](https://packagist.org/packages/dazzle-php/throwable/license)
> **Note:** This repository is part of [Dazzle Project](https://github.com/dazzle-php/dazzle) - 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](https://github.com/dazzle-php) for the full extent of Dazzle experience.
## Description
Dazzle Throwable is a component that provides unified throwable hierarchy and additional helpers.
## Feature Highlights
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 Example(s)
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
```
## Requirements
Dazzle Throwable requires:
* PHP-5.6 or PHP-7.0+,
* UNIX or Windows OS.
## Installation
To install this library make sure you have [composer](https://getcomposer.org/) installed, then run following command:
```
$> composer require dazzle-php/throwable
```
## Tests
Tests can be run via:
```
$> vendor/bin/phpunit -d memory_limit=1024M
```
## Versioning
Versioning of Dazzle libraries is described in versioning section of [Dazzle Project](https://github.com/dazzle-php/dazzle) index repository. Please, refer there for detailed information on the subject.
## Contributing
Thank you for considering contributing to this repository!
- The contribution guide can be found in the [contribution tips](https://github.com/dazzle-php/throwable/blob/master/CONTRIBUTING.md).
- Open tickets can be found in [issues section](https://github.com/dazzle-php/throwable/issues).
- Current contributors are listed in [graphs section](https://github.com/dazzle-php/throwable/graphs/contributors)
- To contact the author(s) see the information attached in [composer.json](https://github.com/dazzle-php/throwable/blob/master/composer.json) file.
## License
Dazzle Throwable is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT).
"Everything is possible. The impossible just takes longer." ― Dan Brown