2.0 KiB
SerizableVolatile
Licensed under AGLPV3, created by Daniil Gentili (https://daniil.it).
This library allows you to serialize classes that extend pthreads's Volatile or Threaded classes (support for other internal classes can be easily added).
It also allows provides reverse and forward compatibility between old serializations, where your objects do not yet extend Threaded/Volatile, and new serializations, where they do extend them.
Usage of this library is extremely simple, here are a few examples (see a.php and b.php for more):
<?php
class a
{
public function __construct() {
var_dump("Constructed!");
$this->a = 'pony';
}
public function __wakeup() {
var_dump($this->a);
}
}
$a = new a;
file_put_contents('test', serialize($a));
As you can see, here a does not extend any class, and we are serializing an instance of it tothe file test.
This example also prints Constructed!, since the constructor function, __construct, is called.
<?php
class a extends \danog\SerializableVolatile
{
public function ___construct() {
var_dump("Constructed!");
$this->a = 'pony';
}
public function __wakeup() {
var_dump($this->a);
}
}
$a = \danog\Serialization::unserialize(file_get_contents('test'));
var_dump($a);
$othera = new a;
This will deserialize correctly the contents of test, recreating the instance of a, with the only difference that now it will be thread safe.
Of course, the wakeup function will be called, so pony will be printed.
You may have noticed that the construct function is now called ___construct instead of __construct: this is a required change, or else this library will not work.
Of course, when a will be instantiated, the new constructor function will be called anyway (and you'll see the message Constructed! pop up).
If you try to serialize either $a or $othera and deserialize it from the first script (where a does not extend any other class), you will find that it will be deserialized correctly.