feat: add cache touch support

This commit is contained in:
Torsten Dittmann committed 2026-05-08 16:35:04 +04:00
1 parent d36f9050c3
commit d401e64ea1
13 files changed
+185 -1

No files matched your search

+7
View File
@@ -24,6 +24,13 @@ interface Adapter
*/
public function save(string $key, array|string $data, string $hash = ''): bool|string|array;
/**
* @param string $key
* @param string $hash optional
* @return bool
*/
public function touch(string $key, string $hash = ''): bool;
/**
* @param string $key
* @return string[]
+12
View File
@@ -97,6 +97,18 @@ class Filesystem implements Adapter
}
}
/**
* @param string $key
* @param string $hash optional
* @return bool
*/
public function touch(string $key, string $hash = ''): bool
{
$file = $this->getPath($key);
return file_exists($file) && touch($file);
}
/**
* @param string $key
* @return string[]
+19
View File
@@ -87,6 +87,25 @@ class Hazelcast implements Adapter
return ($this->execute(fn () => $this->memcached->set($key, json_encode($cache)))) ? $data : false;
}
/**
* @param string $key
* @param string $hash optional
* @return bool
*/
public function touch(string $key, string $hash = ''): bool
{
$data = $this->load($key, PHP_INT_MAX, $hash);
if ($data === false) {
return false;
}
if (! is_string($data) && ! is_array($data)) {
return false;
}
return $this->save($key, $data, $hash) !== false;
}
/**
* @param string $key
* @return string[]
+19
View File
@@ -89,6 +89,25 @@ class Memcached implements Adapter
return $this->execute(fn () => $this->memcached->set($key, $cache)) ? $data : false;
}
/**
* @param string $key
* @param string $hash optional
* @return bool
*/
public function touch(string $key, string $hash = ''): bool
{
$data = $this->load($key, PHP_INT_MAX, $hash);
if ($data === false) {
return false;
}
if (! is_string($data) && ! is_array($data)) {
return false;
}
return $this->save($key, $data, $hash) !== false;
}
/**
* @param string $key
* @return string[]
+19
View File
@@ -76,6 +76,25 @@ class Memory implements Adapter
return $data;
}
/**
* @param string $key
* @param string $hash optional
* @return bool
*/
public function touch(string $key, string $hash = ''): bool
{
$data = $this->load($key, PHP_INT_MAX, $hash);
if ($data === false) {
return false;
}
if (! is_string($data) && ! is_array($data)) {
return false;
}
return $this->save($key, $data, $hash) !== false;
}
/**
* @param string $key
* @return string[]
+10
View File
@@ -53,6 +53,16 @@ class None implements Adapter
return false;
}
/**
* @param string $key
* @param string $hash optional
* @return bool
*/
public function touch(string $key, string $hash = ''): bool
{
return false;
}
/**
* @param string $key
* @return string[]
+10
View File
@@ -59,6 +59,16 @@ class Pool implements Adapter
return $result;
}
public function touch(string $key, string $hash = ''): bool
{
/**
* @var bool $result
*/
$result = $this->delegate(__FUNCTION__, \func_get_args());
return $result;
}
public function list(string $key): array
{
/**
+19
View File
@@ -152,6 +152,25 @@ class Redis implements Adapter
}
}
/**
* @param string $key
* @param string $hash optional
* @return bool
*/
public function touch(string $key, string $hash = ''): bool
{
$data = $this->load($key, PHP_INT_MAX, $hash);
if ($data === false) {
return false;
}
if (! is_string($data) && ! is_array($data)) {
return false;
}
return $this->save($key, $data, $hash) !== false;
}
/**
* @param string $key
* @return string[]
+20 -1
View File
@@ -103,7 +103,7 @@ class RedisCluster implements Adapter
/** @var string|false */
$redis_string = $this->execute(fn () => $this->redis->hGet($key, $hash));
if ($redis_string === false) {
if ($redis_string === false || ! is_string($redis_string)) {
return false;
}
@@ -151,6 +151,25 @@ class RedisCluster implements Adapter
}
}
/**
* @param string $key
* @param string $hash optional
* @return bool
*/
public function touch(string $key, string $hash = ''): bool
{
$data = $this->load($key, PHP_INT_MAX, $hash);
if ($data === false) {
return false;
}
if (! is_string($data) && ! is_array($data)) {
return false;
}
return $this->save($key, $data, $hash) !== false;
}
/**
* @param string $key
* @return string[]
+10
View File
@@ -92,6 +92,16 @@ class Sharding implements Adapter
return $this->getAdapter($key)->save($key, $data, $hash);
}
/**
* @param string $key
* @param string $hash optional
* @return bool
*/
public function touch(string $key, string $hash = ''): bool
{
return $this->getAdapter($key)->touch($key, $hash);
}
/**
* @param string $key
* @return string[]
+23
View File
@@ -106,6 +106,29 @@ class Cache
}
}
/**
* Refresh a cache entry timestamp without replacing its data.
*
* @param string $key
* @param string $hash optional
* @return bool
*/
public function touch(string $key, string $hash = ''): bool
{
$key = $this->caseSensitive ? $key : strtolower($key);
$hash = $this->caseSensitive ? $hash : strtolower($hash);
$start = microtime(true);
$result = $this->adapter->touch($key, $hash);
$duration = microtime(true) - $start;
$this->operationDuration?->record($duration, [
'operation' => 'touch',
'adapter' => $this->adapter->getName($key),
]);
return $result;
}
/**
* Returns a list of keys.
*
+12
View File
@@ -57,6 +57,18 @@ abstract class Base extends TestCase
$this->assertEquals(false, $data);
}
public function testCacheTouch(): void
{
$result = self::$cache->save('touch-key', 'touch data', 'touch-key');
$this->assertEquals('touch data', $result);
$this->assertEquals(true, self::$cache->touch('touch-key', 'touch-key'));
$this->assertEquals('touch data', self::$cache->load('touch-key', 60, 'touch-key'));
$this->assertEquals(false, self::$cache->touch('missing-touch-key', 'missing-touch-key'));
self::$cache->purge('touch-key');
}
public function testCaseInsensitivity(): void
{
// Ensure case in-sensitivity first (configured in adapter's setUp)
+5
View File
@@ -60,6 +60,11 @@ class NoneTest extends Base
$this->assertEquals(true, $result);
}
public function testCacheTouch(): void
{
$this->assertEquals(false, self::$cache->touch($this->key));
}
public function testCaseInsensitivity(): void
{
// None adapter does not expect case sensitivity/insensitivy