I’ve collected my 35 best performing Eloquent-related tweets and put them together in one huge thread. You’ll also find a downloadable PDF below.
🧵Terra-Thread is coming!
1/37
Attribute Cast
In Laravel 8 you can define an accessor in one method with an Attribute cast:
2/37
whereRelation
This example: give every Holding where the Stock relation's ticker column is equal to AAPL:
3/37
whereBelongsTo
You don’t have to compare IDs anymore:
4/37
Invisible Database Columns
It’s a new concept in MySQL 8. What it does: when you run a select * query it won't retrieve any invisible column. If you need an invisible column's value you have to specify it explicitly in the select statement.
And now, Laravel supports this:
5/37
saveQuietly
If you ever need to save a model but you don't want to trigger any model events, you can use this method:
6/37
oldestOfMany
There's a special relationship called oldestOfMany. You can use it if you constantly need the oldest model from a hasMany relationship:
7/37
Default Attribute Values
You can specify default attribute values in migrations and in the Model as well:
8/37
Find with an array of IDs
Everyone knows about the find method, but did you know that it accepts an array of IDs?
9/37
Get Dirty
In Eloquent you can check if a model is "dirty" or not. Dirty means it has some changes that are not persisted yet:
10/37
withDefault
If you have a nullable relationship you can easily end up checking for null values all over the place. Fortunately, the withDefault method solves this problem:
11/37
❗Stop bookmarking
I've put together a 34 pages PDF from these tips. You can download it here (free):
We all write traits that are being used by Eloquent models. If you need to initialize something in your trait when an event happened in the model, you can boot your trait:
13/37
updateOrCreate
Creating and updating a model often use the same logic. Fortunately Eloquent provides a very convenient method called updateOrCreate.
It will run an update query if the model exists and an insert query if it does not exist:
14/37
upsert
If you want to run multiple update or create operations you can use the upsert:
15/37
when
We often need to append a where clause to a query based on some conditional, for example, a Request parameter. Instead of if statements you can use the when method:
16/37
appends
If you have an attribute accessor and you often need it when the model is converted into JSON you can use the $appends property.
It’s useful when you’re working with Blade:
17/37
latestOfMany
Similarly to oldestOfMany we can use the latestOfMany as well:
18/37
ofMany
You can also use the ofMany relationship with custom logic, for example:
19/37
hasManyThrough
Consider this: Department → has many → Employee → has many → Paycheck
You can define a hasManyThrough relationship on the Department model that will return Paychecks through the Employee model:
20/37
hasManyDeep
Okay, this is clickbait, because there is no hasManyDeep relationship in Laravel but there is an excellent package called eloquent-has-many-deep.
Consider the following relationships:
Country -> has many -> User -> has many -> Post -> has many -> Comment
21/37
Push
Sometimes you need to save a model and its relationship as well. In this case, you can use the push method:
22/37
withAvg
In this example, we have a Book and a Rating model. A book has many ratings. Let's say we need to order the books by the average rating.
We can use the withAvg method:
23/37
Eager Loading Specific Columns
select * queries can be slow and memory-consuming. If you want to eager a relationship but you don't need every column, you can specify which ones you want to load:
24/37
saveMany
With the saveMany function, you can save multiple related models in one function call.
25/37
createMany
Similarly to saveMany you can also use the createMany if you don't have models, but arrays instead:
26/37
foreignId & constrained
27/37
nullOnDelete
If you have a nullable relationship just use the nullOnDelete helper:
28/37
afterCreating
There's an afterCreating method on the Factory class that you can use to do something after a Model has been created.
When I have Users with profile pictures, I always use this feature:
29/37
Factory For
Instead of creating the category and passing it as an attribute, you can use the for method:
30/37
Factory Has
With the has method you can do the inverse of the relationship. So you can use this for has many relationships:
31/37
Factory States
When working with factories in tests (or seeders) we often need a specific 'state' in a given model. Let's say we have a Product model and it has an active column.
You can do this:
32/37
Log Every Database Query
We often want to see every database query that was executed in a request during development. There are multiple solutions, but here's the most simple one:
33/37
whenLoaded
You can avoid N+1 queries in API resources by using the whenLoaded() method. This will only append the department if it’s already loaded in the Employee model.
Without whenLoaded() there is always a query for the department:
34/37
Pagination Links With Query String
If you have pagination in your project and you want to keep the query string from the request URL you can use the withQueryString() method.
Otherwise, your query string will be lost in the pagination links.
35/37
If you have a logic in your application that deletes some old or unused rows from the database, you can use the Prunable trait.
You don't need to write your own command, you can schedule the one provided by Laravel:
36/37
Custom Query Builder
With Eloquent you can define your own query builders for your models. By using this you can move your scopes and queries from your models.