You are browsing a version that has not yet been released.

Partial Hydration

Creating Partial Objects through DQL was possible in ORM 2, but is only supported for array hydration as of ORM 3.

Partial hydration of entities is allowed in the array hydrator, when only a subset of the fields of an entity are loaded from the database and the nested results are still created based on the entity relationship structure.

1 <?php
$users = $em->createQuery("SELECT PARTIAL u.{id,name}, partial a.{id,street} FROM MyApp\Domain\User u JOIN u.addresses a")
            ->getArrayResult();
2
3

This is a useful optimization when you are not interested in all fields of an entity for performance reasons, for example in use-cases for exporting or rendering lots of data.

1	<?php $users = $em->createQuery("SELECT PARTIAL u.{id,name}, partial a.{id,street} FROM MyApp\Domain\User u JOIN u.addresses a") ->getArrayResult();
2
3

Maintained

Unmaintained

Partial Hydration