Интерфейс ArrayAccess

(PHP 5, PHP 7, PHP 8)

Введение

Интерфейс разрешает обращаться к объектам как к массивам.

Обзор интерфейса

interface ArrayAccess {

/* Методы */

public offsetExists(mixed $offset): bool

public offsetGet(mixed $offset): mixed

public offsetSet(mixed $offset, mixed $value): void

public offsetUnset(mixed $offset): void

}

Примеры

Пример #1 Основы использования

<?php
class Obj implements ArrayAccess {
    public $container = [
        "one"   => 1,
        "two"   => 2,
        "three" => 3,
    ];

    public function offsetSet($offset, $value): void {
        if (is_null($offset)) {
            $this->container[] = $value;
        } else {
            $this->container[$offset] = $value;
        }
    }

    public function offsetExists($offset): bool {
        return isset($this->container[$offset]);
    }

    public function offsetUnset($offset): void {
        unset($this->container[$offset]);
    }

    public function offsetGet($offset): mixed {
        return isset($this->container[$offset]) ? $this->container[$offset] : null;
    }
}

$obj = new Obj;

var_dump(isset($obj["two"]));
var_dump($obj["two"]);
unset($obj["two"]);
var_dump(isset($obj["two"]));
$obj["two"] = "A value";
var_dump($obj["two"]);
$obj[] = 'Append 1';
$obj[] = 'Append 2';
$obj[] = 'Append 3';
print_r($obj);
?>

Вывод приведённого примера будет похож на:

bool(true)
int(2)
bool(false)
string(7) "A value"
obj Object
(
    [container:obj:private] => Array
        (
            [one] => 1
            [three] => 3
            [two] => A value
            [0] => Append 1
            [1] => Append 2
            [2] => Append 3
        )

)

Содержание

ArrayAccess::offsetExists — Определяет, существует ли заданное смещение (ключ)
ArrayAccess::offsetGet — Возвращает заданное смещение (ключ)
ArrayAccess::offsetSet — Присваивает значение заданному смещению
ArrayAccess::offsetUnset — Удаляет смещение