Download the PHP package koded/logging without Composer
On this page you can find all versions of the php package koded/logging. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download koded/logging
More information about koded/logging
Files in koded/logging
Package logging
Short Description A simple standalone logging facility with several log processors
License BSD-3-Clause
Homepage https://github.com/kodedphp/logging
Informations about the package logging
Koded - Logging Library
A simple message logging library that implements PSR-3 with several log processors. It supports multiple log writers that can be set separately and process messages based on the log level.
Installation
Use composer and run
composer require koded/logging
or add it manually in your current composer.json
Usage
Configuration
Param | Type | Required | Default | Description |
---|---|---|---|---|
(processors) | array | yes | (empty) | An array of log processors. Every processor is defined in array with it's own configuration parameters. See processor directives |
dateformat | string | no | "d/m/Y H:i:s.u" | The date format for the log message. Microseconds are prepended by default |
timezone | string | no | "UTC" | The desired timezone for the log message |
Processor default directives
Every log processor has it's own set of configuration directives.
The table shows log parameters in the classes.
Param | Type | Required | Default | Description |
---|---|---|---|---|
class | string | yes | The name of the log processor class | |
levels | integer | no | -1 | Packed integer for bitwise comparison. See the constants in Logger class |
Levels example
The messages are filtered with bitwise operator against the levels
value.
Every processor will filter out the messages as defined in it's levels directive.
For instance, to log only WARNING, INFO and ERROR messages, set levels to
Tips:
- every processor is configured separately
- if you want to process all log levels, skip the
levels
value or set it to -1 (by default) - if you want to suppress a specific processor, set it's level to 0
Processors
Class name | Description |
---|---|
ErrorLog | uses the error_log() function to send the message to PHP's logger |
Cli | write the messages in the console (with STDERR) |
Memory | will store all messages in an array. Useful for unit tests if the logger is involved |
SysLog | will open the system logger and send messages using the syslog() function |
File | saves the messages on a disk |
Benchmarks and tests
License
The code is distributed under the terms of The 3-Clause BSD license.