Improve arguments validation + Minor refactoring + Psalm 1

.github/workflows/static.yml

@@ -10,6 +10,8 @@ on:
       - 'phpunit.xml.dist'
 
   push:
+    branches:
+      - master
     paths-ignore:
       - 'docs/**'
       - 'README.md'
@@ -22,19 +24,15 @@ on:
 name: static analysis
 
 jobs:
-  mutation:
+  psalm:
     name: PHP ${{ matrix.php }}-${{ matrix.os }}
 
     runs-on: ${{ matrix.os }}
 
     strategy:
       matrix:
-        os:
-          - ubuntu-latest
-
-        php:
-          - 8.0
-          - 8.1
+        os: ['ubuntu-latest']
+        php: ['8.0', '8.1', '8.2', '8.3']
 
     steps:
       - name: Checkout
@@ -64,5 +62,10 @@ jobs:
       - name: Install dependencies with composer
         run: composer update --prefer-dist --no-interaction --no-progress --optimize-autoloader --ansi
 
-      - name: Static analysis
-        run: vendor/bin/psalm --shepherd --stats --output-format=checkstyle | cs2pr --graceful-warnings --colorize
+      - name: Static analysis PHP 8.0
+        if: matrix.php == '8.0'
+        run: vendor/bin/psalm --config=psalm80.xml --shepherd --stats --output-format=github --php-version=${{ matrix.php }}
+
+      - name: Static analysis PHP 8.1+
+        if: matrix.php != '8.0'
+        run: vendor/bin/psalm --shepherd --stats --output-format=github --php-version=${{ matrix.php }}

CHANGELOG.md

@@ -2,7 +2,8 @@
 
 ## 2.0.1 under development
 
-- no changes in this release.
+- Enh #62: Remove unneeded casting to array in private method `Memcached::iterableToArray()` (@vjik)
+- Enh #62: Improve list of memcached server validation (@vjik) 
 
 ## 2.0.0 February 15, 2023
 

composer.json

@@ -30,7 +30,7 @@
         "rector/rector": "^1.0.1",
         "roave/infection-static-analysis-plugin": "^1.16",
         "spatie/phpunit-watcher": "^1.23",
-        "vimeo/psalm": "^4.30|^5.6",
+        "vimeo/psalm": "^4.30|^5.22",
         "yiisoft/di": "^1.2"
     },
     "autoload": {

psalm.xml

@@ -1,21 +1,20 @@
 <?xml version="1.0"?>
 <psalm
-    errorLevel="2"
+    errorLevel="1"
     findUnusedBaselineEntry="true"
     findUnusedCode="false"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xmlns="https://getpsalm.org/schema/config"
     xsi:schemaLocation="https://getpsalm.org/schema/config vendor/vimeo/psalm/config.xsd"
 >
     <projectFiles>
-        <directory name="src"/>
+        <directory name="src" />
+        <ignoreFiles>
+            <directory name="vendor" />
+        </ignoreFiles>
     </projectFiles>
-
     <issueHandlers>
-        <UndefinedClass>
-            <errorLevel type="suppress">
-                <referencedClass name="Memcached" />
-            </errorLevel>
-        </UndefinedClass>
+        <MixedAssignment errorLevel="suppress" />
+        <RiskyTruthyFalsyComparison errorLevel="suppress" />
     </issueHandlers>
 </psalm>

psalm80.xml

@@ -0,0 +1,19 @@
+<?xml version="1.0"?>
+<psalm
+    errorLevel="1"
+    findUnusedBaselineEntry="true"
+    findUnusedCode="false"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xmlns="https://getpsalm.org/schema/config"
+    xsi:schemaLocation="https://getpsalm.org/schema/config vendor/vimeo/psalm/config.xsd"
+>
+    <projectFiles>
+        <directory name="src" />
+        <ignoreFiles>
+            <directory name="vendor" />
+        </ignoreFiles>
+    </projectFiles>
+    <issueHandlers>
+        <MixedAssignment errorLevel="suppress" />
+    </issueHandlers>
+</psalm>

src/Memcached.php

@@ -29,6 +29,8 @@
  *
  * Note, there is no security measure to protected data in memcached.
  * All data in memcached can be accessed by any process running in the system.
+ *
+ * @psalm-type NewServerType=array{0:string,1:int,2?:int}
  */
 final class Memcached implements CacheInterface
 {
@@ -113,7 +115,7 @@
     public function setMultiple(iterable $values, null|int|DateInterval $ttl = null): bool
     {
         $values = $this->iterableToArray($values);
         $this->validateKeysOfValues($values);
         return $this->cache->setMulti($values, $this->normalizeTtl($ttl));
     }
 
@@ -123,12 +125,12 @@
         $this->validateKeys($keys);
 
         foreach ($this->cache->deleteMulti($keys) as $result) {
             if ($result === false) {
                 return false;
             }
         }
 
         return true;
     }
 
     public function has(string $key): bool
@@ -170,11 +172,14 @@
 
     /**
      * Converts iterable to array.
+     *
+     * @psalm-template T
+     * @psalm-param iterable<T> $iterable
+     * @psalm-return array<array-key,T>
      */
     private function iterableToArray(iterable $iterable): array
     {
-        /** @psalm-suppress RedundantCast */
-        return $iterable instanceof Traversable ? iterator_to_array($iterable) : (array) $iterable;
+        return $iterable instanceof Traversable ? iterator_to_array($iterable) : $iterable;
     }
 
     /**
@@ -196,14 +201,20 @@
 
     /**
      * Returns the list of the servers that are not in the pool.
+     *
+     * @psalm-param list<NewServerType> $servers
      */
     private function getNewServers(array $servers): array
     {
         $existingServers = [];
         $newServers = [];
 
+        /**
+         * @psalm-var array{host:string,port:int} $existingServer
+         * @see https://www.php.net/manual/en/memcached.getserverlist.php
+         */
         foreach ($this->cache->getServerList() as $existingServer) {
             $existingServers["{$existingServer['host']}:{$existingServer['port']}"] = true;
         }
 
         foreach ($servers as $server) {
@@ -223,18 +234,29 @@
      * @throws InvalidArgumentException If the servers format is incorrect.
      *
      * @return array The normalized servers.
+     *
+     * @psalm-return list<NewServerType> $servers
      */
     private function normalizeServers(array $servers): array
     {
         $normalized = [];
 
         foreach ($servers as $server) {
-            if (!is_array($server) || !isset($server['host'], $server['port'])) {
+            if (
+                !is_array($server)
+                || !isset($server['host'], $server['port'])
+                || !is_string($server['host'])
+                || !is_int($server['port'])
+                || (isset($server['weight']) && !is_int($server['weight']))
+            ) {
                 throw new InvalidArgumentException(
                     'Each entry in servers parameter is supposed to be an array'
-                    . ' containing hostname, port, and, optionally, weight of the server.',
+                    . ' containing hostname (string), port (int), and, optionally, weight (int) of the server.',
                 );
             }
+            /**
+             * @psalm-var array{host:string,port:int,weight?:int} $server Need for PHP 8.0
+             */
 
             $normalized[] = [$server['host'], $server['port'], $server['weight'] ?? self::DEFAULT_SERVER_WEIGHT];
         }
@@ -249,6 +271,9 @@
         }
     }
 
+    /**
+     * @param string[] $keys
+     */
     private function validateKeys(array $keys): void
     {
         foreach ($keys as $key) {
@@ -259,6 +284,6 @@
     private function validateKeysOfValues(array $values): void
     {
         $keys = array_map('\strval', array_keys($values));
         $this->validateKeys($keys);
     }
 }