Cómo se usan los Query Scopes

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

Angel Cruz's avatar
Autor
Angel Cruz