Add validation rule "existMany"

Author: natanfelles

src/Languages/en/validation.php

@@ -9,6 +9,7 @@
  */
 return [
     'exist' => 'The {field} field does not exist.',
+    'existMany' => 'The {field} field has at least one value that does not exist.',
     'notUnique' => 'The {field} field is not registered.',
     'unique' => 'The {field} field has already been registered.',
 ];

src/Languages/es/validation.php

@@ -9,6 +9,7 @@
  */
 return [
     'exist' => 'El campo {field} no existe.',
+    'existMany' => 'El campo {field} tiene al menos un valor que no existe.',
     'notUnique' => 'El campo {field} no está registrado.',
     'unique' => 'El campo {field} ya se ha registrado. ',
 ];

src/Languages/pt-br/validation.php

@@ -9,6 +9,7 @@
  */
 return [
     'exist' => 'O campo {field} não existe.',
+    'existMany' => 'O campo {field} tem pelo menos um valor que não existe.',
     'notUnique' => 'O campo {field} não está registrado.',
     'unique' => 'O campo {field} já foi registrado.',
 ];

src/Validator.php

@@ -9,6 +9,7 @@
  */
 namespace Framework\MVC;
 
+use Framework\Helpers\ArraySimple;
 use LogicException;
 
 /**
@@ -136,4 +137,60 @@ public static function exist(
             ->run()
             ->fetch()->count > 0;
     }
+
+    /**
+     * Validates many values exists in database table.
+     *
+     * @since 3.10
+     *
+     * @param string $field
+     * @param array<string,mixed> $data
+     * @param string $tableColumn
+     * @param string $connection
+     *
+     * @return bool
+     */
+    public static function existMany(
+        string $field,
+        array $data,
+        string $tableColumn,
+        string $connection = 'default'
+    ) : bool {
+        $values = ArraySimple::value($field, $data);
+        if ($values === null) {
+            return true;
+        }
+        if ( ! \is_array($values)) {
+            return false;
+        }
+        foreach ($values as $value) {
+            if ( ! \is_scalar($value)) {
+                return false;
+            }
+        }
+        [$table, $column] = \array_pad(\explode('.', $tableColumn, 2), 2, '');
+        if ($column === '') {
+            $column = $field;
+        }
+        if ($connection === '') {
+            throw new LogicException(
+                'The connection parameter must be set to be able to connect the database'
+            );
+        }
+        $database = App::database($connection);
+        foreach ($values as $value) {
+            $count = $database // @phpstan-ignore-line
+                ->select()
+                ->expressions(['count' => static fn () => 'COUNT(*)'])
+                ->from($table)
+                ->whereEqual($column, $value)
+                ->limit(1)
+                ->run()
+                ->fetch()->count;
+            if ($count < 1) {
+                return false;
+            }
+        }
+        return true;
+    }
 }

tests/ValidatorTest.php

@@ -41,6 +41,14 @@ public function testExistNoDataValue() : void
         self::assertArrayHasKey('username', $validation->getErrors());
     }
 
+    public function testExistManyNoDataValue() : void
+    {
+        $validation = App::validation();
+        $validation->setRule('username', 'existMany:Users');
+        self::assertTrue($validation->validate([]));
+        self::assertEmpty($validation->getErrors());
+    }
+
     public function testUniqueNoDataValue() : void
     {
         $validation = App::validation();
@@ -73,6 +81,41 @@ public function testExist() : void
         self::assertArrayHasKey('username', $validation->getErrors());
     }
 
+    public function testExistMany() : void
+    {
+        $validation = App::validation();
+        $validation->setRule('usernames', 'existMany:Users.username');
+        $data = [
+            'usernames' => [
+                'foo',
+                'bar',
+            ],
+        ];
+        self::assertTrue($validation->validate($data));
+        self::assertEmpty($validation->getErrors());
+        $data = [
+            'usernames' => [
+                'foo',
+                'bazz',
+            ],
+        ];
+        self::assertFalse($validation->validate($data));
+        self::assertArrayHasKey('usernames', $validation->getErrors());
+        $data = [
+            'usernames' => 'invalid', // it should be an array
+        ];
+        self::assertFalse($validation->validate($data));
+        self::assertArrayHasKey('usernames', $validation->getErrors());
+        $data = [
+            'usernames' => [
+                ['invalid'], // it should be scalar
+                'bazz',
+            ],
+        ];
+        self::assertFalse($validation->validate($data));
+        self::assertArrayHasKey('usernames', $validation->getErrors());
+    }
+
     public function testUnique() : void
     {
         $validation = App::validation();
@@ -168,6 +211,20 @@ public function testExistWithoutConnection() : void
         $validation->validate($data);
     }
 
+    public function testExistManyWithoutConnection() : void
+    {
+        $validation = App::validation();
+        $validation->setRule('usernames', 'existMany:Users,');
+        $this->expectException(\LogicException::class);
+        $this->expectExceptionMessage(
+            'The connection parameter must be set to be able to connect the database'
+        );
+        $data = [
+            'usernames' => ['foo'],
+        ];
+        $validation->validate($data);
+    }
+
     public function testUniqueWithoutConnection() : void
     {
         $validation = App::validation();