Added new flexible() method

Author: andrey-helldar

Diff for: src/Services/Cache.php

@@ -28,6 +28,8 @@ class Cache
 
     protected int $ttl = 86400;
 
+    protected ?int $ttlInterval = null;
+
     protected array $tags = [];
 
     protected mixed $key;
@@ -88,6 +90,39 @@ public function key(...$values): Cache
         return $this;
     }
 
+    /**
+     * It sets the time for stale of the key for its background update.
+     *
+     * > Note:
+     * >
+     * > This method works only in tandem with the `remember()` method.
+     *
+     * A positive value indicates the lifetime of the key before it stale.
+     * For example,
+     * ```
+     * Cache::flexible('some', [60, 300], fn () => ...)
+     * ```
+     *
+     * A negative value indicates the time the key will expire.
+     * For example,
+     * ```
+     * Cache::flexible('some', [300 - 60, 300], fn () => ...)
+     * ```
+     *
+     * @see https://laravel.com/docs/12.x/cache#swr
+     *
+     * @param  int  $interval
+     * @param  bool  $isMinutes
+     *
+     * @return $this
+     */
+    public function flexible(int $interval, bool $isMinutes = true): Cache
+    {
+        $this->ttlInterval = $isMinutes ? $interval * 60 : $interval;
+
+        return $this;
+    }
+
     public function get(): mixed
     {
         return $this->manager()->get($this->getKey());
@@ -100,7 +135,9 @@ public function put(mixed $value): mixed
 
     public function remember(mixed $value): mixed
     {
-        return $this->manager()->remember($this->getKey(), $value, $this->ttl);
+        return $this->ttlInterval === null
+            ? $this->manager()->remember($this->getKey(), $value, $this->ttl)
+            : $this->manager()->flexible($this->getKey(), $value, $this->ttl, $this->ttlInterval);
     }
 
     public function rememberForever(mixed $value): mixed

Diff for: src/Services/Storages/Disabled.php

@@ -16,6 +16,11 @@ public function put(string $key, $value, int $seconds): mixed
         return $this->get($key, $value);
     }
 
+    public function flexible(string $key, $value, int $seconds, int $interval): mixed
+    {
+        return $this->get($key, $value);
+    }
+
     public function remember(string $key, $value, int $seconds): mixed
     {
         return $this->get($key, $value);

Diff for: src/Services/Storages/MainStore.php

@@ -26,6 +26,13 @@ public function put(string $key, $value, int $seconds): mixed
         return $value;
     }
 
+    public function flexible(string $key, $value, int $seconds, int $interval): mixed
+    {
+        $value = $this->makeCallable($value);
+
+        return Cache::flexible($key, [$seconds, $interval], $value);
+    }
+
     public function remember(string $key, $value, int $seconds): mixed
     {
         $value = $this->makeCallable($value);

Diff for: src/Services/Storages/Store.php

@@ -12,6 +12,22 @@ abstract class Store
     use Call;
     use Makeable;
 
+    abstract public function flexible(string $key, $value, int $seconds, int $interval): mixed;
+
+    abstract public function flush(): void;
+
+    abstract public function forget(string $key): void;
+
+    abstract public function get(string $key, $default = null): mixed;
+
+    abstract public function has(string $key): bool;
+
+    abstract public function put(string $key, $value, int $seconds): mixed;
+
+    abstract public function remember(string $key, $value, int $seconds): mixed;
+
+    abstract public function rememberForever(string $key, $value): mixed;
+
     public function doesntHave(string $key): bool
     {
         return ! $this->has($key);

Diff for: src/Services/Storages/TaggedStore.php

@@ -36,6 +36,13 @@ public function put(string $key, $value, int $seconds): mixed
         return $value;
     }
 
+    public function flexible(string $key, $value, int $seconds, int $interval): mixed
+    {
+        $value = $this->makeCallable($value);
+
+        return Cache::flexible($key, [$seconds, $interval], $value);
+    }
+
     public function remember(string $key, $value, int $seconds): mixed
     {
         $value = $this->makeCallable($value);

Diff for: src/Support/CacheManager.php

@@ -43,6 +43,15 @@ public function put(string $key, $value, int $seconds): mixed
         return $this->instance()->put($key, $value, $seconds);
     }
 
+    public function flexible(string $key, $value, int $seconds, int $interval): mixed
+    {
+        if ($interval < 0) {
+            $interval = $seconds - $interval;
+        }
+
+        return $this->instance()->flexible($key, $value, $seconds, $interval);
+    }
+
     public function remember(string $key, $value, int $seconds): mixed
     {
         return $this->instance()->remember($key, $value, $seconds);