LogDirectoryHandler: add filename prefix possibility

composer.json

@@ -16,10 +16,10 @@
     "minimum-stability": "stable",
     "require":           {
         "php":                        "^7.4 || ^8.0",
-        "ext-mbstring": "*",
+        "ext-mbstring":               "*",
-        "jrosset/exceptionhelper":    "^1.0",
+        "jrosset/exceptionhelper":    "^1.1",
-        "jrosset/lasterrorexception": "^1.0",
+        "jrosset/lasterrorexception": "^1.1",
-        "monolog/monolog":            "^2.9"
+        "monolog/monolog":            "^2.10"
     },
     "autoload":          {
         "psr-4":                 {

src/ExtendedMonolog/LogDirectoryHandler.php

@@ -20,28 +20,30 @@ class LogDirectoryHandler extends StreamHandler {
     /**
      * Initialization
      *
-     * @param string     $dirPath             The log directory path
+     * @param string      $dirPath             The log directory path
-     * @param int|string $level               The minimum logging level at which this handler will be triggered
+     * @param int|string  $level               The minimum logging level at which this handler will be triggered
-     * @param int        $historyNumberOfDays The maximum number of history files to keep (in number of days)
+     * @param int         $historyNumberOfDays The maximum number of history files to keep (in number of days)
-     * @param bool       $bubble              Whether the messages that are handled can bubble up the stack or not
+     * @param bool        $bubble              Whether the messages that are handled can bubble up the stack or not
-     * @param int|null   $filePermission      Optional file permissions (default (0644) are only for owner read/write)
+     * @param int|null    $filePermission      Optional file permissions (default (0644) are only for owner read/write)
-     * @param bool       $useLocking          Try to lock log file before doing any writes
+     * @param bool        $useLocking          Try to lock log file before doing any writes
+     * @param string|null $filenamePrefix      The filename prefix
      *
      * @throws Throwable If an error occurs
      */
     public function __construct (
-        string $dirPath,
+        string  $dirPath,
-               $level = Logger::DEBUG,
+                $level = Logger::DEBUG,
-        int    $historyNumberOfDays = 30,
+        int     $historyNumberOfDays = 30,
-        bool   $bubble = true,
+        bool    $bubble = true,
-        ?int   $filePermission = null,
+        ?int    $filePermission = null,
-        bool   $useLocking = false
+        bool    $useLocking = false,
+        ?string $filenamePrefix = null
     ) {
         $dirPath = $dirPath . DIRECTORY_SEPARATOR;
-        $this->normalizeDirectory($dirPath, $historyNumberOfDays);
+        $this->normalizeDirectory($dirPath, $filenamePrefix, $historyNumberOfDays);
 
         parent::__construct(
-            $dirPath . date('Y-m-d') . '.log',
+            $dirPath . ($filenamePrefix ?? '') . date('Y-m-d') . '.log',
             $level,
             $bubble,
             $filePermission,
@@ -53,14 +55,15 @@ class LogDirectoryHandler extends StreamHandler {
     /**
      * Normalize a directory: create if missing and clear old files
      *
-     * @param string $dirPath             The directory path
+     * @param string      $dirPath             The directory path
-     * @param int    $historyNumberOfDays The maximum number of history files to keep (in number of days)
+     * @param string|null $filenamePrefix      The filename prefix
+     * @param int         $historyNumberOfDays The maximum number of history files to keep (in number of days)
      *
      * @return void
      *
      * @throws Throwable If an error occurs
      */
-    private function normalizeDirectory (string $dirPath, int $historyNumberOfDays = 30): void {
+    protected final function normalizeDirectory (string $dirPath, ?string $filenamePrefix, int $historyNumberOfDays = 30): void {
         if (!file_exists($dirPath) || !is_dir($dirPath)) {
             error_clear_last();
             if (!mkdir($dirPath, 0755, true)) {
@@ -78,7 +81,13 @@ class LogDirectoryHandler extends StreamHandler {
             if (!$fileInfo->isFile()) {
                 continue;
             }
-            if (preg_match('/^(?<date>\\d{4}-\\d{2}-\\d{2})(?:[_-].*)?\.log$/i', $fileInfo->getFilename(), $match) !== 1) {
+            if (
+                preg_match(
+                    '/^' . preg_quote($filenamePrefix ?? '', '/') . '(?<date>\\d{4}-\\d{2}-\\d{2})(?:[_-].*)?\.log$/i',
+                    $fileInfo->getFilename(),
+                    $match
+                ) !== 1
+            ) {
                 continue;
             }