*/ class Loggr implements LoggerInterface { /** @var array $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); } }