[9.x] Let Multiple* exceptions hold the number of records and items f…

…ound (#41164)

* Let Multiple* exceptions hold the number of records and items found.

* formatting

Co-authored-by: Taylor Otwell <taylor@laravel.com>

Concerns/BuildsQueries.php

@@ -309,12 +309,14 @@ public function sole($columns = ['*'])
     {
         $result = $this->take(2)->get($columns);
 
-        if ($result->isEmpty()) {
+        $count = $result->count();
+
+        if ($count === 0) {
             throw new RecordsNotFoundException;
         }
 
-        if ($result->count() > 1) {
-            throw new MultipleRecordsFoundException;
+        if ($count > 1) {
+            throw new MultipleRecordsFoundException($count);
         }
 
         return $result->first();

Eloquent/Relations/Relation.php

@@ -171,12 +171,14 @@ public function sole($columns = ['*'])
     {
         $result = $this->take(2)->get($columns);
 
-        if ($result->isEmpty()) {
+        $count = $result->count();
+
+        if ($count === 0) {
             throw (new ModelNotFoundException)->setModel(get_class($this->related));
         }
 
-        if ($result->count() > 1) {
-            throw new MultipleRecordsFoundException;
+        if ($count > 1) {
+            throw new MultipleRecordsFoundException($count);
         }
 
         return $result->first();

MultipleRecordsFoundException.php

@@ -6,5 +6,35 @@
 
 class MultipleRecordsFoundException extends RuntimeException
 {
-    //
+    /**
+     * The number of records found.
+     *
+     * @var int
+     */
+    public $count;
+
+    /**
+     * Create a new exception instance.
+     *
+     * @param  int  $count
+     * @param  int  $code
+     * @param  \Throwable|null  $previous
+     * @return void
+     */
+    public function __construct($count, $code = 0, $previous = null)
+    {
+        $this->count = $count;
+
+        parent::__construct("$count records were found.", $code, $previous);
+    }
+
+    /**
+     * Get the number of records found.
+     *
+     * @return int
+     */
+    public function getCount()
+    {
+        return $this->count;
+    }
 }