Laravel Eloquent local query scope reusable filters

PHP Dasun Kalupahana October 19, 2026 77 views

<?php

// app/Models/Post.php
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Attributes\Scope;

#[Scope]
public function published(Builder $query): void
{
    $query->where('status', 'published')
                 ->whereNotNull('published_at');
}

// Usage
$posts = Post::published()->latest('published_at')->paginate(10);

Wraps a common where condition in a reusable method on the model. Use it so filters like “published” aren’t repeated across controllers.

#laravel #eloquent #scope #query-builder #models #clean-code