pivotphp / logger

v0.1.0 2026-10-12 20:05 UTC

Requires

• php: >=8.2
• monolog/monolog: ^3.0
• psr/log: ^1.1 || ^2.0 || ^3.0

Requires (Dev)

• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^10.5 || ^11.0
• squizlabs/php_codesniffer: ^3.10

MIT

• Caio Alberto Fernandes

• logging
• php
• monolog
• logger
• psr-3
• opentelemetry
• pivotphp

Published on Packagist.org on 2026-10-15 13:57 UTC

README

Implementação de logging em conformidade com PSR-3 (Psr\Log\LoggerInterface) desenvolvida para o ecossistema PivotPHP, baseada no motor Monolog.

Oferece suporte a múltiplos canais, rotação de arquivos diária com retenção configurável, saída para console/streams para contêineres Docker/Kubernetes, formatação estruturada em JSON, sanitização de dados sensíveis e integração direta com o container de injeção de dependências do PivotPHP.

Instalação

composer require pivotphp/logger

Requisitos

• PHP >= 8.2
• Monolog >= 3.0
• PSR-3 (psr/log)

Uso Básico

use PivotPHP\Logger\LoggerFactory;

$logger = LoggerFactory::create([
    'default' => 'daily',
    'channels' => [
        'daily' => [
            'path' => 'storage/logs/app.log',
            'days' => 14,
            'level' => 'debug',
        ],
        'stdout' => [
            'stream' => 'php://stdout',
            'level' => 'info',
            'formatter' => 'json',
        ],
    ],
]);

$logger->info('Usuário autenticado', ['user_id' => 42]);

Integração com PivotPHP

Ao utilizar o LoggerServiceProvider, a instância é automaticamente vinculada ao container de serviços sob Psr\Log\LoggerInterface::class, log e logger.

Licença

Distribuído sob a licença MIT. Consulte o arquivo LICENSE para obter mais informações.