feat(validation): add ability to validate an array of values (#1212)

Co-authored-by: Brent Roose <[email protected]>

Author: innocenzi

packages/validation/src/Validator.php

@@ -19,6 +19,9 @@
 
 final readonly class Validator
 {
+    /**
+     * Validates the values of public properties on the specified object using attribute rules.
+     */
     public function validateObject(object $object): void
     {
         $class = new ClassReflector($object);
@@ -41,6 +44,8 @@ public function validateObject(object $object): void
     }
 
     /**
+     * Validates the specified `$values` for the corresponding public properties on the specified `$class`, using built-in PHP types and attribute rules.
+     *
      * @param ClassReflector|class-string $class
      */
     public function validateValuesForClass(ClassReflector|string $class, ?array $values, string $prefix = ''): array
@@ -89,6 +94,9 @@ class: $property->getType()->asClass(),
         return $failingRules;
     }
 
+    /**
+     * Validates `$value` against the specified `$property`, using built-in PHP types and attribute rules.
+     */
     public function validateValueForProperty(PropertyReflector $property, mixed $value): array
     {
         $rules = $property->getAttributes(Rule::class);
@@ -113,6 +121,9 @@ public function validateValueForProperty(PropertyReflector $property, mixed $val
         return $this->validateValue($value, $rules);
     }
 
+    /**
+     * Validates the specified `$value` against the specified set `$rules`.
+     */
     public function validateValue(mixed $value, Closure|Rule|array $rules): array
     {
         $failingRules = [];
@@ -132,6 +143,31 @@ public function validateValue(mixed $value, Closure|Rule|array $rules): array
         return $failingRules;
     }
 
+    /**
+     * Validates the specified `$values` against the specified set `$rules`.
+     * The `$rules` array is expected to have the same keys as `$values`, associated with instance of {@see Tempest\Validation\Rule}.
+     * If `$rules` doesn't contain a key for a value, it will not be validated.
+     *
+     * @param array<string,mixed> $values
+     * @param array<string,\Tempest\Validation\Rule> $rules
+     */
+    public function validateValues(iterable $values, array $rules): array
+    {
+        $failingRules = [];
+
+        foreach ($values as $key => $value) {
+            if (! array_key_exists($key, $rules)) {
+                continue;
+            }
+
+            if ($failures = $this->validateValue($value, $rules[$key])) {
+                $failingRules[$key] = $failures;
+            }
+        }
+
+        return $failingRules;
+    }
+
     private function convertToRule(Rule|Closure $rule, mixed $value): Rule
     {
         if ($rule instanceof Rule) {

packages/validation/tests/ValidatorTest.php

@@ -238,4 +238,41 @@ public function test_skip_validation_attribute(): void
 
         $this->assertEmpty($failingRules);
     }
+
+    public function test_validate_values_some_invalid(): void
+    {
+        $failingRules = new Validator()->validateValues(
+            [
+                'name' => '',
+                'email' => 'invalid-email',
+                'age' => 0,
+            ],
+            [
+                'name' => [new IsString(), new NotNull()],
+                'email' => [new Email()],
+                'age' => [new IsInteger(), new NotNull()],
+            ],
+        );
+
+        $this->assertCount(1, $failingRules);
+        $this->assertInstanceOf(Email::class, $failingRules['email'][0]);
+    }
+
+    public function test_validate_values_all_valid(): void
+    {
+        $failingRules = new Validator()->validateValues(
+            [
+                'name' => '',
+                'email' => '[email protected]',
+                'age' => 0,
+            ],
+            [
+                'name' => [new IsString(), new NotNull()],
+                'email' => [new Email()],
+                'age' => [new IsInteger(), new NotNull()],
+            ],
+        );
+
+        $this->assertCount(0, $failingRules);
+    }
 }