Fix firstWhere behavior for relations

Author: driesvints

src/Illuminate/Database/Eloquent/Relations/BelongsToMany.php

@@ -574,6 +574,20 @@ public function findOrFail($id, $columns = ['*'])
         throw (new ModelNotFoundException)->setModel(get_class($this->related), $id);
     }
 
+    /**
+     * Add a basic where clause to the query, and return the first result.
+     *
+     * @param  \Closure|string|array  $column
+     * @param  mixed  $operator
+     * @param  mixed  $value
+     * @param  string  $boolean
+     * @return \Illuminate\Database\Eloquent\Model|static
+     */
+    public function firstWhere($column, $operator = null, $value = null, $boolean = 'and')
+    {
+        return $this->where($column, $operator, $value, $boolean)->first();
+    }
+
     /**
      * Execute the query and get the first result.
      *

src/Illuminate/Database/Eloquent/Relations/HasManyThrough.php

@@ -246,6 +246,20 @@ public function updateOrCreate(array $attributes, array $values = [])
         return $instance;
     }
 
+    /**
+     * Add a basic where clause to the query, and return the first result.
+     *
+     * @param  \Closure|string|array  $column
+     * @param  mixed  $operator
+     * @param  mixed  $value
+     * @param  string  $boolean
+     * @return \Illuminate\Database\Eloquent\Model|static
+     */
+    public function firstWhere($column, $operator = null, $value = null, $boolean = 'and')
+    {
+        return $this->where($column, $operator, $value, $boolean)->first();
+    }
+
     /**
      * Execute the query and get the first related model.
      *

tests/Integration/Database/EloquentBelongsToManyTest.php

@@ -629,6 +629,22 @@ public function testWherePivotOnString()
         $this->assertEquals($relationTag->getAttributes(), $tag->getAttributes());
     }
 
+    public function testFirstWhere()
+    {
+        $tag = Tag::create(['name' => 'foo']);
+        $post = Post::create(['title' => Str::random()]);
+
+        DB::table('posts_tags')->insert([
+            ['post_id' => $post->id, 'tag_id' => $tag->id, 'flag' => 'foo'],
+        ]);
+
+        $relationTag = $post->tags()->firstWhere('name', 'foo');
+        $this->assertEquals($relationTag->getAttributes(), $tag->getAttributes());
+
+        $relationTag = $post->tags()->firstWhere('name', '=', 'foo');
+        $this->assertEquals($relationTag->getAttributes(), $tag->getAttributes());
+    }
+
     public function testWherePivotOnBoolean()
     {
         $tag = Tag::create(['name' => Str::random()]);

tests/Integration/Database/EloquentHasManyThroughTest.php

@@ -48,15 +48,27 @@ public function testBasicCreateAndRetrieve()
         $user = User::create(['name' => Str::random()]);
 
         $team1 = Team::create(['id' => 10, 'owner_id' => $user->id]);
-        $team2 = Team::create(['owner_id' => $user->id]);
+        $team2 = Team::create(['owner_id' => $user->id, 'owner_slug' => 'foo']);
 
-        $mate1 = User::create(['name' => Str::random(), 'team_id' => $team1->id]);
-        $mate2 = User::create(['name' => Str::random(), 'team_id' => $team2->id]);
+        $mate1 = User::create(['name' => 'John', 'team_id' => $team1->id]);
+        $mate2 = User::create(['name' => 'Jack', 'team_id' => $team2->id, 'slug' => null]);
 
         User::create(['name' => Str::random()]);
 
         $this->assertEquals([$mate1->id, $mate2->id], $user->teamMates->pluck('id')->toArray());
         $this->assertEquals([$user->id], User::has('teamMates')->pluck('id')->toArray());
+
+        $result = $user->teamMates()->first();
+        $this->assertEquals(
+            $mate1->refresh()->getAttributes() + ['laravel_through_key' => '1'],
+            $result->getAttributes()
+        );
+
+        $result = $user->teamMates()->firstWhere('name', 'Jack');
+        $this->assertEquals(
+            $mate2->refresh()->getAttributes() + ['laravel_through_key' => '1'],
+            $result->getAttributes()
+        );
     }
 
     public function testGlobalScopeColumns()