README

PSR-3 compliant dual logger for PHP 8.1+ with:

date-based log file structure with configurable subdirectory pattern
automatic log rotation by file size
caller location in every log entry (directory/file.php:line)
automatic anonymization of sensitive fields
configurable minimum log level for file output
configurable date format and timezone

Installation

composer require mafio69/fast-php-logger

Quick start

use Mariusz\Logger\DualLogger;

// one-liner factory
$logger = DualLogger::create('./logs');

$logger->info('Server started');
$logger->warning('Login failed', ['email' => 'jan@example.com', 'token' => 'abc123xyz']);

Or with full control:

use Mariusz\Logger\DualLogger;
use Mariusz\Logger\LogFileManager;
use Psr\Log\LogLevel;

$logger = new DualLogger(
    new LogFileManager('./logs'),
    minLevel: LogLevel::DEBUG,
);

Output:

[2026-05-02 01:54:00] [INFO]    [Bootstrap/App.php:12] Server started
[2026-05-02 01:54:00] [WARNING] [Auth/Service.php:88]  Login failed {"email":"jan****com","token":"a****yz"}

Configuration

LogFileManager

new LogFileManager(
    logDir:        './logs',      // base log directory
    maxFileSize:   1048576,       // max file size in bytes before rotation (default: 1MB)
    maxFiles:      5,             // max number of rotated archives to keep (default: 5)
    prefix:        'app-',        // filename prefix  → app-2026-05-02.log
    suffix:        '-prod',       // filename suffix  → 2026-05-02-prod.log
    dateStructure: 'Y/m',         // subdirectory pattern (default: year/month)
)

dateStructure examples

Value	Path
`'Y/m'` (default)	`logs/2026/05/2026-05-02.log`
`'Y'`	`logs/2026/2026-05-02.log`
`'Y/m/d'`	`logs/2026/05/02/2026-05-02.log`
`''`	`logs/2026-05-02.log` (flat)

prefix + suffix examples

prefix	suffix	filename
`'app-'`	`''`	`app-2026-05-02.log`
`''`	`'-prod'`	`2026-05-02-prod.log`
`'api-'`	`'-v2'`	`api-2026-05-02-v2.log`

DualLogger

new DualLogger(
    fileManager: new LogFileManager('./logs'),
    minLevel:    LogLevel::WARNING,   // minimum level written to file (default: warning)
    dateFormat:  'Y-m-d H:i:s',      // timestamp format (default: ISO-like)
    timezone:    'Europe/Warsaw',     // timezone (default: system timezone)
)

minLevel examples

minLevel	Written to file
`LogLevel::DEBUG`	everything
`LogLevel::INFO`	info and above
`LogLevel::WARNING` (default)	warning, error, critical, alert, emergency
`LogLevel::ERROR`	error and above only

dateFormat examples

dateFormat	Output
`'Y-m-d H:i:s'` (default)	`2026-05-02 01:54:00`
`'d.m.Y H:i'`	`02.05.2026 01:54`
`'c'`	`2026-05-02T01:54:00+02:00`

Anonymization

Sensitive fields in log context are automatically masked — the middle portion is replaced with ****, keeping ~25% visible at each end so developers can identify values without exposing full data.

$logger->warning('Login failed', [
    'email'    => 'jan.kowalski@gmail.com',  // → jan.****@gmail.com
    'token'    => 'supersecret123',           // → supe****t123
    'pesel'    => '12345678901',              // → 123****901
    'password' => 'ab',                       // → ****  (too short)
]);

Masked fields: pesel, nip, ssn, passport, email, phone, telefon, password, token, api_key, secret, session, card, iban, cvv, konto, adres, street and more.

STDERR suppression in tests

Set APP_ENV=test to suppress STDERR output during tests. In phpunit.xml:

<php>
    <env name="APP_ENV" value="test" force="true"/>
</php>

Laravel

Auto-discovered via extra.laravel.providers. No manual registration needed.

Publish config:

php artisan vendor:publish --tag=fast-php-logger-config

config/php-logger.php:

return [
    'log_dir'    => storage_path('logs'),
    'min_level'  => env('LOG_LEVEL', 'warning'),
    'date_format' => 'Y-m-d H:i:s',
    'timezone'   => env('APP_TIMEZONE', ''),
    'file' => [
        'max_file_size'  => 1048576,
        'max_files'      => 5,
        'prefix'         => '',
        'suffix'         => '',
        'date_structure' => 'Y/m',
    ],
];

Resolve from container:

$logger = app(\Mariusz\Logger\DualLogger::class);

Symfony

return [
    Mariusz\Logger\Symfony\PhpLoggerBundle::class => ['all' => true],
];

Optional config in config/packages/php_logger.yaml:

php_logger:
    log_dir:     '%kernel.logs_dir%'
    min_level:   warning
    date_format: 'Y-m-d H:i:s'
    timezone:    ''
    file:
        max_file_size:  1048576
        max_files:      5
        prefix:         ''
        suffix:         ''
        date_structure: 'Y/m'

Inject via autowiring:

use Mariusz\Logger\DualLogger;

class MyService
{
    public function __construct(private DualLogger $logger) {}
}

Testing

composer install
composer test

mafio69 / fast-php-logger

Maintainers

Package info

Statistics

Security