What is the meaning of Eloquent's Model::query()?

Question

Can anyone please explain in detail what Eloquent's Model::query() means?

it returns the query builder for the given model ! – Maraboc Jul 25 '18 at 10:57 — Maraboc, Jul 25 '18 at 10:57

score 72 · Accepted Answer · edited Jan 08 '23 at 18:52

72

Any time you're querying a Model in Eloquent, you're using the Eloquent Query Builder. Eloquent models pass calls to the query builder using magic methods (__call, __callStatic). Model::query() returns an instance of this query builder.

Therefore, since where() and other query calls are passed to the query builder:

Model::where()->get();

Is the same as:

Model::query()->where()->get();

Where I've found myself using Model::query() in the past is when I need to instantiate a query and then build up conditions based on request variables.

$query = Model::query();
if ($request->color) {
    $query->where('color', $request->color);
}

edited Jan 08 '23 at 18:52

ruleboy21

5,510
4
17
34

answered Jul 25 '18 at 11:12

Devon Bessemer

34,461
9
69
95

2

Thanks @Devon. Can you provide a reference of the documentation? – Shateel Ahmed Jul 26 '18 at 05:08
What documentation are you looking for exactly? The query builder's? You can look at the API documentation or the Model class itself to see what it returns. – Devon Bessemer Jul 26 '18 at 13:04
Can we do Joins on this? – Shulz Sep 17 '21 at 04:34
1

@Shulz I would recommend using the relation methods built into Eloquent than doing your own join with the eloquent model. Otherwise, you can use the Query Builder as standalone and write a query that returns loosely typed objects – Devon Bessemer Sep 20 '21 at 14:36
inorder to get the response use `$query->get()'` – Mohamed Raza May 19 '22 at 17:20
1

Why there is no documentation for query() method in the Laravel documentation? – CuriousTeam Dec 27 '22 at 19:24

What is the meaning of Eloquent's Model::query()?

1 Answers1

Linked