Exposes the ability to see the reasons for validation failure

Author: Jaspaul

src/Contracts/Validatable.php

@@ -28,4 +28,11 @@ public function isInvalid() : bool;
      * @return \Illuminate\Contracts\Support\MessageProvider
      */
     public function getErrors() : MessageProvider;
+
+    /**
+     * Returns the reasons why the validator failed.
+     *
+     * @return array
+     */
+    public function getValidationFailureReasons() : array;
 }

src/Traits/Validates.php

@@ -34,6 +34,13 @@ protected function getMessages() : array
         return [];
     }
 
+    /**
+     * The validator.
+     *
+     * @return \Illuminate\Contracts\Validation\Validator
+     */
+    private $validator;
+
     /**
      * Returns an instance of the validator from our container.
      *
@@ -52,11 +59,14 @@ private function getValidationFactory() : Factory
      */
     private function getValidator() : Validator
     {
-        return $this->getValidationFactory()->make(
-            $this->getData(),
-            $this->getRules(),
-            $this->getMessages()
-        );
+        if (is_null($this->validator)) {
+            $this->validator = $this->getValidationFactory()->make(
+                $this->getData(),
+                $this->getRules(),
+                $this->getMessages()
+            );
+        }
+        return $this->validator;
     }
 
     /**
@@ -106,6 +116,19 @@ public function getErrors() : MessageProvider
         return $this->getValidator()->getMessageBag();
     }
 
+    /**
+     * Returns the reasons why the validator failed.
+     *
+     * @return array
+     */
+    public function getValidationFailureReasons() : array
+    {
+        if ($this->isInvalid()) {
+            return $this->getValidator()->failed();
+        }
+        return [];
+    }
+
     /**
      * Save the model to the database.
      *

tests/InvalidModelTest.php

@@ -52,4 +52,13 @@ public function testValidateThrowsAValidationException()
         $model = new InvalidModel();
         $model->validate();
     }
+
+    public function testGetValidationFailureReasonsReturnsTheReasonsWhyTheValidationFailed()
+    {
+        $model = new InvalidModel();
+        $reasons = $model->getValidationFailureReasons();
+
+        $this->assertTrue(array_key_exists('email', $reasons));
+        $this->assertTrue(array_key_exists('Required', $reasons['email']));
+    }
 }

tests/ValidModelTest.php

@@ -33,4 +33,10 @@ public function testValidateDoesNotThrowAValidationException()
         $model = new ValidModel();
         $this->assertVoid($model->validate());
     }
+
+    public function testGetValidationFailureReasonsReturnsAnEmptyArray()
+    {
+        $model = new ValidModel();
+        $this->assertEmpty($model->getValidationFailureReasons());
+    }
 }