A collection of strongly-typed constant enumerations for PHP — over 1,600 constants across 73 classes (general, HTTP, mail, JWT/JOSE, OAuth 2.0/OIDC), all sharing one reflection API through ConstantsTrait. No magic strings.

📚 Documentation

Narrative user guides (FR + EN), with examples and the full catalogue per namespace:

• 🇬🇧 English documentation
• 🇫🇷 Documentation française

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

📦 Installation

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

composer require oihana/php-enums

✨ Features

• 📦 73 enumerations / 1,600+ constants across general, HTTP, mail/SMTP, JWT/JOSE and OAuth 2.0/OIDC domains.
• 🔍 One shared reflection API via ConstantsTrait — enums(), includes(), getConstant(), validate() — identical on every class.
• 🧩 Composable per-category traits for HttpHeader and MailHeader — use only what you need.
• ⚙️ Domain helpers where they help (status descriptions, SMTP security, mail priority conversions, postal-code validation, …).
• 🛡️ No magic strings — typo-safe, refactor-friendly, IDE-autocompleted.

✅ Tests & coverage

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

composer test

Run a single test case:

./vendor/bin/phpunit --filter HttpStatusCodeTest

Measure coverage (requires Xdebug or PCOV):

composer coverage
composer coverage:md

The suite covers 100% of lines (323/323). See the testing guide: English · Français.

🧾 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 by this library.
• oihana/php-reflect — reflection and hydration utilities (provides ConstantsTrait).

🔗 Project on GitHub

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