PHP: полный мануал с примерами, функциями и ООП

<?php
try { new WeakReference(); }
catch (Error $error) { echo "Используйте create\n"; }

Используйте create

Сигнатура конструктора присутствует в справочнике, чтобы объяснить запрет, а не предложить рабочий способ создания.

<?php
$product = new stdClass();
$weak = WeakReference::create($product);
echo $weak->get() === $product ? "Наблюдаем этот товар\n" : "Нет объекта\n";

Наблюдаем этот товар

Статический create вызывается через имя класса и возвращает объект WeakReference. Обычный конструктор создавать вручную не нужно.

<?php
$product = new stdClass();
$first = WeakReference::create($product);
$second = WeakReference::create($product);
var_dump($first === $second);

bool(true)

Не используйте два вызова create как способ получить два независимых контейнера настроек: для одной цели PHP возвращает тот же наблюдатель.

<?php
declare(strict_types=1);

$lost = WeakReference::create((object) ['title' => 'Чай']);
echo $lost->get() === null ? "Карточка сразу освободилась: владельца нет\n" : "Карточка доступна\n";
$product = (object) ['title' => 'Кофе'];
$owned = WeakReference::create($product);
echo 'Владелец сохранил: ', $owned->get()->title, "\n";

Карточка сразу освободилась: владельца нет
Владелец сохранил: Кофе

В первом выражении никто не сохраняет обычную связь с новым объектом. WeakReference не становится владельцем, поэтому наблюдать больше нечего. Во втором product держит карточку живой. Это практическая причина создавать владельца отдельно от наблюдателя.

<?php
$window = (object) ['title' => 'Заказы'];
$weak = WeakReference::create($window);
$live = $weak->get();
if ($live !== null) { echo $live->title, "\n"; }
unset($live, $window);
var_dump($weak->get());

Заказы
NULL

Так можно обновить ещё существующую модель экрана/подписчика. Если действие обязано случиться даже после закрытия цели, слабая ссылка для него не подходит.

<?php
$subscriber = (object) ['name' => 'Отчёт'];
$weak = WeakReference::create($subscriber);
unset($subscriber);
$live = $weak->get();
echo $live === null ? "Подписчик завершён\n" : "Можно уведомить\n";

Подписчик завершён

Не обещайте тип object там, где get может вернуть null. Верный договор вашей обёртки — ?object либо явное исключение с понятным смыслом.

<?php
$product = new stdClass();
$map = new WeakMap();
$map->offsetSet($product, 'Черновик');
$map[$product] = 'Готово';
echo $map[$product], ': ', count($map), "\n";

Готово: 1

Строка и метод — два синтаксических способа одной операции. Повторное присваивание не создаёт ещё один экземпляр ключа.

<?php
$product = (object) ['sku' => 'A-10'];
$map = new WeakMap();
$map[$product] = ['label' => 'Товар ' . $product->sku];
echo $map[$product]['label'], "\n";
unset($product);
echo count($map), "\n";

Товар A-10
0

Значение содержит строку, без обратной ссылки на товар. Если сохранить туда сам $product или замыкание, которое его захватило, карта может удержать ключ через значение.

<?php
$product = new stdClass();
$other = new stdClass();
$map = new WeakMap();
$map[$product] = 900;
echo $map->offsetGet($product), "\n";
try { $map->offsetGet($other); }
catch (Error $error) { echo "Сначала вычислите значение\n"; }

900
Сначала вычислите значение

Для ожидаемого отсутствия удобнее заранее проверять наличие. Не подавляйте все Error приложения: перехват здесь узкий и демонстрирует конкретный контракт.

<?php
$product = new stdClass();
$map = new WeakMap();
$map[$product] = ['views' => 1];
$map[$product]['views']++;
echo $map[$product]['views'], "\n";

2

WeakMap поддерживает такое изменение существующей записи через скобки. Это не общее обещание для всех пользовательских ArrayAccess: контракт их offsetGet может отличаться. При проектировании своей коллекции этот нюанс нужно проверять отдельно.

