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

Почему PHP обычно освобождает память сам и где появляется цикл

PHP освобождает большинство значений автоматически. Простое значение исчезает, когда на него больше никто не ссылается; дополнительный сборщик нужен для циклов, где объекты или массивы указывают друг на друга. Поэтому gc_collect_cycles() — не команда «очистить всю память», а точечный инструмент для потенциальных циклических остатков.

Счётчик ссылок: объект живёт до последнего владельца

Имя переменной не содержит объект «внутри себя»: оно ведёт к значению. Присваивание объекта другой переменной создаёт ещё одну ссылку на тот же объект, а не независимую копию. unset() удаляет одно имя; destructor вызывается, когда исчезает последняя ссылка или завершается запрос.

<?php
declare(strict_types=1);

final class Parcel
{
    public function __construct(public string $code) {}
    public function __destruct() { echo "Освобождён {$this->code}\n"; }
}

$first = new Parcel('A-17');
$alias = $first;
unset($first);
echo "После unset(first) объект доступен: {$alias->code}\n";
unset($alias);
echo "Последняя ссылка удалена\n";

После unset(first) объект доступен: A-17
Освобождён A-17
Последняя ссылка удалена

• Ссылки PHP с & и внутренний refcount — связанные, но не тождественные понятия.
• Объект присваивается как handle к одному экземпляру; массив использует copy-on-write и копируется при изменении.
• debug_zval_dump() полезен только как диагностика: временные аргументы и оптимизации влияют на показываемый refcount.

Цикл A ↔ B: почему одного refcount недостаточно

После unset внешних имён уже нет, но каждый Node всё ещё удерживает другой. Сборщик хранит потенциальные корни в специальном буфере и, когда запускается, определяет, достижимы ли они извне. gc_enable() и gc_disable() управляют автоматическим запуском; явный gc_collect_cycles() всё равно можно вызвать и при отключённом автоматическом GC.

<?php
declare(strict_types=1);

gc_disable();

final class Node
{
    public ?Node $next = null;
}

$first = new Node();
$second = new Node();
$first->next = $second;
$second->next = $first;
unset($first, $second);

echo 'Собрано в первый раз: ', gc_collect_cycles(), "\n";
echo 'Собрано во второй раз: ', gc_collect_cycles(), "\n";

Собрано в первый раз: 2
Собрано во второй раз: 0

Функция gc_status() показывает статистику текущего процесса: поля и их точный набор зависят от версии PHP. Для диагностики фиксируйте версию, gc_enabled(), число runs/collected и память до/после одного и того же workload; не сравнивайте разные процессы только по одному RSS.

Производительность GC: измерить batch, циклы и реальную границу worker

Сборка циклов имеет цену: PHP хранит кандидатов и выполняет обход. Отключение GC иногда ускоряет короткий участок без циклов, но в долгом worker способно вызвать рост памяти. Сначала измеряйте реальный workload. memory_get_usage(true) включает память, зарезервированную allocator-ом; memory_get_peak_usage(true) — исторический максимум, который не обязан уменьшаться после unset или GC.

<?php
declare(strict_types=1);

function processBatch(int $jobs, int $payloadBytes): array
{
    $peakBefore = memory_get_peak_usage(true);
    for ($i = 0; $i < $jobs; $i++) {
        $payload = str_repeat('x', $payloadBytes);
        $checksum = hash('sha256', $payload);
        unset($payload, $checksum);
    }
    return [
        'jobs' => $jobs,
        'peak_grew' => memory_get_peak_usage(true) >= $peakBefore,
        'gc_enabled' => gc_enabled(),
    ];
}

$report = processBatch(3, 1024);
echo 'Заданий: ', $report['jobs'], "\n";
echo 'Пик не уменьшился: ', $report['peak_grew'] ? 'да' : 'нет', "\n";
echo 'GC включён: ', $report['gc_enabled'] ? 'да' : 'нет', "\n";

Заданий: 3
Пик не уменьшился: да
GC включён: да