# feat: Implement 'each' rule for array item validation and enhance documentation. Version 1.2.0

## Description

This commit introduces the highly requested `each` validation rule, enabling granular validation of every item within an array against a specified set of sub-rules. The `each` rule supports both `AND` (`&`) and `OR` (`,`) operators, providing flexible control over how multiple sub-rules are applied to array elements.

In addition to this new feature, the `README.md` has been substantially updated with comprehensive examples for all existing validation rules, significantly improving the clarity and usability of the documentation. This includes detailed examples for basic, string, length, data type, and advanced rules, as well as a refined error handling section.

A critical bug has also been addressed where numeric `min` validation incorrectly checked the string length of a number instead of its actual value. Error messages for numeric `min` and `max` rules have been improved for better clarity and consistency.

## Changes in the codebase

*   **`src/Rules/Each.php`**: New rule class implementing the `each` validation logic, including support for `&` (AND) and `,` (OR) operators for sub-rules.
*   **`src/Rules/Lib/RulesIndex.php`**: Registered the new `Each` rule in the rules index.
*   **`src/Exceptions/ValidationError.php`**: Added a new error message for `attr` when rule attributes are undefined, primarily to support the `each` rule's attribute requirements.
*   **`src/Rules/Lib/Calculate.php`**: Fixed a bug in the `numaricLength` method where numeric `min` validation was comparing string length (`strlen($data)`) instead of the actual numeric value (`$data`).
*   **`src/Rules/MaxLength.php`**: Updated the error message for the numeric `max` rule to be more generic ("maximum X" instead of "maximum X digits").
*   **`src/Rules/MinLength.php`**: Updated the error message for the numeric `min` rule to be more generic ("minimum X" instead of "minimum X digits").
*   **`src/Rules/Lib/RulesParser.php`**: Modified `parseRuleName` to correctly handle attribute parsing for the `each` rule's sub-rules.
*   **`README.md`**:
    *   Removed the outdated "Handling Errors" section.
    *   Added the `each` rule to the "Available Rules" table.
    *   Introduced a comprehensive "Examples" section with detailed usage for all validation rules, including basic, string, length, data type, advanced, and combining multiple rules.
    *   Updated the "Error Handling Example" to reflect the `error()` method returning an array.

## Additional information

The introduction of the `each` rule significantly enhances the validator's capability for handling complex array structures and nested data validation. The improved documentation will make it easier for users to understand and utilize the full range of validation rules effectively. The numeric `min`/`max` fix ensures correct behavior for number-based length checks, preventing unexpected validation failures.

Author: AbmSourav

README.md

