Get "PHP 8 in a Nuthshell" (Now comes with PHP 8.3)
Amit Merchant

Amit Merchant

A blog on PHP, JavaScript, and more

Route model bindings using custom columns in Laravel 7

I’ve discussed about Route Model Bindings of Laravel in length in this article previously. If you’re not aware about the feature, I’d recommend you check that article first and come back here again.

So basically, using route model bindings, you can validate model IDs that have been injected into the route by injecting model instances directly at route level. Meaning, you don’t have to explicitly validate if the id passed through the route is a valid model ID or not. Here’s an example of how you can do it.

Route::get('api/users/{user}', function (App\User $user) {
   return $user->email;

Here, Laravel will automatically resolves Eloquent models defined in routes or controller actions whose type-hinted variable names match a route segment name. So you don’t have to explicitly write business logic like so.

Route::get('api/users/{id}', function ($id) {
   $user = User::find($id);

   if ($user) {   
      return $user->email;

But this approach was limited to use only the id field of the associated model. What if you want to use fields other than id in order to validate the model bindings? Well, the good news is starting from Laravel 7, you can do just that.

You may also like: Laravel Route Model Bindings - Implicit Vs. Explicit

Model bindings using custom columns

To actually use a different column/field in the binding, you’d just need to pass in the column in the route parameter definition like so.

Route::get('api/posts/{post:slug}', function (App\Post $post) {
    return $post->title;

//e.g. =>

Now, you can just pass in the slug for the post instead of an id like and laravel will fetch the record based on the slug that is provided in the route.

Using two model binding in the route

Apart from using a single route model binding, you can also use multiple eloquent models in the route definition. You can use it for the scenarios where you need to fetch the record based the parent-child relationship. For instance, take the following example.

use App\Post;
use App\User;

Route::get('api/users/{user}/posts/{post:slug}', function (User $user, Post $post) {
    return $post;

Here, the Post model belongs to User model and we’re using custom key for the Post model. Here, Laravel will automatically scope the query to retrieve the nested model by its parent using conventions to guess the relationship name on the parent. In this case, it will be assumed that the User model has a relationship named posts which can be used to retrieve the Post model. i.e. Scoping has been done automatically by Laravel as you don’t have mention in explicitly.

Learn the fundamentals of PHP 8 (including 8.1, 8.2, and 8.3), the latest version of PHP, and how to use it today with my new book PHP 8 in a Nutshell. It's a no-fluff and easy-to-digest guide to the latest features and nitty-gritty details of PHP 8. So, if you're looking for a quick and easy way to PHP 8, this is the book for you.

Like this article? Consider leaving a


👋 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.