Registrati 
Accedi 
- Cosa sono i Cursor in Laravel
- Quando usare i Cursor con Laravel
- Requisiti e prerequisiti
- Come funziona il metodo cursor()
- Differenze tra cursor(), get() e chunk()
- Vantaggi dell’uso di cursor()
- Limiti e considerazioni sull’uso dei cursor
- Best practice per l’utilizzo di cursor()
- Esempio pratico: esportare dati in CSV usando i cursori
- Cursor e relazioni Eloquent
- Cursor nei job e nei comandi Artisan
- Cursor e paginazione
- Quando NON usare i cursor
- Risorse utili
- Conclusione
Laravel è uno dei framework PHP più popolari grazie alla sua architettura elegante, flessibilità e all’ampia gamma di strumenti pronti all’uso. Quando si tratta di lavorare con grandi volumi di dati provenienti dal database, una delle sfide principali è gestire le performance e l’utilizzo della memoria. In questo contesto, il metodo cursor() di Laravel si rivela uno strumento estremamente utile. In questo articolo approfondiremo come utilizzare i cursori con Laravel, quando è opportuno farlo, i vantaggi e le best practice per ottenere il massimo da questa funzionalità.
Cosa sono i Cursor in Laravel
Un cursor permette di gestire grandi quantità di dati senza doverli caricare tutti in memoria contemporaneamente. Al contrario, i record vengono recuperati uno alla volta direttamente dal database, riducendo drasticamente il consumo di memoria dell’applicazione.
Laravel implementa questa funzionalità grazie al metodo cursor() sulle query Eloquent e sul Query Builder. Utilizzando i cursori, si ottiene un oggetto Generator PHP che consente di iterare i risultati in modo efficiente.
Quando usare i Cursor con Laravel
I cursori sono particolarmente utili quando:
- Si devono processare grandi quantità di record (decine di migliaia o più);
- Il caricamento in massa dei dati porterebbe a errori di memoria insufficienti (Out of memory);
- Si desidera processare i dati in maniera sequenziale e non è necessario avere tutti i record disponibili contemporaneamente.
Non è consigliato utilizzare i cursori quando si devono applicare operazioni che richiedono la presenza di tutti i dati in memoria, come ordinamenti complessi, raggruppamenti o aggregazioni che coinvolgono tutti i record.
Requisiti e prerequisiti
- Installazione di Laravel (dalla versione 5.3 in poi);
- Database supportato da Laravel (MySQL, PostgreSQL, SQLite, SQL Server);
- Conoscenza di base delle query Eloquent o del Query Builder.
Come funziona il metodo cursor()
Il metodo cursor() restituisce un generatore PHP, che consente di ciclare sui risultati della query uno alla volta. Vediamo un esempio pratico di utilizzo con Eloquent:
$users = User::where('active', 1)->cursor();
foreach ($users as $user) {
// Operazioni sui singoli utenti
}
A differenza di get(), che recupera tutti i record e li restituisce come una collezione, cursor() li recupera uno alla volta, risparmiando memoria.
Utilizzo con Query Builder
Anche il Query Builder permette di utilizzare cursor():
$results = DB::table('products')->where('stock', '>', 0)->cursor();
foreach ($results as $product) {
// Elaborazione del prodotto
}
Differenze tra cursor(), get() e chunk()
È importante comprendere la differenza tra i tre metodi principali per recuperare i dati:
- get(): Recupera tutti i record e li memorizza in una collezione. Può causare problemi di memoria con dataset molto grandi.
- chunk(): Recupera i dati in blocchi di una dimensione specificata. Ogni blocco viene processato e poi liberato dalla memoria prima che venga letto il successivo.
- cursor(): Recupera un record alla volta, ottimizzando al massimo il consumo di memoria.
Esempio di uso di chunk():
User::chunk(100, function ($users) {
foreach ($users as $user) {
// Elaborazione
}
});
Vantaggi dell’uso di cursor()
- Efficienza della memoria: Rende possibile processare milioni di record senza saturare la RAM.
- Performance costante: La velocità di esecuzione non degrada con la crescita del dataset.
- Facilità di utilizzo: La sintassi è simile a quella delle normali query Eloquent.
- Lazy Loading: I dati vengono caricati solo quando servono.
Limiti e considerazioni sull’uso dei cursor
- Transazioni: Quando si utilizza cursor(), la connessione al database rimane aperta per tutta la durata dell’iterazione. Evita di bloccare la connessione troppo a lungo in ambienti con molte richieste concorrenti.
- Modifica dei dati durante l’iterazione: Evita di aggiornare o cancellare i record mentre si stanno scorrendo con il cursore, per non incorrere in incongruenze.
- Ordinamenti complessi: I cursori funzionano meglio con query ordinate in modo semplice, preferibilmente tramite indici su colonne primarie.
Best practice per l’utilizzo di cursor()
- Chiudi la connessione quando non serve: Se devi eseguire altre query durante l’iterazione, valuta l’uso di DB::disconnect() per liberare la connessione.
- Evita query pesanti: Filtra il più possibile i dati a livello di query, riducendo il carico sulla memoria e sul database.
- Usa gli indici: Assicurati che le colonne usate nei filtri e negli ordinamenti siano indicizzate.
- Gestisci eventuali memory leaks: Se devi processare oggetti esterni o risorse, ricordati di chiuderle o liberarle durante il ciclo.
Esempio pratico: esportare dati in CSV usando i cursori
Supponiamo di dover esportare una tabella utenti molto grande in un file CSV senza saturare la RAM. Ecco un esempio di implementazione:
use IlluminateSupportFacadesDB;
$users = DB::table('users')->cursor();
$handle = fopen('php://output', 'w');
fputcsv($handle, ['ID', 'Nome', 'Email']);
foreach ($users as $user) {
fputcsv($handle, [$user->id, $user->name, $user->email]);
}
fclose($handle);
Questo approccio permette di esportare milioni di righe in modo efficiente, senza mai superare i limiti di memoria del server.
Cursor e relazioni Eloquent
Quando si utilizzano i cursori con Eloquent, le relazioni (relationships) vengono caricate in modo “lazy”, cioè solo quando vengono realmente utilizzate. Se hai bisogno di accedere frequentemente a relazioni durante l’iterazione, valuta l’uso di eager loading tramite with():
$posts = Post::with('author')->cursor();
foreach ($posts as $post) {
echo $post->author->name;
}
Tuttavia, attenzione: l’eager loading con cursor() può aumentare il numero di query eseguite (N+1 problem), quindi valuta bene l’impatto sulle performance.
Cursor nei job e nei comandi Artisan
I cursori sono particolarmente utili nei job in background e nei comandi Artisan, dove si elaborano grandi volumi di dati senza limiti di timeout HTTP. Esempio tipico: invio massivo di email agli utenti attivi.
public function handle()
{
$users = User::where('active', 1)->cursor();
foreach ($users as $user) {
Mail::to($user->email)->send(new Newsletter());
}
}
Cursor e paginazione
I cursori non sono pensati per la paginazione classica, ma Laravel offre un altro metodo chiamato cursorPaginate() (introdotto in Laravel 8), utile per la paginazione efficiente su grandi dataset. Consulta la documentazione ufficiale per maggiori dettagli.
Quando NON usare i cursor
- Quando hai bisogno di tutti i dati in memoria per ordinamenti o aggregazioni complesse;
- Quando il dataset è piccolo (pochi centinaia di record);
- Quando il ciclo di vita dell’iterazione deve essere molto rapido (i cursori possono essere leggermente più lenti delle collezioni in memoria, a causa delle letture continue dal database).
Risorse utili
Conclusione
L’uso dei cursori in Laravel rappresenta una soluzione efficace per la gestione di grandi volumi di dati. Grazie al metodo cursor(), è possibile iterare record uno alla volta, mantenendo basso il consumo di memoria e garantendo performance costanti anche su dataset molto ampi. È fondamentale conoscere le differenze tra get(), chunk() e cursor(), scegliere il metodo più adatto a seconda dello scenario e applicare le best practice descritte.
Per progetti che richiedono l’elaborazione di grandi quantità di dati, approfondire l’uso dei cursori permette di ottimizzare le performance e migliorare la scalabilità della propria applicazione Laravel.
