Change getArrayGetter to match getArray concepts. Add getNullableArrayGetter

⛑ Made `getArrayGetter` match `getArray` (returns always array instance) and add `getNullableArrayGetter` to return null if data is missing or empty.

🛠 `getArrayGetter` does not return null any more. Use `getNullableArrayGetter` instead to get null if data is missing.

Author: pionl

docs/content/en/index.md

@@ -146,7 +146,7 @@ $value = $data->getRequiredDateTime('key');
 
 > Throws always `NotAnArrayException` exception if value exists but is not an array.
 
-Get always an array event if provided data is missing or if null.
+Get always an array even if provided data is missing or if null.
 
 ```php
 $value = $data->getArray('key');
@@ -155,7 +155,7 @@ $value = $data->getArray('key');
 Get nullable array.
 
 ```php
-$value = $data->getRequiredArray('key');
+$value = $data->getNullableArray('key');
 ```
 
 Get required array that is not empty. Throws `ArrayIsEmptyException` exception if missing.
@@ -168,12 +168,18 @@ $value = $data->getRequiredArray('key');
 
 > Throws always `NotAnArrayException` exception if value exists but is not an array.
 
-Try to get nullable array from data and wrap it in `GetValue` instance.
+Get always `GetValue` instance even if provided data is missing or if null.
 
 ```php
 $value = $data->getArrayGetter('key');
 ```
 
+Try to get nullable array from data and wrap it in `GetValue` instance.
+
+```php
+$value = $data->getNullableArrayGetter('key');
+```
+
 Try to get non-empty array from data and wrap it in `GetValue` instance. Throws `ArrayIsEmptyException` exception if
 missing.
 

src/GetValue.php

@@ -228,17 +228,25 @@ public function getRequiredArray(string $key): array
     }
 
     /**
-     * Ensures that always an array getter will be returned (if missing in $data or if null).
+     * Get always `GetValue` instance even if provided data is missing or if null.
      */
-    public function getArrayGetter(string $key): ?self
+    public function getArrayGetter(string $key): self
+    {
+        return new self(new ArrayData($this->getArray($key)), $this->exceptionBuilder, $this->getValidatedValueAction);
+    }
+
+    /**
+     * Try to get nullable array from data and wrap it in `GetValue` instance.
+     */
+    public function getNullableArrayGetter(string $key): ?self
     {
         $value = $this->getNullableArray($key);
 
         if ($value === null || $value === []) {
             return null;
         }
 
-        return new self(new ArrayData($value), $this->exceptionBuilder);
+        return new self(new ArrayData($value), $this->exceptionBuilder, $this->getValidatedValueAction);
     }
 
     /**
@@ -248,7 +256,7 @@ public function getRequiredArrayGetter(string $key): self
     {
         $value = $this->getRequiredArray($key);
 
-        return new self(new ArrayData($value), $this->exceptionBuilder);
+        return new self(new ArrayData($value), $this->exceptionBuilder, $this->getValidatedValueAction);
     }
 
     /**

tests/GetValueArrayDataTest.php

@@ -56,12 +56,26 @@ public function testGetArrayGetterOnNonArray(): void
 
     public function testGetArrayGetterOnNonExistingItem(): void
     {
-        $this->assertNull($this->data->getArrayGetter(''));
+        $result = $this->data->getArrayGetter('');
+        $this->assertInstanceOf(GetValue::class, $result);
+        $this->assertEmpty($result->data->get());
     }
 
     public function testGetArrayGetterOnEmptyArray(): void
     {
-        $this->assertNull($this->data->getArrayGetter(self::KeyItemsEmpty));
+        $result = $this->data->getArrayGetter(self::KeyItemsEmpty);
+        $this->assertInstanceOf(GetValue::class, $result);
+        $this->assertEmpty($result->data->get());
+    }
+
+    public function testGetNullableArrayGetterOnNonExistingItem(): void
+    {
+        $this->assertNull($this->data->getNullableArrayGetter(''));
+    }
+
+    public function testGetNullableArrayGetterOnEmptyArray(): void
+    {
+        $this->assertNull($this->data->getNullableArrayGetter(self::KeyItemsEmpty));
     }
 
     protected function assertItem(