var exporter

VarExporter 組件

VarExporter 元件提供了各種工具來處理物件的內部狀態：

• VarExporter::export()允許將任何可序列化的 PHP 資料結構匯出為純 PHP 程式碼。在這樣做的同時，它保留了與 PHP 序列化機制相關的所有語意（ __wakeup 、 __sleep 、 Serializable 、 __serialize 、 __unserialize ）；
• Instantiator::instantiate()建立一個物件並設定其屬性，而不呼叫其建構函式或任何其他方法；
• Hydrator::hydrate()可以設定現有物件的屬性；
• Lazy*Trait可以使類別充當延遲載入幽靈或虛擬代理。

VarExporter::導出()

使用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類別拋出的異常可以幫助決定何時可以使用它。

Ghost 物件和虛擬代理程式都提供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 儲存庫中傳送 Pull 請求