var exporter

ส่วนประกอบ VarExporter

ส่วนประกอบ VarExporter มีเครื่องมือต่างๆ เพื่อจัดการกับสถานะภายในของออบเจ็กต์:

• VarExporter::export() อนุญาตให้ส่งออกโครงสร้างข้อมูล PHP ที่สามารถซีเรียลไลซ์ได้ไปยังโค้ด PHP ธรรมดา ในขณะที่ทำเช่นนั้น มันจะรักษาความหมายทั้งหมดที่เกี่ยวข้องกับกลไกการทำให้เป็นอนุกรมของ PHP ( __wakeup , __sleep , Serializable , __serialize , __unserialize );
• Instantiator::instantiate() สร้างวัตถุและตั้งค่าคุณสมบัติโดยไม่ต้องเรียกตัวสร้างหรือวิธีอื่นใด
• Hydrator::hydrate() สามารถกำหนดคุณสมบัติของวัตถุที่มีอยู่ได้
• Lazy*Trait สามารถทำให้คลาสทำงานเป็น ghost-loading ghost หรือพร็อกซีเสมือนได้

VarExporter::ส่งออก()

เหตุผลในการใช้ VarExporter::export() vs serialize() หรือ igbinary คือประสิทธิภาพ: ต้องขอบคุณ OPcache โค้ดที่ได้จึงเร็วกว่าอย่างเห็นได้ชัด และมีประสิทธิภาพหน่วยความจำมากกว่าการใช้ unserialize() หรือ igbinary_unserialize()

ต่างจาก var_export() ตรงที่ใช้ได้กับค่า PHP ที่สามารถซีเรียลไลซ์ได้

นอกจากนี้ยังมีการปรับปรุงเล็กน้อยเหนือ var_export() / serialize() :

• เอาต์พุตเข้ากันได้กับ PSR-2;
• เอาต์พุตสามารถเยื้องใหม่ได้โดยไม่รบกวน r หรือ n ในข้อมูล
• คลาสที่ขาดหายไปจะส่ง ClassNotFoundException แทนที่จะถูกยกเลิกซีเรียล ClassNotFoundException เป็นวัตถุ PHP_Incomplete_Class
• การอ้างอิงที่เกี่ยวข้องกับอินสแตนซ์ SplObjectStorage , ArrayObject หรือ ArrayIterator จะถูกเก็บรักษาไว้
• คลาส Reflection* , IteratorIterator และ RecursiveIteratorIterator มีข้อยกเว้นเมื่อมีการทำให้เป็นอนุกรม (เวอร์ชันที่ไม่ซีเรียลไลซ์นั้นใช้งานไม่ได้อยู่แล้ว ดู https://bugs.php.net/76737)

อินสแตนติเอเตอร์และไฮเดรเตอร์

Instantiator::instantiate($class) สร้างวัตถุของคลาสที่กำหนดโดยไม่ต้องเรียก Constructor หรือวิธีการอื่นใด

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

ส่วนประกอบนี้มีรูปแบบการโหลดแบบ Lazy Loading สองรูปแบบ: อ็อบเจ็กต์โกสต์และพรอกซีเสมือน (ดู https://martinfowler.com/eaaCatalog/lazyLoad.html สำหรับการอ้างอิง)

วัตถุ Ghost ใช้งานได้กับคลาสที่เป็นรูปธรรมและไม่ใช่ภายในเท่านั้น ในกรณีทั่วไป พวกเขาเข้ากันไม่ได้กับการใช้โรงงานในเครื่องมือเริ่มต้น

พร็อกซีเสมือนใช้งานได้กับคลาสที่เป็นรูปธรรม นามธรรม หรือภายใน พวกเขาจัดเตรียม API ที่ดูเหมือนวัตถุจริงและโอนสายไปยังวัตถุเหล่านั้น สิ่งเหล่านี้อาจทำให้เกิดปัญหาเกี่ยวกับข้อมูลประจำตัวได้เนื่องจากพรอกซีอาจไม่ถูกมองว่าเทียบเท่ากับออบเจ็กต์จริงที่พร็อกซีเหล่านั้น

เนื่องจากปัญหาเอกลักษณ์นี้ จึงควรเลือกใช้วัตถุโกสต์เมื่อเป็นไปได้ ข้อยกเว้นที่เกิดจากคลาส ProxyHelper สามารถช่วยตัดสินใจว่าจะสามารถใช้งานได้เมื่อใด

อ็อบเจ็กต์ Ghost และพร็อกซีเสมือนจัดให้มีการใช้งานสำหรับ LazyObjectInterface ซึ่งช่วยให้สามารถรีเซ็ตเป็นสถานะเริ่มต้นหรือบังคับให้เริ่มต้นเมื่อจำเป็น โปรดทราบว่าการรีเซ็ตวัตถุโกสต์จะข้ามคุณสมบัติอ่านอย่างเดียว คุณควรใช้พร็อกซีเสมือนเพื่อรีเซ็ตคุณสมบัติแบบอ่านอย่างเดียว

LazyGhostTrait

ด้วยการใช้ LazyGhostTrait โดยตรงในคลาสของคุณหรือโดยใช้ ProxyHelper::generateLazyGhost() คุณสามารถทำให้อินสแตนซ์ของ Lazy Loadable ได้ ซึ่งทำงานโดยการสร้างอินสแตนซ์เหล่านี้ว่างเปล่าและโดยการคำนวณสถานะเมื่อเข้าถึงคุณสมบัติเท่านั้น

 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. 

ทรัพยากร

• เอกสารประกอบ
• มีส่วนร่วม
• รายงานปัญหาและส่ง Pull Requests ในพื้นที่เก็บข้อมูลหลักของ Symfony