<?php
declare(strict_types=1);

$product = (object) ['title' => 'Чай'];
$prices = new WeakMap();
$prices[$product] = null;
echo 'Записей проверки цены: ', count($prices), "\n";
echo $prices->offsetExists($product) ? "Есть ненулевой результат\n" : "Ненулевого результата нет\n";
echo $prices->offsetGet($product) === null ? "Проверка сохранила отсутствие цены\n" : "Цена найдена\n";

Записей проверки цены: 1
Ненулевого результата нет
Проверка сохранила отсутствие цены

offsetExists и isset используют здесь null-чувствительный договор. Запись физически существует и offsetGet возвращает её null. Если нужно отличить «не проверяли» от «проверили, цены нет», храните ненулевую оболочку, показанную следующим примером.

<?php
declare(strict_types=1);

$product = (object) ['title' => 'Чай'];
$prices = new WeakMap();
$prices[$product] = ['value' => null];
if ($prices->offsetExists($product)) {
    echo "Повторный запрос поставщику не нужен\n";
    echo $prices[$product]['value'] === null ? "Цена пока не опубликована\n" : "Цена получена\n";
}

Повторный запрос поставщику не нужен
Цена пока не опубликована

Оболочка-массив не равна null, поэтому наличие записи подтверждает выполненную проверку. Внутренний null остаётся отрицательным результатом. В реальном кэше определите срок действия: цена может появиться, пока объект товара продолжает жить.

<?php
$product = (object) ['title' => 'Старое имя'];
$map = new WeakMap();
$map[$product] = $product->title;
$product->title = 'Новое имя';
$map->offsetUnset($product);
echo $product->title, "\n";
echo count($map), "\n";

Новое имя
0

Автоматическая очистка по времени жизни не обновляет изменяемый объект. Здесь приложение знает о смене данных и явно удаляет устаревший кэш.

<?php
$product = new stdClass();
$map = new WeakMap();
$map[$product] = 'готово';
unset($map[$product]);
$map->offsetUnset($product);
echo count($map), "\n";

0

Повторное удаление не требует придумывать временную запись. Но аргумент метода по-прежнему должен быть объектом.

<?php
$first = new stdClass();
$second = new stdClass();
$map = new WeakMap();
$map[$first] = 'готово';
$map[$second] = null;
echo $map->count(), "\n";
unset($first);
echo count($map), "\n";

2
1

Оставшийся null считается записью. Поэтому count нельзя трактовать как число offsetExists true для всех возможных ключей.

<?php
$product = new stdClass();
$map = new WeakMap();
$map[$product] = 'готово';
foreach ($map as $key => $value) { echo $value, "\n"; }
unset($product);
echo count($map), "\n";
unset($key, $value);
echo count($map), "\n";

готово
1
0

После цикла $key остался обычной переменной со ссылкой на объект. Карта очистилась только после удаления этого последнего владельца. Так диагностический обход сам может изменить наблюдаемое время жизни.

<?php
$product = (object) ['sku' => 'A-10'];
$map = new WeakMap();
$map[$product] = 'Готово';
$iterator = $map->getIterator();
foreach ($iterator as $object => $label) { echo $object->sku, ': ', $label, "\n"; }
unset($iterator, $object, $label);

A-10: Готово

Здесь $object — сам товар, не его числовой ID. Не передавайте такой итератор в обычное преобразование массива с сохранением ключей: массив PHP не принимает объект-ключ.

<?php
$product = (object) ['sku' => 'A-10'];
$map = new WeakMap();
$map[$product] = 'Готово';
$rows = [];
foreach ($map as $object => $label) { $rows[] = ['sku' => $object->sku, 'label' => $label]; }
unset($object, $label);
echo json_encode($rows, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR), "\n";

[{"sku":"A-10","label":"Готово"}]

Для отчёта выбраны стабильные скалярные данные. Полученный список уже имеет собственное время жизни и расход памяти; экспорт всех записей снова создаёт полную коллекцию.