SimpleLogger
, (*1)
SimpleLogger is a PHP library to write logs.
It has simple, straightforward defaults with additional customization hooks., (*2)
Usage
Installation
composer require firehed/simplelogger
Syslog
Send log messages to Syslog:, (*3)
<?php
require 'vendor/autoload.php';
// Setup Syslog logging
$logger = new Firehed\SimpleLogger\Syslog('myapp');
// Output to syslog: "Jun 2 15:55:09 hostname myapp[2712]: foobar"
$logger->error('foobar');
// Output to syslog: "Jun 2 15:55:09 hostname myapp[2712]: Error at /Users/Me/Devel/libraries/simpleLogger/example.php at line 15"
$logger->error('Error at {filename} at line {line}', ['filename' => __FILE__, 'line' => __LINE__]);
Files
Send log messages to a text file:, (*4)
<?php
require 'vendor/autoload.php';
// Setup File logging
$logger = new Firehed\SimpleLogger\File('/tmp/simplelogger.log');
// Output to the file: "[2013-06-02 16:03:28] [info] foobar"
$logger->info('foobar');
// Output to the file: "[2013-06-02 16:03:28] [error] Error at /Users/fred/Devel/libraries/simpleLogger/example.php at line 24"
$logger->error('Error at {filename} at line {line}', ['filename' => __FILE__, 'line' => __LINE__]);
Stdout and Stderr
$logger = new \Firehed\SimpleLogger\Stdout();
// or
$logger = new \Firehed\SimpleLogger\Stderr();
These loggers will write to STDOUT or STDERR; i.e. php://stdout or php://stderr.
Stdout is very commonly used for Docker and/or Kubernetes., (*5)
Minimum log level for loggers
In this example, only messages with the level >= "error" will be sent to the Syslog handler but everything is sent to the File handler:, (*6)
<?php
require 'vendor/autoload.php';
$syslog = new Firehed\SimpleLogger\Syslog('myapp');
$syslog->setLevel(Psr\Log\LogLevel::ERROR); // Define the minimum log level
$file = new Firehed\SimpleLogger\File('/tmp/simplelogger.log');
$logger = new Firehed\SimpleLogger\ChainLogger([$syslog, $file]);
$logger->debug('debug info sent only to the text file');
$logger->error('my error message');
$logger->error('my error message with a {variable}', ['variable' => 'test']);
The minimum log level is LogLevel::DEBUG by default., (*7)
Starting in 3.0.0, message format customization can be accomplished in several ways:, (*8)
- Initialize
DefaultFormatter, change its format with setFormat(string $format), and pass it to your logger's constructor
- Use a different bundled formatter, such as
LogFmtFormatter
- Create a class that implements
FormatterInterface and pass that to your logger's constructor
The format provided MUST include %s, which is where the actual interpolated message will be placed.
Formats MAY include {date} and/or {level}, which are placeholders for the timestamp and log level respectively., (*9)
The default format is [{date}] [{level}] %s, which will result in a log message like this:, (*10)
[2018-06-28T13:32:12+00:00] [debug] query finished in 0.0021688938140869s
The date defaults to ATOM format, but can also be customized via setDateFormat(string $format) using any format string that date() accepts., (*11)
By default, this will ignore exception keys and perform normal message interpolation.
By calling setRenderExceptions(true), the equivalent of (string) $context['exception'] will be appended to the log message if that key is set, so long as that value is Throwable., (*12)
LogFmt
The LogFmtFormatter will write logs in logfmt.
By default, the msg, level, and ts keys will be set, and any values in context that are not interpolated will be added as additional key/value pairs.
Exceptions will also be rendered, in exception_message, exception_type, and exception_stacktrace per OTel conventions., (*13)
Any values that resolve to empty strings, or cannot be cast to a string (arrays, objects without __toString()) will be removed., (*14)
[!TIP]
Any interpolated values from context will not be put in the key/value pairs.
To make the most out of structured log formats such as logfmt, limit interpolation keys in the coded message., (*15)
For example, prefer this:, (*16)
$logger->debug('Request complete', ['duration_ms' => $ms]);
// produces `msg="Request complete" duration_ms=42`
over this:, (*17)
$logger->debug('Request complete in {duration} ms', ['duration' => $ms]);
// produces `msg="Request complete in 42 ms"`
If you need deeper customization, such as log enrichment or more major format shifts, a custom FormatterInterface is the way to go.
Doing so requires your own interpolation logic, as well as any other message enrichment or formatting.
You'll be passed the same (unmodified) parameters as LoggerInterface::log() gets, and are responsible for transforming these values into a string., (*18)
Sending to multiple loggers
Send log messages to multiple PSR-3 loggers with ChainLogger():, (*19)
<?php
require 'vendor/autoload.php';
use Firehed\SimpleLogger as SL;
$logger = new SL\ChainLogger([new SL\StdErr()]);
$logger->addLogger(new SL\Syslog('myapp'));
$logger->addLogger(new SL\File('/tmp/simplelogger.log'));
$logger->info('my message');
$logger->error('my error message');
$logger->error('my error message with a {variable}', ['variable' => 'test']);
The ChainLogger supports a log level, in addition to loggers it relays to.
This is configuable only by a constructor parameter.
If a log entry is less severe than the configured level, none of the loggers in the chain will receive the message.
Those loggers may opt to do additional filtering., (*20)
Wallogit.com
