A lightweight, PSR-3 logging toolkit for PHP 8.4+.

📚 Documentation

Narrative user guides (FR + EN), with examples:

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

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

🚀 Features

• 🪵 A PSR-3 compliant, daily-file Logger with message interpolation.
• 🧩 A CompositeLogger broadcasting to many PSR-3 loggers (WeakMap-based).
• 🔄 A Monolog-based rotating-file manager (MonoLogManager) and a LoggerManager base class.
• 🧰 Composable logger traits — LoggerTrait, LoggerManagerTrait, DebugTrait.
• ✨ Custom Monolog processors — emoji and symbol level decorators.
• 🧪 100% unit-test line coverage, ensuring reliability and maintainability.

📦 Installation

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

composer require oihana/php-logging

✅ 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.
• oihana/php-files — file and path handling utilities.
• oihana/php-enums — strongly-typed constant enumerations.

🔗 Project on GitHub

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