README

Requirements

• PHP 7 or greater
• Json extension

Feature

• JSON output format

Installation

Installation is possible using Composer.

composer require azay/json-logger

Basic usage

<?php

use Azay\Log\JsonLogger;

require_once __DIR__ . '/vendor/autoload.php';

$logger = new JsonLogger(/tmp/logger);

Log levels

Logger supports the logging levels described by RFC 5424.

Set logging level for your app

// Optional, set maximum severity level, default `debug`
$logger->setLevel('info');
// or as constant
$logger->setLevel($logger::INFO);

Break Lines

$logger->setBreakLines();   // Set default break line "\n" between records

$logger->setBreakLines("\n\r");  // Set custom break line

Timestamp format

$logger->setTimeFormat('r');  // Set timestamp to RFC 2822 format

Flat mode

If "Flat Mode" is enabled, all contextual data is recorded at the same level. Otherwise, the contextual data is inserted as it is.

$logger->setFlatMode();     // Optional

Example #1

<?php

use Azay\Log\JsonLogger;

require_once __DIR__ . '/vendor/autoload.php';

$logger = new JsonLogger(sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'simple_log');
$logger->setLevel(JsonLogger::INFO)
    ->setBreakLines()
    ->setTimeFormat('r')
    ->setFlatMode();

$logger->info(
    'Info message for json logger',
    [
        'Foo' => 'Bar'
    ]
);

// This message will be ignored by severity
$logger->debug(
    'Verbose debug message',
    [
        'details' => 'Lorem ipsum...'
    ]
);

Output

file logger.json

{"timestamp":"Tue, 03 Jun 2025 12:47:25 +0000","level":"info","message":"Info message for json logger","Foo":"Bar"}

Example #2

<?php

use Azay\Log\JsonLogger;

require_once __DIR__ . '/vendor/autoload.php';

$logger = new JsonLogger(sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'simple_log');

$logger->info(
    'Info message for json logger',
    [
        'Foo' => 'Bar'
    ]
);

// This message will be ignored by severity
$logger->debug(
    'Verbose debug message',
    [
        'details' => 'Lorem ipsum...'
    ]
);

Output

file logger.json

{"timestamp":"2025-06-03 12:49:39","level":"info","message":"Info message for json logger","context":{"Foo":"Bar"}}{"timestamp":"2025-06-03 12:49:39","level":"debug","message":"Verbose debug message","context":{"details":"Lorem ipsum..."}}