https://github.com/crazycodr/standard-exceptions

A small library that aims at supplementing default exceptions in PHP
https://github.com/crazycodr/standard-exceptions

Last synced: about 1 month ago
JSON representation

A small library that aims at supplementing default exceptions in PHP

• Host: GitHub
• URL: https://github.com/crazycodr/standard-exceptions
• Owner: crazycodr
• License: mit
• Created: 2013-11-07T12:44:47.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2020-05-26T17:28:41.000Z (about 4 years ago)
• Last Synced: 2024-05-11T18:22:23.111Z (about 1 month ago)
• Language: PHP
• Homepage:
• Size: 226 KB
• Stars: 147
• Watchers: 14
• Forks: 10
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome - crazycodr/standard-exceptions - A small library that aims at supplementing default exceptions in PHP (PHP)

README

        
[![Latest Stable Version](https://poser.pugx.org/crazycodr/standard-exceptions/version.png)](https://packagist.org/packages/crazycodr/standard-exceptions) [![Monthly Downloads](https://poser.pugx.org/crazycodr/standard-exceptions/d/monthly)](https://packagist.org/packages/crazycodr/standard-exceptions) [![Build Status](https://travis-ci.org/crazycodr/standard-exceptions.png?branch=master)](https://travis-ci.org/crazycodr/standard-exceptions)

# Standard Exceptions Package

This project is aimed at providing additional standard exceptions to [PHP](http://www.php.net/). 

Many exceptions that are missing from the SPL are constantly being reproduced in different projects. By providing a package of high-quality, well organised exceptions, it will, in the long run, increase interoperability between projects and libraries.

# Getting started

To install `Standard Exceptions`, just require it using [Composer](http://www.getcomposer.org/):

```

$ composer require crazycodr/standard-exceptions

```

And then just start throwing exceptions:

```php

throw new \Exceptions\Data\NotFoundException();

```

Or catch them:

```php

try {

} catch(\Exceptions\Data\NotFoundExceptions $ex){

}

```

Or even better, catch exceptions with similar means:

```php

try {

} catch(\Exceptions\Tag\NotFoundTag $ex){

   

}

```

For more information, visit the [Getting Started Page](docs/getting-started.md) or for even more information, you get read the whole [Documentation](docs/index.md).

If you need help upgrading for the old version 1 to this version, see the [Upgrading from Version 1 to Version 2](docs/upgrade-1-2.md) documentation page.

# Features

* Highly comprehensive list of exceptions and namespaces: [Browse](docs/exceptions/)

* [Tag interfaces](docs/tags.md) to catch common exceptions with similar means but different contexts

* Exceptions define default messages and error codes using the [DefaultsInterface and DefaultConstructorTrait](docs/helpers.md)

* Throwing new exceptions from another exception allows easier exception chaining using [FromException helper](docs/helpers.md)

# Contribution

Don't hesitate to contribute to this package by:

* Proposing new exceptions or namespaces

* Fix documentation issues or bugs by opening PRs

* Using it and spreading it's use throughout projects and libraries

If you want to contribute to the code base go to the [Contributing page](docs/contribute.md).