var exporter

مكون VarExporter

يوفر مكون VarExporter أدوات متنوعة للتعامل مع الحالة الداخلية للكائنات:

• يسمح VarExporter::export() بتصدير أي بنية بيانات PHP قابلة للتسلسل إلى كود PHP عادي. أثناء القيام بذلك، فإنه يحافظ على جميع الدلالات المرتبطة بآلية التسلسل في PHP ( __wakeup , __sleep , Serializable , __serialize , __unserialize );
• Instantiator::instantiate() بإنشاء كائن وتعيين خصائصه دون استدعاء منشئه أو أي طرق أخرى؛
• يمكن Hydrator::hydrate() ‎ تعيين خصائص كائن موجود؛
• يمكن لـ Lazy*Trait أن تجعل الفصل يتصرف كشبح كسول التحميل أو وكيل افتراضي.

فارإكسبورتر::تصدير()

السبب وراء استخدام VarExporter::export() vs 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 الرئيسي