International PHP Conference Berlin 2025

    The Volatile class

    (PECL pthreads >= 3.0.0)

    Introduction

    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 extends Threaded implements Collectable, Traversable {
    /* Inherited methods */
    public Threaded::chunk(int $size, bool $preserve): array
    public Threaded::count(): int
    public Threaded::extend(string $class): bool
    public Threaded::isRunning(): bool
    public Threaded::isTerminated(): bool
    public Threaded::merge(mixed $from, bool $overwrite = ?): bool
    public Threaded::notify(): bool
    public Threaded::notifyOne(): bool
    public Threaded::pop(): bool
    public Threaded::run(): void
    public Threaded::shift(): mixed
    public Threaded::synchronized(Closure $block, mixed ...$args): mixed
    public Threaded::wait(int $timeout = ?): bool
    }

    Examples

    Example #1 New immutability semantics of Threaded

    <?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:

    RuntimeException: Threaded members previously set to Threaded objects are immutable, cannot overwrite data in %s:%d

    Example #2 Volatile use-case

    <?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:

    object(stdClass)#3 (0) {
}

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    1
    synnus at gmail dot com
    5 years ago
    <?php

    // just use extends volatile for use array
    // is verry good

    class libvar extends Volatile
    {
    private     $_adresse = '127.0.0.1';
    private     $_port = 10000;

    public     $socket;
    public     $list_socket = array();
    public     $list_error = array();

    public function     __construct(){ }

    public function     set_list($val) { $ct = count($this->list_socket); $this->list_socket[ $ct ] = $val; return $ct; }
    public function     set_socket($val) { $this->socket = $val; return $this->socket; }
    public function     set_error($val) { $this->list_error[ count($this->list_error) ] = $val; }

    public function     unset_list($val) { unset($this->list_error[ $val ]); }

    public function     get_socketinlist($val) { return $this->list_socket[$val]; }
    public function     get_adresse() { return $this->_adresse; }
    public function     get_port() { return $this->_port; }
    public function     get_socket() { return $this->socket; }
    }

    ?>
    ＋add a note
    To Top