1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
|
<?php
namespace Asko\Loggr;
use Psr\Log\LoggerInterface;
/**
* Loggr is an extendable logging utility class brought to you by the frustration of
* every logging class always having its own unique format, making debugging 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.
*
* @author Asko Nõmm <asko@faultd.com>
*/
class Loggr implements LoggerInterface
{
/** @var array<string, mixed> $trace */
private array $trace;
/**
* Since it would suck if a logging utility throws an exception,
* Loggr instead of throwing will simply set the error here, in case
* logging doesn't work, and you might want to find out why.
*
* @var string|null $error
*/
public ?string $error = null;
public function __construct(
public ?Driver $driver = null,
public ?Format $format = Format::Laravel,
){}
/**
* Logs a message at a specified level with optional context.
*
* @param Level $level The severity level of the log message. Defaults to Level::Info.
* @param string $message The log message.
* @param mixed $context Additional data or context to include with the log message. Optional.
* @return void
*/
private function write(Level $level, string $message, mixed $context = null): void
{
if (!$this->driver || !$this->format) {
$this->error = "Driver or format not set.";
return;
}
$this->driver->log($this->format->serialize(new Message(
level: $level,
trace: $this->trace,
content: $message,
context: $context,
)));
}
/**
* Logs an emergency level message with optional context.
*
* @param string|\Stringable $message
* @param mixed $context Additional data or context to include with the emergency message. Optional.
* @return void
*/
public function emergency(string|\Stringable $message, mixed $context = null): void
{
$this->trace = debug_backtrace()[0];
$this->write(Level::Emergency, $message, $context);
}
/**
* Sends an alert-level log message with optional context.
*
* @param string|\Stringable $message
* @param mixed $context Additional data or context to include with the log message. Optional.
* @return void
*/
public function alert(string|\Stringable $message, mixed $context = null): void
{
$this->trace = debug_backtrace()[0];
$this->write(Level::Alert, $message, $context);
}
/**
* Logs a critical level message with optional context.
*
* @param string|\Stringable $message
* @param mixed $context Additional data or context to include with the log message. Optional.
* @return void
*/
public function critical(string|\Stringable $message, mixed $context = null): void
{
$this->trace = debug_backtrace()[0];
$this->write(Level::Critical, $message, $context);
}
/**
* Logs an error message with optional context.
*
* @param string|\Stringable $message
* @param mixed $context Additional data or context to include with the error message. Optional.
* @return void
*/
public function error(string|\Stringable $message, mixed $context = null): void
{
$this->trace = debug_backtrace()[0];
$this->write(Level::Error, $message, $context);
}
/**
* Logs a warning message with the specified context.
*
* @param string|\Stringable $message
* @param mixed $context Optional context information to include in the log.
* @return void
*/
public function warning(string|\Stringable $message, mixed $context = null): void
{
$this->trace = debug_backtrace()[0];
$this->write(Level::Warning, $message, $context);
}
/**
* Logs a notice message with the specified context.
*
* @param string|\Stringable $message
* @param mixed $context Optional context information to include in the log.
* @return void
*/
public function notice(string|\Stringable $message, mixed $context = null): void
{
$this->trace = debug_backtrace()[0];
$this->write(Level::Notice, $message, $context);
}
/**
* Logs an informational message with the specified context.
*
* @param string|\Stringable $message
* @param mixed $context Optional context information to include in the log.
* @return void
*/
public function info(string|\Stringable $message, mixed $context = null): void
{
$this->trace = debug_backtrace()[0];
$this->write(Level::Info, $message, $context);
}
/**
* Logs a debug message with the specified context.
*
* @param string|\Stringable $message
* @param mixed $context Optional context information to include in the log.
* @return void
*/
public function debug(string|\Stringable $message, mixed $context = null): void
{
$this->trace = debug_backtrace()[0];
$this->write(Level::Debug, $message, $context);
}
public function log(mixed $level, \Stringable|string $message, array $context = []): void
{
$this->trace = debug_backtrace()[0];
$this->write(Level::from($level), $message, $context);
}
}
|
