Get "PHP 8 in a Nuthshell" (Now comes with PHP 8.3)
Amit Merchant

Amit Merchant

A blog on PHP, JavaScript, and more

Using Lazy Collections on memory-hungry operations in Laravel 6

Laravel team has recently released v6.0 of the framework and with this they have added a bunch of exciting new features. Among which, I’m going to talk about Lazy Collections in this article. In Laravel, Illuminate\Support\Collection class provides a fluent, convenient wrapper for working with arrays of data. In face, all the Eloquent queries are always returned as Collection instances. LazyCollection essentially extends the features of the Collection class. Let’s talk about them in detail.

What is LazyCollection?

LazyCollection class is like Illuminate\Support\Collection class only but with added sugar to it. The class basically utilizes PHP generators to allow you to work with very large datasets while keeping memory usage low. If you’re not aware of generators, you can check out this article where I’ve explained generators in detail.

You may also like: A deep dive into Generators in PHP

Basically, Generators are like the normal functions in PHP but instead of returning a value, they yields as many values as it needs to. So, whichever function that contains “yield” is a generator. It’s like returning the value from a function in “realtime” and you don’t need to maintain the state of the values in the function itself. And once there are no more values to be yielded, then the generator can simply exit, and the calling code continues just as if an array has run out of values.

LazyCollection leverages this behaviour of generators in order to keep the memory low while working with large datasets efficiently. Quoting the example from the Laravel documentation, you can use LazyCollection in situations where you need to process really big files while preventing out-of-the-memory warning. Here, we can parse, let’s say for example a really big log file, using LazyCollection in conjunction with the traditional Collection class. Here, Instead of reading the entire file into memory at once, lazy collections may be used to keep only a small part of the file in memory at a given time.

use App\LogEntry;
use Illuminate\Support\LazyCollection;

LazyCollection::make(function () {
    $handle = fopen('log.txt', 'r');

    while (($line = fgets($handle)) !== false) {
        yield $line;
})->chunk(4)->map(function ($lines) {
    return LogEntry::fromLines($lines);
})->each(function (LogEntry $logEntry) {
    // Process the log entry...

As you can see above, LazyCollection::make is where we’ve written the logic of reading the line of the file. Notice, the anonymous function we’ve passed to make is a generator which “yields” the line(and will return a Generator object which is iterable using regular loops) to the next collection chunk method and from there onwards it’d get processed into the each collection method ultimately.

Using LazyCollection on Eloquent models

We can use the query builder’s cursor on the model instance which basically returns a LazyCollection instance. Let’s check the cursor method implementation.

public function cursor()
    if (is_null($this->columns)) {
        $this->columns = ['*'];

    return new LazyCollection(function () {
        yield from $this->connection->cursor(
            $this->toSql(), $this->getBindings(), ! $this->useWritePdo

As you can see, returning a LazyCollection will allow us to treat the result of a cursor the same way as a regular Collection instance. This allows us to still only run a single query against the database but also only keep one Eloquent model loaded in memory at a time. Take below for example.

$users = App\User::cursor()->filter(function ($user) {
    return $user->id > 500;

foreach ($users as $user) {
    echo $user->id;

As you can see, in this example, the filter callback is not executed until we actually iterate over each user individually, allowing for a drastic reduction in memory usage.

Learn the fundamentals of PHP 8 (including 8.1, 8.2, and 8.3), the latest version of PHP, and how to use it today with my new book PHP 8 in a Nutshell. It's a no-fluff and easy-to-digest guide to the latest features and nitty-gritty details of PHP 8. So, if you're looking for a quick and easy way to PHP 8, this is the book for you.

Like this article? Consider leaving a


👋 Hi there! I'm Amit. I write articles about all things web development. You can become a sponsor on my blog to help me continue my writing journey and get your brand in front of thousands of eyes.