dhii/exception-interface

Interfaces for most common exceptions

v0.2 2018-08-29 10:42 UTC

Requires

• php: ^5.3 | ^7.0
• dhii/stringable-interface: ^0.1

Requires (Dev)

• codeclimate/php-test-reporter: <=0.3.2
• dhii/php-cs-fixer-config: dev-php-5.3
• phpunit/phpunit: ^4.8
• ptrofimov/xpmock: ^1.1

MIT

• Dhii Team

README

Interfaces for most common exceptions.

Details

• ThrowableInterface - The base of all exception interfaces. Declares all the same methods as Exception in a compatible way, and additionally extends StringableInterface.
• BadSubjectExceptionInterface - Base interface for all exceptions that are related to some value being invalid, malformed, out of range, etc. Exposes that value via getSubject().
• InvalidArgumentExceptionInterface - Allows de-coupling from the vanilla InvalidArgumentException, and makes it more useful besides signalling the problem type by exposing the argument via BadSubjectExceptionInterface#getSubejct().
• ArgumentCodeAwareInterface - Useful with InvalidArgumentExceptionInterface for providing information about the source of the problematic argument.
• OutOfBoundsExceptionInterface - Complementing the native OutOfBoundsException, it occurs when a key is addressed in a set that does not have it, like accessing a non-existing array key. Exposes the bad key.
• OutOfRangeExceptionInterface - Complementing the native OutOfRangeException, it occurs when a value is valid but illegal, i.e. is outside of the allowed range, like when an integer that represents a colour and must be 0-255 has the value of 256. Exposes the bad value.
• RuntimeExceptionInterface - A generic runtime problem.
• InternalExceptionInterface - A problem that occurs in relation to the inner workings of the unit, and is not caused by the consumer. Guarantees to expose an inner exception.