The new findOr method in Laravel 9.x
A minor release for Laravel 9.x dropped a few days ago and among lots of new features and improvements, this release has introduced a new method called findOr in the Eloquent Builder and Relations.
So, before this release, Eloquent had the method called the findOrFail method which as its name suggests would throw a ModelNotFoundException exception if a model is not found.
$book = Book::findOrFail(1);
And eventually, a 404 HTTP response would be sent back to the client. Now, this could be fine for some scenarios but as you can tell, it’s not very much customizable instead of just failing and returning a default 404 HTTP response.
To mitigate this, Laravel 9.x now has the findOr method.
The findOr method
The findOr method works just like firstOr where it will return a single model instance or, if no results are found, execute the given closure. The value returned by the closure will be considered the result of the method.
Here are some examples that are directly taken from the PR.
User::findOr(1, fn () => throw new RuntimeException);
User::findOr(1, fn () => abort(403));
User::findOr(1, fn () => 'return something');
As you can tell, it’s now pretty convenient to alter the response in case there aren’t any matching models.
On top of this, you could also specify the columns that you want to retrieve as the second argument in form of an array like so.
$book = Book::findOr(1, ['name', 'author'], function () {
// do something
});
Works with Relationships
The method also works with HasMany, HasManyThrough, BelongsToMany, MorphMany, and MorphToMany relations seamlessly.
$user->posts()->findOr(1, fn () => '...');
Like this article?
Buy me a coffee
👋 Hi there! I'm Amit. I write articles about all things web development. You can become a sponsor on my blog to help me continue my writing journey and get your brand in front of thousands of eyes.
