Cache ttl prolongation

CHANGELOG.md

@@ -23,6 +23,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 * __BREAKING__: The `HttpLoader::retryCachedErrorResponses()` method now returns an instance of the new `Crwlr\Crawler\Loader\Http\Cache\RetryManager` class. This class provides the methods `only()` and `except()` to restrict retries to specific HTTP response status codes. Previously, this method returned the `HttpLoader` itself (`$this`), so if you're using it in a chain and calling other loader methods after it, you will need to refactor your code.
 * __BREAKING__: Removed the `Microseconds` class from this package. It has been moved to the `crwlr/utils` package, which you can use instead.
 
+### Added
+* New methods `FileCache::prolong()` and `FileCache::prolongAll()` to allow prolonging the time to live for cached responses.
+
 ## [1.10.0] - 2024-08-05
 ### Added
 * URL refiners: `UrlRefiner::withScheme()`, `UrlRefiner::withHost()`, `UrlRefiner::withPort()`, `UrlRefiner::withoutPort()`, `UrlRefiner::withPath()`, `UrlRefiner::withQuery()`, `UrlRefiner::withoutQuery()`, `UrlRefiner::withFragment()` and `UrlRefiner::withoutFragment()`.

src/Cache/CacheItem.php

@@ -47,6 +47,14 @@ public function isExpired(): bool
         return time() > $this->createdAt->add($ttl)->getTimestamp();
     }
 
+    /**
+     * Get a new instance with same data but a different time to live.
+     */
+    public function withTtl(DateInterval|int $ttl): CacheItem
+    {
+        return new CacheItem($this->value, $this->key, $ttl, $this->createdAt);
+    }
+
     /**
      * @return mixed[]
      */

src/Cache/FileCache.php

@@ -82,20 +82,25 @@ public function set(string $key, mixed $value, DateInterval|int|null $ttl = null
             $value = new CacheItem($value->value(), $key, $ttl ?? $value->ttl);
         }
 
-        $content = serialize($value);
-
-        if ($this->useCompression) {
-            $content = $this->encode($content);
-        }
-
-        return file_put_contents($this->basePath . '/' . $key, $content) !== false;
+        return $this->saveCacheItem($value);
     }
 
     public function delete(string $key): bool
     {
         return unlink($this->basePath . '/' . $key);
     }
 
+    public function prolong(string $key, DateInterval|int $ttl): bool
+    {
+        try {
+            $item = $this->getCacheItem($key);
+
+            return $this->saveCacheItem($item->withTtl($ttl));
+        } catch (Throwable) {
+            return false;
+        }
+    }
+
     /**
      * @throws InvalidArgumentException
      */
@@ -114,6 +119,21 @@ public function clear(): bool
         return true;
     }
 
+    public function prolongAll(DateInterval|int $ttl): bool
+    {
+        $allFiles = scandir($this->basePath);
+
+        if (is_array($allFiles)) {
+            foreach ($allFiles as $file) {
+                if ($file !== '.' && $file !== '..' && $file !== '.gitkeep' && !$this->prolong($file, $ttl)) {
+                    return false;
+                }
+            }
+        }
+
+        return true;
+    }
+
     /**
      * @return iterable<mixed>
      * @throws MissingZlibExtensionException|ReadingCacheFailedException|InvalidArgumentException
@@ -176,6 +196,20 @@ protected function getCacheItem(string $key): CacheItem
         return $unserialized;
     }
 
+    /**
+     * @throws MissingZlibExtensionException
+     */
+    protected function saveCacheItem(CacheItem $item): bool
+    {
+        $content = serialize($item);
+
+        if ($this->useCompression) {
+            $content = $this->encode($content);
+        }
+
+        return file_put_contents($this->basePath . '/' . $item->key(), $content) !== false;
+    }
+
     protected function unserialize(string $content): mixed
     {
         // Temporarily set a new error handler, so unserializing a compressed string does not result in a PHP warning.

src/Logger/CliLogger.php

@@ -50,6 +50,10 @@ public function debug(string|Stringable $message, array $context = []): void
         $this->log('debug', $message, $context);
     }
 
+    /**
+     * @param string $level
+     * @param mixed[] $context
+     */
     public function log($level, string|Stringable $message, array $context = []): void
     {
         if (!is_string($level)) {