Guida Avanzata agli Scopes in Laravel: Ottimizza le Tue Query con Esempi Pratici

In questo tutorial, esploreremo in dettaglio gli scopes in Laravel, una funzionalità potente che consente di semplificare e riutilizzare le query nel tuo codice. Gli scopes possono migliorare notevolmente la leggibilità e la manutenibilità del tuo codice, specialmente quando lavori con query complesse. 

Cosa Sono gli Scopes in Laravel?

Gli scopes sono metodi che puoi definire nei tuoi modelli Eloquent per incapsulare una query specifica. Utilizzando gli scopes, puoi applicare facilmente condizioni comuni a più query senza dover ripetere il codice.

Tipi di Scopes

• Global Scopes: Applicati automaticamente a tutte le query su un modello.
• Local Scopes: Applicati manualmente quando necessario.

Creare uno Scope Locale

Per creare uno scope locale, puoi definire un metodo nel tuo modello. Ecco un esempio pratico:

Esempio di Scope Locale

Immagina di avere un modello User e di voler filtrare gli utenti attivi. Puoi definire uno scope come segue:

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    public function scopeActive($query)
    {
        return $query->where('active', 1);
    }
}

Utilizzo dello Scope Locale

Puoi utilizzare lo scope active nelle tue query come mostrato di seguito:

$activeUsers = User::active()->get();

Output Atteso

L'output atteso sarà un elenco di utenti che hanno il campo active impostato su 1.

Creare uno Scope Globale

Gli scopes globali sono utili quando desideri applicare una condizione a tutte le query del tuo modello. Ecco come puoi implementare uno scope globale:

Esempio di Scope Globale

Supponiamo di voler escludere gli utenti cancellati da tutte le query. Puoi creare uno scope globale come segue:

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Scope;

class UserScope implements Scope
{
    public function apply(Builder $builder, Model $model)
    {
        $builder->where('deleted_at', null);
    }
}

class User extends Model
{
    protected static function booted()
    {
        static::addGlobalScope(new UserScope);
    }
}

Utilizzo dello Scope Globale

Dopo aver definito lo scope globale, tutte le query sul modello User escluderanno automaticamente gli utenti cancellati:

$users = User::all(); // Non includerà gli utenti con deleted_at != null

Output Atteso

L'output atteso sarà un elenco di utenti che non sono stati cancellati.

Combinare Scopes Locali e Globali

Puoi combinare scopes locali e globali per ottenere query più complesse. Ad esempio, se desideri ottenere solo gli utenti attivi che non sono stati cancellati:

Esempio di Combinazione

$activeUsers = User::active()->get();

Output Atteso

L'output atteso sarà un elenco di utenti attivi che non sono stati cancellati.

Passare Parametri agli Scopes

Puoi anche passare parametri agli scopes per renderli più flessibili. Ecco un esempio:

Esempio di Scope con Parametri

public function scopeOfRole($query, $role)
{
    return $query->where('role', $role);
}

Utilizzo dello Scope con Parametri

$admins = User::ofRole('admin')->get();

Output Atteso

L'output atteso sarà un elenco di utenti con il ruolo di admin.

Per oggi è tutto!

Gli scopes in Laravel sono uno strumento potente per semplificare le tue query e migliorare la leggibilità del codice. Utilizzando scopes locali e globali, puoi gestire facilmente le condizioni comuni e riutilizzare il tuo codice in modo efficace. Ricorda di utilizzare parametri per rendere i tuoi scopes ancora più versatili. In questo tutorial, abbiamo coperto tutto ciò che c'è da sapere sugli scopes in Laravel, fornendo esempi pratici e output attesi per aiutarti a implementare questa funzionalità nel tuo progetto. Sperimenta con gli scopes e scopri come possono semplificare il tuo lavoro con Laravel!