- minimum PHP version (8.1)

Author: kodeart

Log.php

@@ -15,7 +15,14 @@
 use Koded\Logging\Processors\{Cli, Processor};
 use DateTimeZone;
 use Psr\Log\LoggerTrait;
+use Stringable;
 use Throwable;
+use function constant;
+use function date_create_immutable;
+use function spl_object_id;
+use function strtoupper;
+use function strtr;
+use function timezone_open;
 
 /**
  * Class Log for logging different types of application messages.
@@ -78,17 +85,17 @@ public function __construct(
         private string $dateformat = self::DATE_FORMAT,
         string $timezone = 'UTC')
     {
-        $this->timezone = @\timezone_open($timezone) ?: \timezone_open('UTC');
+        $this->timezone = @timezone_open($timezone) ?: timezone_open('UTC');
         foreach ($processors as $processor) {
             $this->attach(new $processor['class']($processor));
         }
     }
 
-    public function log($level, $message, array $context = []): void
+    public function log($level, string|Stringable $message, array $context = []): void
     {
         try {
-            $levelName = \strtoupper($level);
-            $level = \constant('static::' . $levelName);
+            $levelName = strtoupper($level);
+            $level = constant('static::' . $levelName);
         } catch (Throwable) {
             $levelName = 'LOG';
             $level = -1;
@@ -106,21 +113,21 @@ public function log($level, $message, array $context = []): void
     public function attach(Processor $processor): Logger
     {
         if (0 !== $processor->levels()) {
-            $this->processors[\spl_object_id($processor)] = $processor;
+            $this->processors[spl_object_id($processor)] = $processor;
         }
         return $this;
     }
 
     public function detach(Processor $processor): Logger
     {
-        unset($this->processors[\spl_object_id($processor)]);
+        unset($this->processors[spl_object_id($processor)]);
         return $this;
     }
 
     public function exception(Throwable $e, Processor $processor = null): void
     {
         $this->attach($processor ??= new Cli([]));
-        $this->critical($e->getMessage() . PHP_EOL . ' -- [Trace]: ' . $e->getTraceAsString());
+        $this->critical($e->getMessage() . PHP_EOL . ' [Trace]: ' . $e->getTraceAsString());
         $this->detach($processor);
     }
 
@@ -138,12 +145,12 @@ private function formatMessage(object|string $message, array $params = []): stri
         foreach ($params as $k => $v) {
             $replacements['{' . $k . '}'] = $v;
         }
-        return \strtr((string)$message, $replacements);
+        return strtr((string)$message, $replacements);
     }
 
     private function now(): string
     {
-        return \date_create_immutable('now', $this->timezone)
+        return date_create_immutable('now', $this->timezone)
             ->format($this->dateformat);
     }
 }

Processors/Cli.php

@@ -12,6 +12,11 @@
 
 namespace Koded\Logging\Processors;
 
+use function defined;
+use function fopen;
+use function fwrite;
+use function strtr;
+
 /**
  * Log processor for CLI.
  *
@@ -26,11 +31,11 @@ class Cli extends Processor
     public function __construct(array $settings)
     {
         parent::__construct($settings);
-        $this->handle = \defined('STDOUT') ? STDOUT : \fopen('php://stdout', 'w');
+        $this->handle = defined('STDOUT') ? STDOUT : fopen('php://stdout', 'w');
     }
 
     protected function process(array $message): void
     {
-        \fwrite($this->handle, \strtr($this->format, $message) . PHP_EOL);
+        fwrite($this->handle, strtr($this->format, $message) . PHP_EOL);
     }
 }

Processors/File.php

@@ -14,6 +14,14 @@
 
 use Exception;
 use Koded\Exceptions\KodedException;
+use function date;
+use function file_put_contents;
+use function is_dir;
+use function is_writable;
+use function mkdir;
+use function rtrim;
+use function strtr;
+use function umask;
 
 /**
  * Log processor for storing the log messages into text files on the disk.
@@ -40,30 +48,26 @@ class File extends Processor
     public function __construct(array $settings)
     {
         parent::__construct($settings);
-
-        \umask(\umask() | 0002);
+        umask(umask() | 0002);
+        $this->dir = rtrim((string)$settings['dir'], '/');
         $this->ext = (string)($settings['extension'] ?? '.log');
-        $this->dir = \rtrim((string)$settings['dir'], '/');
-
-        if (false === \is_dir($this->dir)) {
+        if (false === is_dir($this->dir)) {
             throw FileProcessorException::directoryDoesNotExist($this->dir);
         }
-
-        if (false === \is_writable($this->dir)) {
+        if (false === is_writable($this->dir)) {
             throw FileProcessorException::directoryIsNotWritable($this->dir);
         }
-
         $this->dir .= '/';
     }
 
     protected function process(array $message): void
     {
         try {
             // The filename should be calculated at the moment of writing
-            $dir = $this->dir . \date('Y/m');
-            \is_dir($dir) || \mkdir($dir, 0775, true);
+            $dir = $this->dir . date('Y/m');
+            is_dir($dir) || mkdir($dir, 0775, true);
 
-            \file_put_contents($dir . '/' . \date('d') . $this->ext, \strtr($this->format, $message) . PHP_EOL,
+            file_put_contents($dir . '/' . date('d') . $this->ext, strtr($this->format, $message) . PHP_EOL,
                 FILE_APPEND);
 
             // @codeCoverageIgnoreStart

Processors/Memory.php

@@ -12,6 +12,8 @@
 
 namespace Koded\Logging\Processors;
 
+use function strtr;
+
 /**
  * In-memory logger.
  *
@@ -20,6 +22,6 @@ class Memory extends Processor
 {
     protected function process(array $message): void
     {
-        $this->formatted .= PHP_EOL . \strtr($this->format, $message);
+        $this->formatted .= PHP_EOL . strtr($this->format, $message);
     }
 }

Processors/Processor.php

@@ -47,7 +47,8 @@ public function __construct(array $settings)
      * Receive update from the Log instance.
      * This is where the messages are filtered and processed.
      *
-     * @param array $message The message to be processed
+     * @param array{level: int, levelname: string, message: string, timestamp: string} $message
+     *     The message to be processed
      *
      * @return void
      */

Processors/Syslog.php

@@ -13,6 +13,9 @@
 namespace Koded\Logging\Processors;
 
 use Koded\Logging\Logger;
+use function closelog;
+use function openlog;
+use function strtr;
 
 /**
  * System log.
@@ -37,10 +40,10 @@ protected function process(array $message): void
         ];
 
         try {
-            \openlog(null, LOG_CONS, LOG_USER);
-            \syslog($levels[$message['level']] ?? LOG_DEBUG, \strtr($this->format, $message));
+            openlog('', LOG_CONS, LOG_USER);
+            \syslog($levels[$message['level']] ?? LOG_DEBUG, strtr($this->format, $message));
         } finally {
-            \closelog();
+            closelog();
         }
     }
 }

VERSION

@@ -1 +1 @@
-3.1.0
+3.2.0

composer.json

@@ -20,9 +20,8 @@
   "prefer-stable": true,
   "minimum-stability": "dev",
   "require": {
-    "php": "^8",
-    "psr/log": "^1",
-    "koded/stdlib": "^5"
+    "psr/log": "^3",
+    "koded/stdlib": "^6.1.0"
   },
   "autoload": {
     "psr-4": {