https://github.com/askonomm/loggr
An extendable logging utility class with built-in support for various logging formats.
https://github.com/askonomm/loggr
logging php
Last synced: 4 months ago
JSON representation
An extendable logging utility class with built-in support for various logging formats.
- Host: GitHub
- URL: https://github.com/askonomm/loggr
- Owner: askonomm
- License: mit
- Created: 2024-11-10T20:27:01.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-17T14:15:59.000Z (about 1 year ago)
- Last Synced: 2025-01-11T19:52:20.767Z (about 1 year ago)
- Topics: logging, php
- Language: PHP
- Homepage:
- Size: 82 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Loggr
[](https://codecov.io/gh/askonomm/loggr)
An extendable logging utility class brought to you by the frustration of every logging class always having its own unique format,
which makes using log viewing tools difficult. Instead of having its own yet-another-format that no tool supports, Loggr attempts to match
many already existing formats, allowing you to use whichever you prefer most.
## Requirements
- PHP 8.3+
## Installation
```bash
composer require asko/loggr
```
## Usage
Loggr is very simple to use, and looks like this:
```php
$loggr = new Loggr(new FileSystemDriver('path-to-logs'));
$loggr->info('message', ['some-data' => 'goes-here']);
```
All you have to do is instantiate Loggr with the appropriate driver for your use case and then simply
log away with any data you want to give it. As per the PSR-3 standard, you can also interpolate context values
into the message placeholder, like so:
```php
$loggr = new Loggr(new FileSystemDriver('path-to-logs'));
$loggr->info('Hello {who}', ['who' => 'World']);
```
Which would then output `Hello World` as the message.
### Methods
Loggr supports all of these logging methods:
- `emergency(string $message, mixed $context = null)`
- `alert(string $message, mixed $context = null)`
- `critical(string $message, mixed $context = null)`
- `error(string $message, mixed $context = null)`
- `warning(string $message, mixed $context = null)`
- `notice(string $message, mixed $context = null)`
- `info(string $message, mixed $context = null)`
- `debug(string $message, mixed $context = null)`
- `log(mixed $level, string $message, mixed $context = null)`
### Setting log format
You can change the logging format by setting the `format` variable in Loggr constructor to a value of `Format` enum, like so:
```php
$loggr = new Loggr(new FileSystemDriver('path-to-logs'), format: Format::JSON);
```
Or, if that gets a bit too long for just one line, you can also do:
```php
$loggr = new Loggr(new FileSystemDriver('path-to-logs'));
$loggr->format = Format::JSON;
```
Loggr supports the following log formats:
- `Format::JSON` - Entries are JSON objects.
- `Format::Laravel` - Entries correspond to the Laravel log format.
- `Format::Symfony` - Entries correspond to the Symfony log format.
- `Format::IntelliJ` - Entries correspond to the IntelliJ log format.
## Extending
You can extend Loggr with your own custom drivers. A driver is a class that implements the `Driver` interface and is
responsible for making sure that the serialized log entry would end up in the right place.
### Built-in drivers
- [FileSystemDriver](https://github.com/askonomm/loggr/blob/main/src/Drivers/FileSystemDriver.php)
- [OutputDriver](https://github.com/askonomm/loggr/blob/main/src/Drivers/OutputDriver.php)