Управление памятью PHP для администраторов

Расширенные примеры работы с памятью в PHP

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

Пример 1. Изменение memory_limit в разных SAPI. Настройки для CLI и FPM могут различаться. В php.ini можно задать разные значения для разных режимов с помощью [CLI] и [FPM] секций.

; /etc/php/8.3/cli/php.ini
memory_limit = 512M

; /etc/php/8.3/fpm/php.ini
memory_limit = 128M

Результат: в CLI скрипты получают 512 MB, веб-запросы - 128 MB. Для .user.ini файла директива memory_limit также поддерживается, если включено соответствующее разрешение в user_ini.filename.

Пример 2. Мониторинг пикового потребления. Скрипт, который выводит текущий и пиковый лимит в мегабайтах.

<?php
$usage = memory_get_usage(true) / 1024 / 1024;
$peak = memory_get_peak_usage(true) / 1024 / 1024;
echo sprintf('Текущее: %.2f MB, Пиковое: %.2f MB', $usage, $peak);
?>

Текущее: 0.34 MB, Пиковое: 0.45 MB

Пример 3. Обработка большого CSV-файла с помощью генератора. Файл размером 1 ГБ обрабатывается без загрузки в память.

<?php
function readCSV($filename) {
    $f = fopen($filename, 'r');
    try {
        while (($row = fgetcsv($f)) !== false) {
            yield $row;
        }
    } finally {
        fclose($f);
    }
}
$total = 0;
foreach (readCSV('/tmp/large.csv') as $row) {
    $total += (int)$row[2];
}
echo "Сумма: $total";
?>

Сумма: 123456789 (память при этом не превышает нескольких мегабайт)

Пример 4. Циклические ссылки и ручной сбор мусора.

<?php
gc_enable();
class Node {
    public $next;
    public $data;
    public function __construct($data) {
        $this->data = $data;
    }
}
$head = new Node('A');
$second = new Node('B');
$head->next = $second;
$second->next = $head; // циклическая ссылка
$start = memory_get_usage(true);
unset($head, $second);
echo 'После unset: ' . (memory_get_usage(true) - $start) . " байт\n";
$collected = gc_collect_cycles();
echo 'Собрано ссылок: ' . $collected . "\n";
echo 'После сборки: ' . (memory_get_usage(true) - $start) . " байт\n";
?>

После unset: 0 байт
Собрано ссылок: 4
После сборки: -4096 байт (память освобождена)

Пример 5. Обработка ошибки превышения memory_limit. Использование register_shutdown_function для перехвата фатальной ошибки.

<?php
register_shutdown_function(function() {
    $error = error_get_last();
    if ($error && $error['type'] === E_ERROR) {
        if (strpos($error['message'], 'Allowed memory size') !== false) {
            echo 'Ошибка: превышен лимит памяти. Увеличьте memory_limit.';
        }
    }
});
ini_set('memory_limit', '1M'); // создание ошибки
$data = str_repeat('x', 2 * 1024 * 1024); // 2 MB
?>

Ошибка: превышен лимит памяти. Увеличьте memory_limit.

Пример 6. Использование memory_limit в контейнере Docker. Настройка через переменную окружения PHP_MEMORY_LIMIT.

# Dockerfile
FROM php:8.3-fpm
ENV PHP_MEMORY_LIMIT=256M
RUN echo "memory_limit=${PHP_MEMORY_LIMIT}" >> /usr/local/etc/php/conf.d/custom.ini

Результат: при запуске контейнера лимит будет установлен в 256 MB.

Пример 7. Выделение памяти для временных переменных в цикле. Сравнение foreach с созданием копии массива.

<?php
$array = range(1, 100000);
echo 'До: ' . memory_get_usage(true) . "\n";
foreach ($array as $value) {
    // ничего не делаем, PHP создаёт внутреннюю копию?
}
echo 'После foreach: ' . memory_get_usage(true) . "\n";
// чтобы избежать копирования, передавать по ссылке (не рекомендуется)
foreach ($array as &$value) {}
unset($value);
echo 'После foreach с ссылкой: ' . memory_get_usage(true) . "\n";
?>

До: 4194304
После foreach: 4194304
После foreach с ссылкой: 4194304 (изменения минимальны в новых версиях PHP)