@@ -46,23 +46,6 @@ $validator = Validator::validate(
 <br>
 <br>
 
-## Handling Errors
-
-If any data is invalid then `error` method will return error messages array. Otherwise it'll return false.
-<br>
-`getData` method will return validated data array.
-
-```php
-$error = $validator->error();
-if ($error) {
-	return $error;
-}
-$validator->getData();
-```
-
-<br>
-<br>
-
 ## Available Rules
 
 | Rule | Description |
@@ -84,3 +67,343 @@ $validator->getData();
 | integer | Check the value is integer. |
 | sameValue | Check the value is same as the given value. |
 | array | Check the value is an array. |
+| each | validate each item of an array. |
+
+<br>
+<br>
+
+## Examples
+
+### Basic Validation Rules
+
+#### Required Rule
+Ensures the field is present and not empty.
+
+```php
+$validator = Validator::validate(
+    ['username' => 'required'],
+    ['username' => 'john_doe']  // ✅ Valid
+);
+
+// Invalid examples:
+// ['username' => '']         // ❌ Empty string
+// ['username' => null]       // ❌ Null value
+// []                         // ❌ Missing field
+```
+
+#### Email Rule
+Validates email address format.
+
+```php
+$validator = Validator::validate(
+    ['email' => 'email'],
+    ['email' => 'user@example.com']  // ✅ Valid
+);
+
+// Invalid examples:
+// ['email' => 'invalid-email']     // ❌ Invalid format
+// ['email' => '@example.com']      // ❌ Missing username
+// ['email' => 'user@']             // ❌ Missing domain
+```
+
+#### URL Rule
+Validates URL format.
+
+```php
+$validator = Validator::validate(
+    ['website' => 'url'],
+    ['website' => 'https://example.com']  // ✅ Valid
+);
+
+// Also valid:
+// ['website' => 'http://example.com']
+// ['website' => 'ftp://files.example.com']
+
+// Invalid examples:
+// ['website' => 'not-a-url']       // ❌ Invalid format
+// ['website' => 'example.com']     // ❌ Missing protocol
+```
+
+### String Validation Rules
+
+#### String Only (stringOnly)
+Validates that the value contains only alphabetic characters.
+
+```php
+$validator = Validator::validate(
+    ['name' => 'stringOnly'],
+    ['name' => 'John']  // ✅ Valid
+);
+
+// Invalid examples:
+// ['name' => 'John123']            // ❌ Contains numbers
+// ['name' => 'John Doe']           // ❌ Contains space
+// ['name' => 'John-Doe']           // ❌ Contains dash
+```
+
+#### String with Spaces (stringWithSpace)
+Validates strings that can contain alphabetic characters and spaces.
+
+```php
+$validator = Validator::validate(
+    ['full_name' => 'stringWithSpace'],
+    ['full_name' => 'John Doe']  // ✅ Valid
+);
+
+// Also valid:
+// ['full_name' => 'Mary Jane Watson']
+
+// Invalid examples:
+// ['full_name' => 'John123']       // ❌ Contains numbers
+// ['full_name' => 'John-Doe']      // ❌ Contains dash
+```
+
+#### String with Numbers (stringWithNumber)
+Validates strings that can contain alphabetic characters and numbers.
+
+```php
+$validator = Validator::validate(
+    ['username' => 'stringWithNumber'],
+    ['username' => 'user123']  // ✅ Valid
+);
+
+// Also valid:
+// ['username' => 'JohnDoe456']
+
+// Invalid examples:
+// ['username' => 'user 123']       // ❌ Contains space
+// ['username' => 'user-123']       // ❌ Contains dash
+```
+
+#### String with Dash (stringWithDash)
+Validates strings that can contain alphabetic characters, dashes, and underscores.
+
+```php
+$validator = Validator::validate(
+    ['slug' => 'stringWithDash'],
+    ['slug' => 'hello-world_page']  // ✅ Valid
+);
+
+// Also valid:
+// ['slug' => 'my_awesome_post']
+// ['slug' => 'hello-world']
+
+// Invalid examples:
+// ['slug' => 'hello world']        // ❌ Contains space
+// ['slug' => 'hello123']           // ❌ Contains numbers
+```
+
+#### Case Validation Rules
+
+```php
+// Uppercase only
+$validator = Validator::validate(
+    ['code' => 'uppercase'],
+    ['code' => 'HELLO']  // ✅ Valid
+);
+
+// Lowercase only
+$validator = Validator::validate(
+    ['tag' => 'lowercase'],
+    ['tag' => 'hello']  // ✅ Valid
+);
+
+// Mixed case (both upper and lower case required)
+$validator = Validator::validate(
+    ['password' => 'mixedCase'],
+    ['password' => 'HelloWorld']  // ✅ Valid
+);
+```
+
+#### String with Symbols (stringWithSymbols)
+Validates strings that can contain symbols and special characters.
+
+```php
+$validator = Validator::validate(
+    ['password' => 'stringWithSymbols'],
+    ['password' => 'Pass@123!']  // ✅ Valid
+);
+
+// Also valid:
+// ['password' => 'My$ecur3#Pass']
+```
+
+### Length Validation Rules
+
+#### Minimum Length (min)
+Validates minimum length/size requirements.
+
+```php
+// String minimum length
+$validator = Validator::validate(
+    ['password' => 'min:8'],
+    ['password' => 'mypassword']  // ✅ Valid (10 characters)
+);
+
+// Number minimum value
+$validator = Validator::validate(
+    ['age' => 'min:18'],
+    ['age' => 25]  // ✅ Valid
+);
+
+// Array minimum items
+$validator = Validator::validate(
+    ['tags' => 'min:2'],
+    ['tags' => ['php', 'javascript', 'html']]  // ✅ Valid (3 items)
+);
+```
+
+#### Maximum Length (max)
+Validates maximum length/size requirements.
+
+```php
+// String maximum length
+$validator = Validator::validate(
+    ['title' => 'max:100'],
+    ['title' => 'Short Title']  // ✅ Valid
+);
+
+// Number maximum value
+$validator = Validator::validate(
+    ['score' => 'max:100'],
+    ['score' => 85]  // ✅ Valid
+);
+
+// Array maximum items
+$validator = Validator::validate(
+    ['categories' => 'max:5'],
+    ['categories' => ['tech', 'news']]  // ✅ Valid (2 items)
+);
+```
+
+### Data Type Rules
+
+#### Integer Rule
+Validates that the value is an integer.
+
+```php
+$validator = Validator::validate(
+    ['age' => 'integer'],
+    ['age' => 25]  // ✅ Valid
+);
+
+// Also valid:
+// ['age' => '30']              // ✅ String numbers are valid
+
+// Invalid examples:
+// ['age' => 25.5]              // ❌ Float value
+// ['age' => 'twenty']          // ❌ Text value
+```
+
+#### Array Rule
+Validates that the value is an array.
+
+```php
+$validator = Validator::validate(
+    ['tags' => 'array'],
+    ['tags' => ['php', 'javascript']]  // ✅ Valid
+);
+
+// Invalid examples:
+// ['tags' => 'php,javascript']     // ❌ String value
+// ['tags' => 123]                  // ❌ Number value
+```
+
+### Advanced Rules
+
+#### Same Value (sameValue)
+Validates that the field value matches a specific value.
+
+```php
+$validator = Validator::validate(
+    ['confirmation' => 'sameValue:yes'],
+    ['confirmation' => 'yes']  // ✅ Valid
+);
+
+// For password confirmation:
+$validator = Validator::validate(
+    [
+        'password' => 'required|min:8',
+        'password_confirmation' => 'sameValue:' . $_POST['password']
+    ],
+    $_POST
+);
+```
+
+#### Each Rule
+Validates each item in an array against specified rules.
+
+```php
+// Validate each email in an array
+$validator = Validator::validate(
+    ['emails' => 'each:email'],
+    ['emails' => ['user1@example.com', 'user2@example.com']]  // ✅ Valid
+);
+
+// Validate each item with multiple rules (`&` [AND] operator)
+$validator = Validator::validate(
+    ['usernames' => 'each:required&stringOnly&min:3'],
+    ['usernames' => ['john', 'jane', 'mike']]  // ✅ Valid
+);
+
+// Validate each item with OR operator
+$validator = Validator::validate(
+    ['identifiers' => 'each:email,integer'],
+    ['identifiers' => ['user@example.com', 12345]]  // ✅ Valid
+);
+```
+
+### Combining Multiple Rules
+
+You can combine multiple rules using the pipe (`|`) separator:
+
+```php
+$validator = Validator::validate(
+    [
+        'username'	=> 'required|stringOnly|min:3|max:20',
+        'email'		=> 'required|email',
+        'password'	=> 'required|min:8|mixedCase',
+        'age'		=> 'required|integer|min:18|max:100',
+        'tags'		=> 'array|min:1|max:10',
+        'skills'	=> 'each:stringOnly&min:2'
+    ],
+    [
+        'username'	=> 'johndoe',
+        'email'		=> 'john@example.com',
+        'password'	=> 'MySecure123',
+        'age'		=> 25,
+        'tags'		=> ['php', 'javascript'],
+        'skills'	=> ['programming', 'design']
+    ]
+);
+
+$data = $validator->getData();
+
+```
+
+### Error Handling Example
+
+If any data is invalid then `error` method will return error messages array. Otherwise it'll return empty array.
+
+```php
+$validator = Validator::validate(
+    [
+        'username' => 'required|stringOnly|min:3',
+        'email' => 'required|email'
+    ],
+    [
+        'username' => 'ab',  // Too short
+        'email' => 'invalid-email'  // Invalid format
+    ]
+);
+
+$errors = $validator->error();
+if ($errors) {
+    // Handle validation errors
+    foreach ($errors as $field => $message) {
+        echo "Error in {$field}: {$message[0]}\n";
+    }
+}
+
+$data = $validator->getData();
+```

composer.json

@@ -1,7 +1,7 @@
 {
     "name": "codesvault/validator",
     "description": "Data validation library",
-    "version": "1.1.2",
+    "version": "1.2.0",
     "type": "library",
     "license": "MIT",
     "autoload": {

src/Exceptions/ValidationError.php

@@ -42,7 +42,9 @@ public function errorMessage()
 			'url'					=> "`{$this->dataIdentifier}` only allows valid URL",
 			'sameValue'				=> "`{$this->dataIdentifier}` only allows same value as {$this->attribute}",
 
-			'array'				=> "`{$this->dataIdentifier}` only allows array",
+			'array'					=> "`{$this->dataIdentifier}` only allows array",
+
+			'attr'					=> "`{$this->dataIdentifier}` rule attributes not defined",
 		];
 	}