Lazy Objects in PHP and Symfony

Transcript

1. Revisiting lazy objects in PHP and Symfony @nicolasgrekas
2. Lazy Loading Don't do anything unless really needed
3. Lazy Loading Can save time and memory Perfect for short-lived requests Allows creating circular object graphs (Provides resetting for free)
4. The 4 kinds of Lazy Loading • Lazy Initialization • Value holders • Virtual proxies • Ghost objects
5. Lazy Initialization Check properties for a marker value (usually null) and load them on demand
6. class LazyInitializedClass { public function getData() { return $this->data ??= $this->doGetData(); }
7. Lazy Initialization The implementation is laziness-aware
8. Value Holders An object with a public getValue() method
9. class ClosureHolder { public function __construct( private Closure|string $value ) { } public function getValue(): string { if ($this->value instanceof Closure) { $this->value = ($this->value)(); } return $this->value; }
10. class LocatorHolder { public function __construct( #[AutowireLocator('workflow', 'name')] private ContainerInterface $workflows ) { } public function getWorkflow(string $name) { return $this->workflows->get($name); }
11. class IterableHolder { public function __construct( #[AutowireIterator('workflow')] private iterable $workflows ) { } public function getWorkflows(): Generator { foreach ($this->workflows as $workflow) { yield $workflow; } }
12. Value Holders The consumers are laziness-aware
13. Virtual Proxies An object with the same interface as the real object The real object is created just-in-time
14. class EntityManager implements EntityManagerInterface { //... public function find(string $class, $id) { //... }
15. class VirtualChildEntityManager extends EntityManager { private parent $em; private bool $isInitialized = false; public function __construct( private Closure $initializer ) { } public function find(string $class, $id) { if (!$this->isInitialized) { ($this->initializer)($this); } return $this->em->find($class, $id); }
16. class VirtualProxyEntityManager implements EntityManagerInterface { private EntityManagerInterface $em; private bool $isInitialized = false; public function __construct( private Closure $initializer ) { } public function find(string $class, $id) { if (!$this->isInitialized) { ($this->initializer)($this); } return $this->em->find($class, $id); }
17. Virtual Proxies Neither the consumers nor the real object are laziness-aware Do work with final classes Can cause identity issues aka break fluent/wither APIs
18. #[Autoconfigure(lazy: true)] class EntityManager implements EntityManagerInterface { //...
19. #[Autoconfigure(lazy: EntityManagerInterface::class)] class EntityManager implements EntityManagerInterface { //...
20. Ghost Objects The real object without any data The first time any methods are called, the ghost populates its state
21. class GhostEntityManager extends EntityManager { public function __construct( private Closure $initializer ) { unset(/* all properties defined by the parent */); } public function __get($name) { // initialize all parent properties } // ...
22. namespace Proxies\__CG__\App\Entity; use Doctrine\Persistence\Proxy; /** * DO NOT EDIT THIS FILE - IT WAS CREATED BY DOCTRINE'S PROXY GENERATOR */ class Conference extends \App\Entity\Conference implements Proxy { use \Symfony\Component\VarExporter\LazyGhostTrait
23. Ghost Objects Neither the consumers nor the real object are laziness-aware Don't work with final classes Work with final methods Don't cause identity issues aka work with fluent/wither APIs
24. Virtual State Proxies Proxy the properties not the methods
25. class VirtualEntityManager extends EntityManager { private parent $em; public function __construct( private Closure $initializer ) { unset(/* all properties defined by the parent */); } public function __get($name) { $this->em ??= ($this->initializer)($this); return $this->em->$name; }
26. Virtual State Proxies Neither the consumers nor the real object are laziness-aware Don't work with final classes Work with final methods Don't cause identity issues aka work with fluent/wither APIs
27. Native Lazy Objects RFC pending
28. class ReflectionClass { [...] public int const SKIP_INITIALIZATION_ON_SERIALIZE = 1; public int const SKIP_DESTRUCTOR = 2; public function newLazyGhost(callable $initializer, int $options = 0): object; public function newLazyProxy(callable $factory, int $options = 0): object; public function resetAsLazyGhost(object $object, callable $initializer, int $options = 0): void; public function resetAsLazyProxy(object $object, callable $factory, int $options = 0): void; public function isUninitializedLazyObject(object $instance): bool; [...]
29. class ReflectionClass { [...] /** * Initializes a lazy object (no-op if the object is already initialized.) * * The backing object is returned, which can be another instance than the lazy object when the virtual strategy is used. */ public function initializeLazyObject(object $object): object; public function isUninitializedLazyObject(object $object): object; public function markLazyObjectAsInitialized(object $object): void; public function getLazyInitializer(object $object): ?callable; }
30. class ReflectionProperty { [...] /** * Marks a property as *not* triggering initialization when being accessed. */ public function skipLazyInitialization(object $object): void; /** * Sets a property *without* triggering initialization while skipping hooks if any. */ public function setRawValueWithoutLazyInitialization(object $object, mixed $value): void; }
31. Native Lazy Objects Neither the consumers nor the real object are laziness-aware Do work with final classes Does works with fluent/wither APIs Stellar performance
32. TL;DR github.com/sponsors/nicolas-grekas symfony.com/sponsor opencollective.com/phpfoundation The heavy lifting is done for you Be creative
33. Thank you! @nicolasgrekas See you in Vienna! live.symfony.com