[8.x] Adds whereRelation helper in Querying Relations (laravel#7283)

* Adds `whereRelation` helper in Querying Relations * formatting Co-authored-by: Taylor Otwell <[email protected]>
Alanaktion · Sep 3, 2021 · 34f05ea · 34f05ea
1 parent 3db02bd
commit 34f05ea
Showing 1 changed file with 15 additions and 0 deletions.
diff --git a/eloquent-relationships.md b/eloquent-relationships.md
@@ -1201,6 +1201,21 @@ If you need even more power, you may use the `whereHas` and `orWhereHas` methods
 
 > {note} Eloquent does not currently support querying for relationship existence across databases. The relationships must exist within the same database.
 
+<a name="inline-relationship-existence-queries"></a>
+#### Inline Relationship Existence Queries
+
+If you would like to query for a relationship's existence with a single, simple where condition attached to the relationship query, you may find it more convenient to use the `whereRelation` and `whereMorphRelation` methods. For example, we may query for all posts that have unapproved comments:
+
+    use App\Models\Post;
+
+    $posts = Post::whereRelation('comments', 'is_approved', false)->get();
+
+Of course, like calls to the query builder's `where` method, you may also specify an operator:
+
+    $posts = Post::whereRelation(
+        'comments', 'created_at', '>=', now()->subHour()
+    )->get();
+
 <a name="querying-relationship-absence"></a>
 ### Querying Relationship Absence