monolog-factory

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

monolog-factory

(★ 26)

🏭 Configuration-based Monolog logger factory.

monolog-factory Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Monolog Factory

[![Build Status][ico-build]][link-build]
[![Code Quality][ico-code-quality]][link-code-quality]
[![Code Coverage][ico-code-coverage]][link-code-coverage]
[![Latest Version][ico-version]][link-packagist]
[![PDS Skeleton][ico-pds]][link-pds]

[Monolog][link-monolog] Factory that allows configuration-based creation of Logger objects.

In addition to the generic factory, this package features one to be used with [PSR-11][link-psr11] dependency injection containers.

## Installation

The preferred method of installation is via [Composer](http://getcomposer.org/). Run the following command to install 
the latest version of a package and add it to your project's `composer.json`:

```bash
composer require nikolaposa/monolog-factory
```

## Usage

**Generic factory**

``` php
use Monolog\Formatter\HtmlFormatter;
use Monolog\Handler\NativeMailerHandler;
use Monolog\Logger;
use Monolog\Processor\PsrLogMessageProcessor;
use MonologFactory\LoggerFactory;

$loggerFactory = new LoggerFactory();

$logger = $loggerFactory->create('my_logger', [
    'handlers' => [
        [
            'name' => NativeMailerHandler::class,
            'params' => [
                'to' => 'test@example.com',
                'subject' => 'Test',
                'from' => 'noreply@example.com',
                'level' => Logger::ALERT,
            ],
            'formatter' => [
                'name' => HtmlFormatter::class,
            ],
        ],
    ],
    'processors' => [
        [
            'name' => PsrLogMessageProcessor::class,
        ],
    ],
]);
```

**DI container factory configuration**

```php
use Monolog\Formatter\HtmlFormatter;
use Monolog\Handler\BufferHandler;
use Monolog\Handler\NativeMailerHandler;
use Monolog\Logger;
use Monolog\Processor\PsrLogMessageProcessor;
use MonologFactory\DiContainerLoggerFactory;

return [
    'logger' => [
        'logger1' => [
            'name' => 'logger1',
            'handlers' => [
                [
                    'name' => NativeMailerHandler::class,
                    'params' => [
                        'to' => 'test@example.com',
                        'subject' => 'Test',
                        'from' => 'noreply@example.com',
                        'level' => Logger::ALERT,
                    ],
                    'formatter' => [
                        'name' => HtmlFormatter::class,
                    ],
                ],
            ],
            'processors' => [
                [
                    'name' => PsrLogMessageProcessor::class,
                ],
            ],
        ],
        'logger2' => [
            'name' => 'logger2',
            'handlers' => [
                [
                    'name' => BufferHandler::class,
                    'params' => [
                        'handler' => [
                            '__class__' => NativeMailerHandler::class,
                            'to' => 'test@example.com',
                            'subject' => 'Test',
                            'from' => 'noreply@example.com',
                        ],
                        'buffer_limit' => 5,
                    ],
                    'processors' => [
                        [
                            'name' => MemoryUsageProcessor::class,
                        ],
                    ],
                ],
            ],
            'processors' => [
                [
                    'name' => PsrLogMessageProcessor::class,
                ],
            ],
        ],
    ],
    'di' => [
        'factories' => [
            'Logger1' => new DiContainerLoggerFactory('logger1'),
            //... or more preferred/optimal way:
            'Logger2' => [DiContainerLoggerFactory::class, 'logger2'],
        ],
    ],
];
```

See [more examples][link-examples].

## Credits

- [Nikola Poša][link-author]
- [All Contributors][link-contributors]

## License

Released under MIT License - see the [License File](LICENSE) for details.

[ico-version]: https://poser.pugx.org/nikolaposa/monolog-factory/v/stable
[ico-build]: https://github.com/nikolaposa/monolog-factory/workflows/Build/badge.svg?branch=master
[ico-code-coverage]: https://scrutinizer-ci.com/g/nikolaposa/monolog-factory/badges/coverage.png?b=master
[ico-code-quality]: https://scrutinizer-ci.com/g/nikolaposa/monolog-factory/badges/quality-score.png?b=master
[ico-pds]: https://img.shields.io/badge/pds-skeleton-blue.svg

[link-monolog]: https://github.com/Seldaek/monolog
[link-psr11]: https://www.php-fig.org/psr/psr-11/
[link-examples]: examples
[link-packagist]: https://packagist.org/packages/nikolaposa/monolog-factory
[link-build]: https://github.com/nikolaposa/monolog-factory/actions
[link-code-coverage]: https://scrutinizer-ci.com/g/nikolaposa/monolog-factory/code-structure
[link-code-quality]: https://scrutinizer-ci.com/g/nikolaposa/monolog-factory
[link-pds]: https://github.com/php-pds/skeleton
[link-author]: https://github.com/nikolaposa
[link-contributors]: ../../contributors

monolog-factory

monolog-factory Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

monolog-factory

monolog-factory Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README