Cómo se usan los Query Scopes

Angel Cruz
Angel Cruz

Los query scopes son una alternativa para optimizar nuestro código cuando necesitamos hacer condiciones específicas en nuestras consultas, acá en este post te explico de que tratan.

Una de las características más poderosas de Laravel son los query scopes ya que son fáciles de usar, los query scopes facilita la creación de consultas SQL complejas que en algunos casos se pueden volver a aplicar la misma condición a otros modelos dentro de tu aplicación.

Aquí hay un ejemplo de código de cómo crear un query scope en Laravel:

1<?php
2namespace App\Models;
3 
4use Illuminate\Database\Eloquent\Model;
5 
6class User extends Model
7{
8 /**
9 * Scope a query to only include active users.
10 *
11 * @param \Illuminate\Database\Eloquent\Builder $query
12 * @return void
13 */
14 public function scopeActive($query)
15 {
16 $query->where('active', 1);
17 }
18}

En el ejemplo anterior, creamos un query scope llamado Active en el modelo User, donde basicamente lo que hace agregar una condición WHERE para extraer solo los usuarios que esten activos.

La forma de usarlo sería la siguiente:

1User::active()->get()

Consideraciones para usar los query scopes

Para definir y usar correctamente los query scope, debemos seguir algunas reglas:

  • Todos los scopes deben recibir la variable $query.

  • Todos los nombres de los scopes deben comenzar con la palabra scope seguido del nombre que queremos llamarlo.

En un próximo artículo voy a tratar de explicar una forma de organizar los scopes y hacer que sean "IDE friendly" 😏

Para más información visiten este enlace: https://laravel.com/docs/9.x/eloquent#query-scopes

Te podrá interesar
Context7 brinda documentación oficial y actualizada a asistentes de código IA, evitando errores por ejemplos obsoletos y APIs desactualizadas.
Herramientas gratuitas para desarrolladores: descubre cómo elegir, integrar y aprovechar las mejores opciones de software, diseño, colaboración y optimización para acelerar tu flujo de trabajo en 2025.
Descubre la historia de Apple Inc vs Apple Corps, la disputa legal entre los Beatles y la empresa de Steve Jobs que marcó un antes y un después en la relación entre música y tecnología.
Logo de Angel Cruz

Made with ♥️ & 🧉 in Montevideo, Uruguay Buenos Aires, Argentina.

[AC].dev is not affiliated with Laravel or Laravel LLC. Laravel is a Trademark of Taylor Otwell.

Code highlighting provided by Torchlight.