A lightweight, framework-agnostic collection of well-defined exception classes that extend PHP's native Exception. Each type represents a clear, specific error scenario — making error handling more expressive, consistent and easier to maintain.

📚 Documentation

You are currently browsing the auto-generated API reference (phpDocumentor).

• 🌐 Online API documentation
• 📒 Changelog

📦 Installation

This library requires PHP 8.4+ and is installed via Composer:

composer require oihana/php-exceptions

✨ Features

• 🛠 Ready-to-use exception classes for common application errors.
• 🧩 Extends the standard Exception class where relevant.
• 🌐 HTTP error exceptions (Error400 … Error500) with sensible default messages and status codes.
• 🔍 Improves code readability and error semantics.
• ⚡ Lightweight with zero external dependencies.
• 📦 Easily integrable in any PHP project or framework.

✅ Tests & coverage

Run the unit-test suite (PHPUnit, strict mode):

composer test

Measure coverage (requires Xdebug or PCOV):

composer coverage
composer coverage:md

🧾 License

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

👤 About the Author

• Name: Marc ALCARAZ (aka eKameleon)
• Website: www.ooop.fr
• Email: marc@ooop.fr

🔗 Related packages

• oihana/php-core — core helpers and utilities used across the Oihana libraries.

🔗 Project on GitHub

View the full source code and contribute on GitHub: github.com/BcommeBois/oihana-php-exceptions.