PHPackages                             oihana/php-exceptions - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. oihana/php-exceptions

ActiveLibrary[Utility & Helpers](/categories/utility)

oihana/php-exceptions
=====================

The Oihana PHP Core library

0342PHP

Since Oct 22Pushed 6mo agoCompare

[ Source](https://github.com/BcommeBois/oihana-php-exceptions)[ Packagist](https://packagist.org/packages/oihana/php-exceptions)[ RSS](/packages/oihana-php-exceptions/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (2)

Oihana PHP - Exceptions library
===============================

[](#oihana-php---exceptions-library)

[![Oihana Php Exceptions](https://raw.githubusercontent.com/BcommeBois/oihana-php-exceptions/main/assets/images/oihana-php-exceptions-logo-inline-512x160.png)](https://raw.githubusercontent.com/BcommeBois/oihana-php-exceptions/main/assets/images/oihana-php-exceptions-logo-inline-512x160.png)

A curated set of reusable custom exception classes for PHP.

[![Latest Version](https://camo.githubusercontent.com/03c1906bb2ebf500b6de88bb568dbb61960779963effdd6a40acc17f1113cc99/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6f6968616e612f7068702d657863657074696f6e732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/oihana/php-exceptions)
[![Total Downloads](https://camo.githubusercontent.com/711ae993421d451d23c12445dc5d6ec0a488c4d7a2404a206a6c610d52f6d483/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f6968616e612f7068702d657863657074696f6e732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/oihana/php-exceptions)
[![License](https://camo.githubusercontent.com/4642362a50c0c1ff40d031d4d3c0e96f797cd6f39cd40a676644ec383b1edb23/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6f6968616e612f7068702d657863657074696f6e732e7376673f7374796c653d666c61742d737175617265)](LICENSE)

Oihana PHP Exceptions is a lightweight, framework-agnostic library providing a collection of well-defined exception classes that extend PHP’s native Exception class.

Each exception type is designed to represent a clear and specific error scenario, making your error handling more expressive, consistent, and easier to maintain.

📚 Documentation
---------------

[](#-documentation)

Full project documentation is available at:

- 👉
- 📒 [CHANGELOG.md](./CHANGELOG.md)

📦️ Installation
---------------

[](#️-installation)

> **Requires [PHP 8.4+](https://php.net/releases/)**

Install via [Composer](https://getcomposer.org):

```
composer require oihana/php-exceptions
```

✨ Features
----------

[](#-features)

- 🛠 Ready-to-use exception classes for common application errors.
- 🧩 Extends the standard Exception class (or RuntimeException, InvalidArgumentException, etc. where relevant).
- 🔍 Improves code readability and error semantics.
- ⚡ Lightweight with zero external dependencies.
- 📦 Easily integrable in any PHP project or framework.

✅ Running Unit Tests
--------------------

[](#-running-unit-tests)

To run all tests:

```
$ composer test
```

🧾 License
---------

[](#-license)

This project is licensed under the [Mozilla Public License 2.0 (MPL-2.0)](https://www.mozilla.org/en-US/MPL/2.0/).

👤 About the author
------------------

[](#-about-the-author)

- Author : Marc ALCARAZ (aka eKameleon)
- Mail :
- Website :

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance46

Moderate activity, may be stable

Popularity9

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity13

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/d234506e51778dd3d1d61b6c2af6f294ff963651b4aa509b595d3d2a77b7d89b?d=identicon)[ooop](/maintainers/ooop)

---

Top Contributors

[![ekameleon](https://avatars.githubusercontent.com/u/749032?v=4)](https://github.com/ekameleon "ekameleon (7 commits)")

### Embed Badge

![Health badge](/badges/oihana-php-exceptions/health.svg)

```
[![Health](https://phpackages.com/badges/oihana-php-exceptions/health.svg)](https://phpackages.com/packages/oihana-php-exceptions)
```

###  Alternatives

[components/jqueryui

jQuery UI is a curated set of user interface interactions, effects, widgets, and themes built on top of the jQuery JavaScript Library. Whether you're building highly interactive web applications or you just need to add a date picker to a form control, jQuery UI is the perfect choice.

1795.8M57](/packages/components-jqueryui)[clue/graph-composer

Dependency graph visualization for composer.json

93798.0k11](/packages/clue-graph-composer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)