refactor: add native return type for deleteMatching in CacheInterface

Author: yassinedoghri

system/Cache/CacheInterface.php

@@ -55,10 +55,10 @@ public function delete(string $key);
      * Deletes items from the cache store matching a given pattern.
      *
      * @param string $pattern Cache items glob-style pattern
-     *
-     * @return int
+     * 
+     * @return int Number of deleted items
      */
-    public function deleteMatching(string $pattern);
+    public function deleteMatching(string $pattern): int;
 
     /**
      * Performs atomic incrementation of a raw stored value.

system/Cache/Handlers/DummyHandler.php

@@ -66,7 +66,7 @@ public function delete(string $key)
      *
      * @return int
      */
-    public function deleteMatching(string $pattern)
+    public function deleteMatching(string $pattern): int
     {
         return 0;
     }

system/Cache/Handlers/FileHandler.php

@@ -134,7 +134,7 @@ public function delete(string $key)
      *
      * @return int
      */
-    public function deleteMatching(string $pattern)
+    public function deleteMatching(string $pattern): int
     {
         $deleted = 0;
 

system/Cache/Handlers/MemcachedHandler.php

@@ -185,7 +185,7 @@ public function delete(string $key)
      *
      * @return never
      */
-    public function deleteMatching(string $pattern)
+    public function deleteMatching(string $pattern): int
     {
         throw new BadMethodCallException('The deleteMatching method is not implemented for Memcached. You must select File, Redis or Predis handlers to use it.');
     }

system/Cache/Handlers/PredisHandler.php

@@ -158,7 +158,7 @@ public function delete(string $key)
      *
      * @return int
      */
-    public function deleteMatching(string $pattern)
+    public function deleteMatching(string $pattern): int
     {
         $matchedKeys = [];
 

system/Cache/Handlers/RedisHandler.php

@@ -182,7 +182,7 @@ public function delete(string $key)
      *
      * @return int
      */
-    public function deleteMatching(string $pattern)
+    public function deleteMatching(string $pattern): int
     {
         /** @var list<string> $matchedKeys */
         $matchedKeys = [];

system/Cache/Handlers/WincacheHandler.php

@@ -78,7 +78,7 @@ public function delete(string $key)
      *
      * @return never
      */
-    public function deleteMatching(string $pattern)
+    public function deleteMatching(string $pattern): int
     {
         throw new BadMethodCallException('The deleteMatching method is not implemented for Wincache. You must select File, Redis or Predis handlers to use it.');
     }

system/Test/Mock/MockCache.php

@@ -132,7 +132,7 @@ public function delete(string $key)
      *
      * @return int
      */
-    public function deleteMatching(string $pattern)
+    public function deleteMatching(string $pattern): int
     {
         $count = 0;