README

A lightweight structured logging library for PHP with daily file rotation and level filtering.

Supported PHP Versions

This library requires PHP 8.1 or higher.

Build Status

Features

• Logger interface — swap implementations without changing application code
• FileLogger — daily-rotated log files with structured format
• Static facade (LoggerFacade) for quick usage without DI
• Level filtering — set minimum level (debug, info, warning, error, critical)
• Structured context — attach key-value metadata to log entries
• Zero dependencies — requires only PHP 8.1+

Installation

composer require webfiori/log

Usage

Basic Logging

use WebFiori\Log\FileLogger;
use WebFiori\Log\LogLevel;

$logger = new FileLogger('/var/log/myapp', LogLevel::INFO);

$logger->info('User logged in', ['user_id' => 42, 'ip' => '192.168.1.1']);
$logger->error('Payment failed', ['order_id' => 123, 'reason' => 'timeout']);
$logger->debug('This will be filtered out'); // below INFO threshold

Output (/var/log/myapp/app-2026-05-29.log):

[2026-05-29 01:00:00] [INFO] User logged in {"user_id":42,"ip":"192.168.1.1"}
[2026-05-29 01:00:00] [ERROR] Payment failed {"order_id":123,"reason":"timeout"}

Static Facade

use WebFiori\Log\LoggerFacade;

LoggerFacade::info('Application started');
LoggerFacade::error('Something went wrong', ['exception' => $e->getMessage()]);

Custom Logger Implementation

use WebFiori\Log\Logger;

class DatabaseLogger implements Logger {
    public function debug(string $message, array $context = []): void { /* ... */ }
    public function info(string $message, array $context = []): void { /* ... */ }
    public function warning(string $message, array $context = []): void { /* ... */ }
    public function error(string $message, array $context = []): void { /* ... */ }
    public function critical(string $message, array $context = []): void { /* ... */ }
    public function log(string $level, string $message, array $context = []): void { /* ... */ }
}

LoggerFacade::setInstance(new DatabaseLogger());

API

Logger (interface)

FileLogger

LogLevel

LoggerFacade

License

MIT