Функция cot_img_check_memory в Cotonti

Функция cot_img_check_memory проверяет, есть ли у PHP достаточно памяти для обработки изображения. Это особенно важно при работе с изображениями большого размера, когда нехватка памяти может привести к сбоям или ошибкам.

Разбор функции cot_img_check_memory

/**
 * Checks if PHP can have enough memory to process an image
 *
 * @param  string  $file_path  Path to an image
 * @param  int     $extra_size Extra size to adjust to the estimate (in MB)
 * @return boolean             TRUE if enough memory is available, FALSE otherwise
 */
function cot_img_check_memory($file_path, $extra_size = 0)
{
    // Gettimg memory size required to process the image
    $source_size = getimagesize($file_path);

    $tweekfactor = 1.2;
    $K64 = 65536;           // number of bytes in 64K
    $MB15 = 15 * 1048576;   // 15 Mb

    // Wrong image
    if (!$source_size) return false;

    $width_orig = $source_size[0];
    $height_orig = $source_size[1];
    $depth_orig = (isset($source_size['bits']) && $source_size['bits'] > 8) ? ($source_size['bits'] / 8) : 1;
    $channels_orig = (isset($source_size['channels']) && $source_size['channels'] > 0) ? $source_size['channels'] : 4;

    // In Bytes
    $needMem = $width_orig * $height_orig * $depth_orig * $channels_orig + $K64;

    // Adding some offset memory for other image processing and script variables,
    // otherwise the script fails
    $tweekSize = $needMem * $tweekfactor;
    $tweekSize = $tweekSize < $MB15 ? $MB15 : $tweekSize;
    $needMem = round($needMem + $tweekSize + ($extra_size * 1048576) + filesize($file_path));

    // Trying to allocate memory required
    return cot_memory_allocate($needMem);
}

Параметры функции:
$file_path — путь к файлу изображения, которое нужно обработать.
$extra_size — дополнительный размер памяти (в мегабайтах), который может понадобиться для корректной работы функции. Этот параметр используется для настройки дополнительной памяти для обработки.
Логика работы:
Получение размеров изображения:

Функция использует getimagesize() для получения метаданных изображения (ширина, высота, глубина цвета и количество каналов). Это необходимо для расчёта памяти, которая потребуется для загрузки изображения в память.
Параметры и коэффициенты:

$tweekfactor = 1.2 — коэффициент, увеличивающий необходимое количество памяти для обеспечения того, чтобы PHP не исчерпал её во время обработки.
$K64 = 65536 — фиксированное количество байт, представляющее собой 64К (необходимое для процесса обработки).
$MB15 = 15 * 1048576 — 15 МБ в байтах. Минимальный размер памяти, который резервируется, если расчёт требует меньше.
Расчёт памяти для обработки изображения:

Множество факторов участвуют в расчёте: ширина, высота, глубина цвета и количество каналов изображения.
Вычисляется $needMem, который определяет, сколько памяти потребуется для хранения изображения в памяти. Учитываются все пиксели изображения, а также дополнительные параметры (например, глубина цвета и количество каналов).
Добавление дополнительной памяти:

К вычисленному объёму памяти добавляется дополнительная память для других процессов (например, работы со скриптом), а также размер самого файла изображения (filesize($file_path)).
Проверка доступной памяти:

Для проверки памяти используется функция cot_memory_allocate, которая пытается выделить необходимое количество памяти. Если память выделяется успешно, функция возвращает true, если нет — false.

Пример использования в Cotonti:

if (!cot_img_check_memory($file_path, 10)) {
    // Обработка ошибки, если недостаточно памяти для изображения
    echo "Не хватает памяти для обработки изображения.";
} else {
    // Продолжение обработки изображения
    echo "Достаточно памяти для обработки изображения.";
}

Заключение:

Функция cot_img_check_memory обеспечивает проверку доступной памяти перед выполнением ресурсоёмких операций с изображениями. Это предотвращает ошибки, связанные с недостаточной памятью, например, при изменении размера изображения или других манипуляциях с графическими данными.