summaryrefslogtreecommitdiffstats
path: root/vendor/doctrine/collections/docs/en/lazy-collections.rst
blob: b9cafb60bf6352a3ec37065c290c676e51b53239 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
Lazy Collections
================

To create a lazy collection you can extend the
``Doctrine\Common\Collections\AbstractLazyCollection`` class
and define the ``doInitialize`` method. Here is an example where
we lazily query the database for a collection of user records:

.. code-block:: php
    use Doctrine\DBAL\Connection;

    class UsersLazyCollection extends AbstractLazyCollection
    {
        /** @var Connection */
        private $connection;

        public function __construct(Connection $connection)
        {
            $this->connection = $connection;
        }

        protected function doInitialize() : void
        {
            $this->collection = $this->connection->fetchAll('SELECT * FROM users');
        }
    }