markenwerk/common-exceptions

A PHP library providing common exception classes used by different projects.

PHP Common Exceptions

, _(*1)

A PHP library providing common exception classes used by different projects., _(*2)

Installation

```{json} { "require": { "chroma-x/common-exceptions": "~3.0" } }, <sub>(*3)</sub>

## Usage

### Autoloading and namesapce

```{php}  
require_once('path/to/vendor/autoload.php');

Handling exceptions

Catching by concrete class

```{php} try{ // Perform something maybe throwing an exception } catch (ChromaX\CommonException\NetworkException\ConnectionException $exception) { // API is not reachable } catch (ChromaX\CommonException\NetworkException\CurlException $exception) { // Curl failed } catch (ChromaX\CommonException\ApiException\InvalidResponseException $exception) { // API returns an unexpected result } catch (ChromaX\CommonException\ApiException\RequestQuotaException $exception) { // API requests over the allowed limit } catch (ChromaX\CommonException\ApiException\NoResultsException $exception) { // API request had no result } catch (ChromaX\CommonException\IoException\FileWriteException $exception) { // Log file was not writable }, <sub>(*4)</sub>

#### Catching by parent class

```{php}
try{
    // Perform something maybe throwing an exception
} catch (ChromaX\CommonException\NetworkException\Base\NetworkException $exception) {
    // Any network exception was thrown
} catch (ChromaX\CommonException\ApiException\Base\ApiException $exception) {
    // Any API exception was thrown
} catch (ChromaX\CommonException\IoException\Base\IoException $exception) {
    // Any IO exception was thrown
}

Catching by grand parent class

```{php} try{ // Perform something maybe throwing an exception } catch (ChromaX\CommonException\Base\BaseException $exception) { // Any exception was thrown }, <sub>(*5)</sub>

```, <sub>(*6)</sub>

Contribution

Contributing to our projects is always very appreciated.
But: please follow the contribution guidelines written down in the CONTRIBUTING.md document., <sub>(*7)</sub>

License

PHP Common Exceptions is under the MIT license., <sub>(*8)</sub>