Cache handler update.

Changelog excerpt:
- Added support for specifying a Redis database number to the supplementary
  cache options.

Author: Maikuolan

Changelog.md

@@ -142,4 +142,4 @@ __*Why "v3.0.0" instead of "v1.0.0?"*__ Prior to phpMussel v3, the "phpMussel Co
 
 ### v3.5.0
 
-[2023.12.01; Maikuolan]: Improve escaping.
+[2023.12.01; Maikuolan]: Improved escaping. Added support for specifying a Redis database number to the supplementary cache options.

assets/config.yml

@@ -7,7 +7,7 @@
 # License: GNU/GPLv2
 # @see LICENSE.txt
 #
-# This file: Configuration defaults file (last modified: 2023.10.12).
+# This file: Configuration defaults file (last modified: 2023.12.01).
 ##/
 
 core:
@@ -482,6 +482,11 @@ supplementary_cache_options:
   type: "float"
   step: "any"
   default: 2.5
+ redis_database_number:
+  type: "int"
+  default: 0
+  min: 0
+  max: 9999
  pdo_dsn:
   type: "string"
   default: "mysql:dbname=phpmussel;host=localhost;port=3306"

composer.json

@@ -12,7 +12,7 @@
     },
     "require": {
         "php": ">=7.2.0",
-        "maikuolan/common": "^2.11",
+        "maikuolan/common": "^2.12",
         "ext-pcre": "*"
     },
     "suggest": {

src/Loader.php

@@ -1274,12 +1274,13 @@ private function initialiseCache(): void
         $this->Cache->RedisHost = $this->Configuration['supplementary_cache_options']['redis_host'];
         $this->Cache->RedisPort = $this->Configuration['supplementary_cache_options']['redis_port'];
         $this->Cache->RedisTimeout = $this->Configuration['supplementary_cache_options']['redis_timeout'];
+        $this->Cache->RedisDatabaseNumber = $this->Configuration['supplementary_cache_options']['redis_database_number'];
         $this->Cache->PDOdsn = $this->Configuration['supplementary_cache_options']['pdo_dsn'];
         $this->Cache->PDOusername = $this->Configuration['supplementary_cache_options']['pdo_username'];
         $this->Cache->PDOpassword = $this->Configuration['supplementary_cache_options']['pdo_password'];
 
         /** Assign cache path. */
-        if ($this->CachePath) {
+        if ($this->CachePath !== '') {
             $this->Cache->FFDefault = $this->CachePath . DIRECTORY_SEPARATOR . 'cache.dat';
         }