oihana/php-exceptions

The Oihana PHP Core library

dev-main 2025-08-13 17:47 UTC

Requires

• php: >=8.4
• ext-intl: *

Requires (Dev)

• mikey179/vfsstream: ^1.6
• nunomaduro/collision: ^8.8
• phpdocumentor/shim: ^3.8
• phpunit/phpunit: ^12

MPL-2.0

• Marc Alcaraz

• php
• exceptions

README

A curated set of reusable custom exception classes for PHP

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

Full project documentation is available at:

• 👉 https://bcommebois.github.io/oihana-php-exceptions
• 📒 CHANGELOG.md

📦️ Installation

Requires PHP 8.4+

Install via Composer:

composer require oihana/php-exceptions

✨ 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

To run all tests:

$ composer test

🧾 License

This project is licensed under the Mozilla Public License 2.0 (MPL-2.0).

👤 About the author

• Author : Marc ALCARAZ (aka eKameleon)
• Mail : [e-mail]
• Website : http://www.ooop.fr