News

Local Model Scopes in Laravel with the Scope Attribute

Published
Local Model Scopes in Laravel with the Scope Attribute image

Release updates

Never miss a Laravel release

Get an email whenever a new Laravel release lands.

When I wrote about Laravel 12.4, I missed a completely new way to write local scopes in Eloquent models 😅. For as long as I can remember, you can define query scopes within a model by prefixing a public method with scope:

public function scopePopular(Builder $query): void
{
$query->where('votes', '>', 100);
}
 
User::popular()->orderBy('created_at', 'DESC')->get();

While Laravel 12 applications will still support the scope* prefixed methods to define a model scope, the new #[Scope] attribute can be used, and it keeps your method name as intended:

use Illuminate\Database\Eloquent\Attributes\Scope;
 
#[Scope]
protected function popular(Builder $query): void
{
$query->where('votes', '>', 100);
}

You can learn more about scopes and getting started with Eloquent in the Laravel documentation. This feature was merged in Laravel v12.4 - check out pull request #54450 for discussion and implementation details.

Paul Redmond photo

Staff writer at Laravel News. Full stack web developer and author.

Sponsored

laravelcloud logo
Laravel Cloud

Easily create and manage your servers and deploy your Laravel applications in seconds.

Visit Laravel Cloud

The latest

View all →
Look What You Helped Me Build image

Look What You Helped Me Build

Read article
BashBox: A Sandboxed Bash Interpreter for AI Agents in PHP image

BashBox: A Sandboxed Bash Interpreter for AI Agents in PHP

Read article
Running Laravel's Scheduler on Multiple Servers image

Running Laravel's Scheduler on Multiple Servers

Read article
Laravel Fake Assertions Now Accept Property Arrays image

Laravel Fake Assertions Now Accept Property Arrays

Read article
Route::query() and Model defaults() in Laravel 13.35 image

Route::query() and Model defaults() in Laravel 13.35

Read article
Laravel AI SDK 1.1 Adds Agent Skills and Cohere Chat image

Laravel AI SDK 1.1 Adds Agent Skills and Cohere Chat

Read article