var exporter

Компонент VarExporter

Компонент VarExporter предоставляет различные инструменты для работы с внутренним состоянием объектов:

• VarExporter::export() позволяет экспортировать любую сериализуемую структуру данных PHP в простой код PHP. При этом он сохраняет всю семантику, связанную с механизмом сериализации PHP ( __wakeup , __sleep , Serializable , __serialize , __unserialize );
• Instantiator::instantiate() создает объект и устанавливает его свойства без вызова его конструктора или каких-либо других методов;
• Hydrator::hydrate() может устанавливать свойства существующего объекта;
• Lazy*Trait может заставить класс вести себя как призрак с отложенной загрузкой или виртуальный прокси.

VarExporter::export()

Причиной использования VarExporter::export() вместо serialize() или igbinary является производительность: благодаря OPcache результирующий код работает значительно быстрее и эффективнее использует память, чем использование unserialize() или igbinary_unserialize() .

В отличие от var_export() , это работает с любым сериализуемым значением PHP.

Он также предоставляет несколько улучшений по сравнению с var_export() / serialize() :

• выход совместим с PSR-2;
• вывод можно изменить, не испортив r или n в данных;
• отсутствующие классы вызывают исключение ClassNotFoundException вместо десериализации в объекты PHP_Incomplete_Class ;
• ссылки, включающие экземпляры SplObjectStorage , ArrayObject или ArrayIterator , сохраняются;
• Классы Reflection* , IteratorIterator и RecursiveIteratorIterator выдают исключение при сериализации (их несериализованная версия все равно не работает, см. https://bugs.php.net/76737).

Инстанциатор и Гидратор

Instantiator::instantiate($class) создает объект данного класса без вызова его конструктора или каких-либо других методов.

Hydrator::hydrate() устанавливает свойства существующего объекта, включая частные и защищенные. Например:

 // Sets the public or protected $object->propertyName property
Hydrator:: hydrate ( $ object , [ ' propertyName ' => $ propertyValue ]);

// Sets a private property defined on its parent Bar class:
Hydrator:: hydrate ( $ object , [ " Bar  privateBarProperty " => $ propertyValue ]);

// Alternative way to set the private $object->privateBarProperty property
Hydrator:: hydrate ( $ object , [], [
    Bar::class => [ ' privateBarProperty ' => $ propertyValue ],
]);

Lazy*Trait

Компонент предоставляет два шаблона отложенной загрузки: объекты-призраки и виртуальные прокси (см. https://martinfowler.com/eaaCatalog/lazyLoad.html для справки).

Объекты-призраки работают только с конкретными и не внутренними классами. В общем случае они несовместимы с использованием фабрик в своем инициализаторе.

Виртуальные прокси работают с конкретными, абстрактными или внутренними классами. Они предоставляют API, который выглядит как настоящие объекты, и пересылают к ним вызовы. Они могут вызвать проблемы с идентификацией, поскольку прокси могут не рассматриваться как эквиваленты реальных объектов, которые они прокси.

Из-за этой проблемы с идентичностью, когда это возможно, следует отдавать предпочтение объектам-призракам. Исключения, создаваемые классом ProxyHelper могут помочь решить, можно ли его использовать или нет.

Объекты-призраки и виртуальные прокси предоставляют реализацию LazyObjectInterface , которая позволяет сбрасывать их в исходное состояние или принудительно инициализировать при необходимости. Обратите внимание, что сброс объекта-призрака пропускает его свойства, доступные только для чтения. Вам следует использовать виртуальный прокси-сервер для сброса свойств, доступных только для чтения.

LazyGhostTrait

Используя LazyGhostTrait непосредственно в ваших классах или с помощью ProxyHelper::generateLazyGhost() , вы можете сделать их экземпляры загружаемыми отложенно. Это работает, создавая пустые экземпляры и вычисляя их состояние только при доступе к свойству.

 class FooLazyGhost extends Foo
{
    use LazyGhostTrait;
}

$ foo = FooLazyGhost:: createLazyGhost (initializer: function ( Foo $ instance ): void {
    // [...] Use whatever heavy logic you need here
    // to compute the $dependencies of the $instance
    $ instance -> __construct (... $ dependencies );
    // [...] Call setters, etc. if needed
});

// $foo is now a lazy-loading ghost object. The initializer will
// be called only when and if a *property* is accessed.

LazyProxyTrait

Альтернативно, LazyProxyTrait можно использовать для создания виртуальных прокси:

 $ proxyCode = ProxyHelper:: generateLazyProxy ( new ReflectionClass (Foo::class));
// $proxyCode contains the reference to LazyProxyTrait
// and should be dumped into a file in production envs
eval ( ' class FooLazyProxy ' . $ proxyCode );

$ foo = FooLazyProxy:: createLazyProxy (initializer: function (): Foo {
    // [...] Use whatever heavy logic you need here
    // to compute the $dependencies of the $instance
    $ instance = new Foo (... $ dependencies );
    // [...] Call setters, etc. if needed

    return $ instance ;
});
// $foo is now a lazy-loading virtual proxy object. The initializer will
// be called only when and if a *method* is called. 

Ресурсы

• Документация
• Содействие
• Сообщайте о проблемах и отправляйте запросы на включение в основной репозиторий Symfony.