Add Result::getPropertyErrorMessagesByPath() method

Author: vjik

CHANGELOG.md

@@ -2,7 +2,7 @@
 
 ## 2.4.1 under development
 
-- no changes in this release.
+- New #774: Add `Result::getPropertyErrorMessagesByPath()` method (@vjik)
 
 ## 2.4.0 July 07, 2025
 

docs/guide/en/result.md

@@ -86,6 +86,14 @@ The output for example above:
 ];
 ```
 
+#### Filtering by a specific path
+
+This list of error messages can be filtered by a specific path to property.
+
+```php
+$result->getPropertyErrorMessagesByPath(['person', 'first_name']);
+```
+
 ### Error messages indexed by property
 
 To group error messages by property, use the following `Result` API call:

src/Result.php

@@ -8,6 +8,7 @@
 use Stringable;
 
 use function array_slice;
+use function count;
 use function implode;
 use function is_string;
 
@@ -202,6 +203,23 @@ public function getPropertyErrorMessages(string $property): array
         return $errors;
     }
 
+    /**
+     * Get an array of error messages for the path specified.
+     *
+     * @psalm-param list<string> $path
+     * @psalm-return list<string>
+     */
+    public function getPropertyErrorMessagesByPath(array $path): array
+    {
+        $errors = [];
+        foreach ($this->errors as $error) {
+            if ($path === array_slice($error->getValuePath(), 0, count($path))) {
+                $errors[] = $error->getMessage();
+            }
+        }
+        return $errors;
+    }
+
     /**
      * Get arrays of error messages for the property specified indexed by property path.
      * Each key is a dot-separated property path.

tests/ResultTest.php

@@ -189,6 +189,23 @@ public function testGetAttributeErrorMessages(): void
         $this->assertEquals(['error4.1', 'error4.2'], $result->getPropertyErrorMessages('attribute4'));
     }
 
+    public function testGetPropertyErrorMessagesByPath(): void
+    {
+        $result = (new Result())
+            ->addError('e1', valuePath: ['age'])
+            ->addError('e2', valuePath: ['person'])
+            ->addError('e3', valuePath: ['person', 'first_name'])
+            ->addError('e4', valuePath: ['person', 'first_name'])
+            ->addError('e5', valuePath: ['person', 'last_name'])
+            ->addError('e6');
+
+        $this->assertSame(['e1', 'e2', 'e3', 'e4', 'e5', 'e6'], $result->getPropertyErrorMessagesByPath([]));
+        $this->assertSame([], $result->getPropertyErrorMessagesByPath(['non-exists']));
+        $this->assertSame(['e1'], $result->getPropertyErrorMessagesByPath(['age']));
+        $this->assertSame(['e2', 'e3', 'e4', 'e5'], $result->getPropertyErrorMessagesByPath(['person']));
+        $this->assertSame(['e3', 'e4'], $result->getPropertyErrorMessagesByPath(['person', 'first_name']));
+    }
+
     public function testGetAttributeErrorMessagesIndexedByPath(): void
     {
         $result = $this->createAttributeErrorResult();