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 : marc@ooop.fr
• Website : http://www.ooop.fr