Add Ability to Disable StaticCache (#66)

Co-authored-by: EncoreBot <[email protected]>

Author: onairmarc

.git-blame-ignore-revs

@@ -34,3 +34,4 @@ adee35fd7b993cb4a7cf85df7ee997951af3e907
 f3cda4980fdc4c227e00250d7dfcfe4639dc60dc
 d676999a6145177a6f61007806f5b95f1df868bd
 53d9e752575f07527143ccee692673b8c6793141
+8334d091011e09e060e476cb29a17239627e9a39

src/Objects/Support/StaticCache.php

@@ -3,13 +3,20 @@
 namespace EncoreDigitalGroup\StdLib\Objects\Support;
 
 use BackedEnum;
+use EncoreDigitalGroup\StdLib\Objects\Support\Traits\StaticCacheEnabled;
 
 class StaticCache
 {
+    use StaticCacheEnabled;
+
     protected static array $cache = [];
 
     public static function add(BackedEnum|string $key, mixed $value, BackedEnum|string $partition = "default"): void
     {
+        if (self::disabled()) {
+            return;
+        }
+
         $key = self::enum($key);
         $partition = self::enum($partition);
 

src/Objects/Support/Traits/StaticCacheEnabled.php

@@ -0,0 +1,39 @@
+<?php
+
+namespace EncoreDigitalGroup\StdLib\Objects\Support\Traits;
+
+/** @internal */
+trait StaticCacheEnabled
+{
+    protected static array $enabled = [];
+
+    protected const string ENABLED = "enabled";
+
+    public static function enable(): void
+    {
+        static::$enabled[static::class][self::ENABLED] = true;
+    }
+
+    public static function disable(bool $flush = true): void
+    {
+        if ($flush) {
+            static::flush();
+        }
+
+        static::$enabled[static::class][self::ENABLED] = false;
+    }
+
+    protected static function enabled(): bool
+    {
+        if (!isset(static::$enabled[static::class][self::ENABLED])) {
+            static::$enabled[static::class][self::ENABLED] = true;
+        }
+
+        return static::$enabled[static::class][self::ENABLED];
+    }
+
+    protected static function disabled(): bool
+    {
+        return !static::enabled();
+    }
+}