refactor: add native return type for deleteMatching in CacheInterface

Author: yassinedoghri

system/Cache/CacheInterface.php

@@ -56,9 +56,9 @@ public function delete(string $key);
      *
      * @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

@@ -63,10 +63,8 @@ public function delete(string $key)
 
     /**
      * {@inheritDoc}
-     *
-     * @return int
      */
-    public function deleteMatching(string $pattern)
+    public function deleteMatching(string $pattern): int
     {
         return 0;
     }

system/Cache/Handlers/FileHandler.php

@@ -131,10 +131,8 @@ public function delete(string $key)
 
     /**
      * {@inheritDoc}
-     *
-     * @return int
      */
-    public function deleteMatching(string $pattern)
+    public function deleteMatching(string $pattern): int
     {
         $deleted = 0;
 

system/Cache/Handlers/MemcachedHandler.php

@@ -182,10 +182,8 @@ public function delete(string $key)
 
     /**
      * {@inheritDoc}
-     *
-     * @return never
      */
-    public function deleteMatching(string $pattern)
+    public function deleteMatching(string $pattern): never
     {
         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

@@ -155,10 +155,8 @@ public function delete(string $key)
 
     /**
      * {@inheritDoc}
-     *
-     * @return int
      */
-    public function deleteMatching(string $pattern)
+    public function deleteMatching(string $pattern): int
     {
         $matchedKeys = [];
 

system/Cache/Handlers/RedisHandler.php

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

system/Cache/Handlers/WincacheHandler.php

@@ -75,10 +75,8 @@ public function delete(string $key)
 
     /**
      * {@inheritDoc}
-     *
-     * @return never
      */
-    public function deleteMatching(string $pattern)
+    public function deleteMatching(string $pattern): never
     {
         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

@@ -129,10 +129,8 @@ public function delete(string $key)
 
     /**
      * Deletes items from the cache store matching a given pattern.
-     *
-     * @return int
      */
-    public function deleteMatching(string $pattern)
+    public function deleteMatching(string $pattern): int
     {
         $count = 0;