The Volatile class
Guide
Edit on GitHub ✎
The Volatile class is new to pthreads v3. Its introduction is a consequence of the new immutability semantics of Threaded members of Threaded classes. The Volatile class enables for mutability of its Threaded members, and is also used to store PHP arrays in Threaded contexts.
Intro
The Volatile class is new to pthreads v3. Its introduction is a consequence of the new immutability semantics of Threaded members of Threaded classes. The Volatile class enables for mutability of its Threaded members, and is also used to store PHP arrays in Threaded contexts.
Class synopsis
class Volatile { }
Examples
New immutability semantics of Threaded
php
<?php
class Task extends Threaded
{
public function __construct()
{
$this->data = new Threaded();
// attempt to overwrite a Threaded property of a Threaded class (invalid)
$this->data = new stdClass();
}
}
var_dump((new Task())->data);The above example will output something similar to:
output
RuntimeException: Threaded members previously set to Threaded objects are immutable, cannot overwrite data in %s:%dVolatile use-case
php
<?php
class Task extends Volatile
{
public function __construct()
{
$this->data = new Threaded();
// attempt to overwrite a Threaded property of a Volatile class (valid)
$this->data = new stdClass();
}
}
var_dump((new Task())->data);The above example will output something similar to:
output
object(stdClass)#3 (0) {
}