Add missing putMany(), getMany(), and purgeExpired() methods to Cache component

Author: ImperaZim

src/imperazim/components/cache/Cache.php

@@ -116,6 +116,42 @@ public static function clear(): void {
     self::$cache = [];
   }
 
+  /**
+  * Stores multiple values in the cache with optional TTL.
+  * @param array $items Associative array of key => value pairs.
+  * @param int|null $ttl Time to live in seconds. Null for no expiration.
+  */
+  public static function putMany(array $items, ?int $ttl = null): void {
+    foreach ($items as $key => $value) {
+      self::put($key, $value, $ttl);
+    }
+  }
+
+  /**
+  * Retrieves multiple cached values by keys.
+  * @param array $keys Array of cache keys.
+  * @return array Associative array of key => value pairs (null for missing/expired).
+  */
+  public static function getMany(array $keys): array {
+    $results = [];
+    foreach ($keys as $key) {
+      $results[$key] = self::get($key);
+    }
+    return $results;
+  }
+
+  /**
+  * Removes expired cache entries.
+  */
+  public static function purgeExpired(): void {
+    $currentTime = time();
+    foreach (self::$cache as $key => $item) {
+      if ($item['expires_at'] !== null && $item['expires_at'] < $currentTime) {
+        unset(self::$cache[$key]);
+      }
+    }
+  }
+
   /**
   * Returns cache statistics such as total entries, hits, misses, and expired items.
   * @return array Cache statistics.