feature: allow integer keys in iterables as per PSR integration tests

In the (non-official) PSR integration tests are checks for iterables with a non-empty-string cache key `0`. Internal PHP type juggling converts integerish strings to `int` which leads to a type conflict when passing these values to our internal assertion.
Therefore, this patch provides compatibility for integer keys in methods consuming iterable keys either in key-value or key-only combination.

Signed-off-by: Maximilian Bösing <[email protected]>

Author: boesing

composer.json

@@ -49,8 +49,8 @@
         "laminas/laminas-config-aggregator": "^1.13",
         "laminas/laminas-serializer": "^3.0",
         "phpunit/phpunit": "^9.5.27",
-        "psalm/plugin-phpunit": "^0.18.4",
-        "vimeo/psalm": "^5.4"
+        "psalm/plugin-phpunit": "^0.19.0",
+        "vimeo/psalm": "^5.24"
     },
     "conflict": {
         "laminas/laminas-serializer": "<3.0",

composer.lock

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<files psalm-version="5.22.2@d768d914152dbbf3486c36398802f74e80cfde48">
+<files psalm-version="5.24.0@462c80e31c34e58cc4f750c656be3927e80e550e">
   <file src="src/Exception/BadMethodCallException.php">
     <UnusedClass>
       <code><![CDATA[BadMethodCallException]]></code>
@@ -119,11 +119,6 @@
       <code><![CDATA[setUmask]]></code>
     </PossiblyUnusedMethod>
   </file>
-  <file src="src/Psr/SimpleCache/SimpleCacheDecorator.php">
-    <InvalidArgument>
-      <code><![CDATA[$values]]></code>
-    </InvalidArgument>
-  </file>
   <file src="src/Service/StorageAdapterFactory.php">
     <InvalidArgument>
       <code><![CDATA[$pluginConfiguration]]></code>
@@ -460,10 +455,6 @@
       <code><![CDATA[testSetShouldRaisePsrInvalidArgumentExceptionForInvalidKeys]]></code>
       <code><![CDATA[testSetShouldRemoveItemFromCacheIfTtlIsBelow1]]></code>
     </MissingReturnType>
-    <MixedInferredReturnType>
-      <code><![CDATA[array]]></code>
-      <code><![CDATA[array]]></code>
-    </MixedInferredReturnType>
   </file>
   <file src="test/Service/StorageAdapterFactoryFactoryTest.php">
     <DeprecatedMethod>
@@ -499,43 +490,13 @@
     <MixedMethodCall>
       <code><![CDATA[getResult]]></code>
     </MixedMethodCall>
-    <PossiblyNullReference>
-      <code><![CDATA[getNamespace]]></code>
-      <code><![CDATA[setKeyPattern]]></code>
-      <code><![CDATA[setKeyPattern]]></code>
-      <code><![CDATA[setKeyPattern]]></code>
-      <code><![CDATA[setNamespace]]></code>
-      <code><![CDATA[setNamespace]]></code>
-      <code><![CDATA[setReadable]]></code>
-      <code><![CDATA[setTtl]]></code>
-      <code><![CDATA[setTtl]]></code>
-      <code><![CDATA[setWritable]]></code>
-    </PossiblyNullReference>
     <PossiblyUndefinedVariable>
       <code><![CDATA[$success]]></code>
     </PossiblyUndefinedVariable>
     <PossiblyUnusedMethod>
       <code><![CDATA[simpleEventHandlingMethodDefinitions]]></code>
     </PossiblyUnusedMethod>
   </file>
-  <file src="test/Storage/Adapter/AdapterOptionsTest.php">
-    <PossiblyNullReference>
-      <code><![CDATA[getKeyPattern]]></code>
-      <code><![CDATA[getTtl]]></code>
-      <code><![CDATA[setAdapter]]></code>
-      <code><![CDATA[setFromArray]]></code>
-      <code><![CDATA[setKeyPattern]]></code>
-      <code><![CDATA[setKeyPattern]]></code>
-      <code><![CDATA[setNamespace]]></code>
-      <code><![CDATA[setReadable]]></code>
-      <code><![CDATA[setTtl]]></code>
-      <code><![CDATA[setTtl]]></code>
-      <code><![CDATA[setWritable]]></code>
-    </PossiblyNullReference>
-    <PossiblyUnusedProperty>
-      <code><![CDATA[$storage]]></code>
-    </PossiblyUnusedProperty>
-  </file>
   <file src="test/Storage/Adapter/TestAsset/AdapterWithStorageAndEventsCapableInterface.php">
     <MissingReturnType>
       <code><![CDATA[addPlugin]]></code>

psalm-baseline.xml

@@ -129,7 +129,7 @@ public function getItems(array $keys = []): array
             }
 
             foreach ($cacheItems as $key => $value) {
-                $items[$key] = new CacheItem($key, $value, true, $this->clock);
+                $items[$key] = new CacheItem((string) $key, $value, true, $this->clock);
             }
 
             // Return empty items for any keys that where not found

src/Psr/CacheItemPool/CacheItemPoolDecorator.php

@@ -247,7 +247,7 @@ public function setMultiple(iterable $values, int|DateInterval|null $ttl = null)
         }
 
         foreach ($result as $index => $key) {
-            if (! $this->storage->hasItem($key)) {
+            if (! $this->storage->hasItem((string) $key)) {
                 unset($result[$index]);
             }
         }
@@ -276,7 +276,7 @@ public function deleteMultiple(iterable $keys): bool
         }
 
         foreach ($result as $index => $key) {
-            if (! $this->storage->hasItem($key)) {
+            if (! $this->storage->hasItem((string) $key)) {
                 unset($result[$index]);
             }
         }

src/Psr/SimpleCache/SimpleCacheDecorator.php

@@ -132,15 +132,15 @@ public function getMetadatas(array $keys): array
     /**
      * Internal method to get multiple metadata
      *
-     * @param array<string> $normalizedKeys
-     * @return array<string,TMetadata> Associative array of keys and metadata
+     * @param array<non-empty-string|int> $normalizedKeys
+     * @return array<non-empty-string|int,TMetadata> Associative array of keys and metadata
      * @throws ExceptionInterface
      */
     protected function internalGetMetadatas(array $normalizedKeys): array
     {
         $result = [];
         foreach ($normalizedKeys as $normalizedKey) {
-            $metadata = $this->internalGetMetadata($normalizedKey);
+            $metadata = $this->internalGetMetadata((string) $normalizedKey);
             if ($metadata === null) {
                 continue;
             }