var exporter

Komponen VarExporter

Komponen VarExporter menyediakan berbagai alat untuk menangani keadaan internal objek:

• VarExporter::export() memungkinkan mengekspor struktur data PHP apa pun yang dapat diserialkan ke kode PHP biasa. Saat melakukannya, ia mempertahankan semua semantik yang terkait dengan mekanisme serialisasi PHP ( __wakeup , __sleep , Serializable , __serialize , __unserialize );
• Instantiator::instantiate() membuat objek dan menyetel propertinya tanpa memanggil konstruktornya atau metode lainnya;
• Hydrator::hydrate() dapat mengatur properti objek yang ada;
• Lazy*Trait dapat membuat kelas berperilaku seperti hantu atau proxy virtual yang memuat lambat.

VarExporter::ekspor()

Alasan menggunakan VarExporter::export() vs serialize() atau igbinary adalah kinerja: berkat OPcache, kode yang dihasilkan jauh lebih cepat dan lebih hemat memori dibandingkan menggunakan unserialize() atau igbinary_unserialize() .

Tidak seperti var_export() , ini berfungsi pada nilai PHP apa pun yang dapat diserialkan.

Ini juga memberikan beberapa perbaikan atas var_export() / serialize() :

• outputnya kompatibel dengan PSR-2;
• outputnya dapat diindentasi ulang tanpa mengacaukan r atau n pada data;
• kelas yang hilang menampilkan ClassNotFoundException alih-alih tidak diserialisasikan ke objek PHP_Incomplete_Class ;
• referensi yang melibatkan instance SplObjectStorage , ArrayObject atau ArrayIterator dipertahankan;
• Kelas Reflection* , IteratorIterator dan RecursiveIteratorIterator mengeluarkan pengecualian ketika sedang diserialisasi (versi tidak serialnya tetap rusak, lihat https://bugs.php.net/76737).

Instansiator dan Hidrator

Instantiator::instantiate($class) membuat objek dari kelas tertentu tanpa memanggil konstruktornya atau metode lainnya.

Hydrator::hydrate() menyetel properti objek yang ada, termasuk properti pribadi dan terlindungi. Misalnya:

 // 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

Komponen ini menyediakan dua pola pemuatan lambat: objek hantu dan proksi virtual (lihat https://martinfowler.com/eaaCatalog/lazyLoad.html untuk referensi).

Objek hantu hanya berfungsi dengan kelas konkret dan non-internal. Dalam kasus umum, mereka tidak kompatibel dengan penggunaan pabrik di penginisialisasinya.

Proksi virtual bekerja dengan kelas konkret, abstrak, atau internal. Mereka menyediakan API yang terlihat seperti objek sebenarnya dan meneruskan panggilan ke objek tersebut. Mereka dapat menyebabkan masalah identitas karena proxy mungkin tidak terlihat setara dengan objek sebenarnya yang diproksinya.

Karena masalah identitas ini, objek hantu sebaiknya diutamakan jika memungkinkan. Pengecualian yang diberikan oleh kelas ProxyHelper dapat membantu memutuskan kapan kelas tersebut dapat digunakan atau tidak.

Objek hantu dan proxy virtual keduanya menyediakan implementasi untuk LazyObjectInterface yang memungkinkan pengaturan ulang ke kondisi awal atau menginisialisasi secara paksa saat diperlukan. Perhatikan bahwa menyetel ulang objek hantu akan melewatkan properti hanya-bacanya. Anda harus menggunakan proksi virtual untuk menyetel ulang properti hanya-baca.

LazyGhostTrait

Dengan menggunakan LazyGhostTrait baik secara langsung di kelas Anda atau dengan menggunakan ProxyHelper::generateLazyGhost() , Anda dapat membuat instance-nya dapat dimuat dengan lambat. Ini bekerja dengan membuat instance ini kosong dan menghitung statusnya hanya saat mengakses properti.

 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

Alternatifnya, LazyProxyTrait dapat digunakan untuk membuat proxy virtual:

 $ 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. 

Sumber daya

• Dokumentasi
• Berkontribusi
• Laporkan masalah dan kirim Permintaan Tarik di repositori utama Symfony