Cómo se usan los Query Scopes
Este artículo tiene más de un año de antigüedad, el contenido pudiera estar obsoleto.
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 $query12 * @return void13 */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