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

Именованный режим: сделать серую версию карточки

Для сайта нужна серая версия цветной карточки: например, показать товар в неактивном состоянии и отдельно сравнить читаемость без цвета. На выходе будет настоящий PNG 360 × 240: мелкая сетка, круг и градиент сохранят форму, но станут серыми. Начнём с одной настройки изображения; проверки и служебные функции появляются только в полном примере ниже.

$image = new Gmagick(__DIR__ . '/constants-target.ppm');
$image->setImageType(Gmagick::IMGTYPE_GRAYSCALE);
$image->setImageFormat('PNG');
$image->setImageDepth(8);
$image->writeImage(__DIR__ . '/gm104-constants-named-gray.png');

new Gmagick читает подготовленный входной файл; $image хранит объект с пикселями. -> вызывает его метод. В круглых скобках передаётся выбранный режим. Gmagick::IMGTYPE_GRAYSCALE — именованная константа класса: после :: стоит имя неизменяемого значения, кавычки и $ не нужны. Она обозначает оттенки серого, а не имя метода. Вызывать её отдельно нечего: это аргумент setImageType. В сравнении с голой цифрой имя позволяет понять намерение кода. setImageFormat выбирает PNG-кодировщик, setImageDepth — 8 бит на компонент, writeImage записывает файл рядом с программой. __DIR__ обозначает каталог текущего PHP-файла; исходник не перезаписывается. Setter возвращает объект, но здесь цепочка разбита на строки, чтобы видеть порядок.

<?php
declare(strict_types=1);
require __DIR__ . '/gm104-constants-fixture.php';
gmRestore();

$image = new Gmagick(__DIR__ . '/constants-target.ppm');
gmPng($image, 'gm104-constants-named-source.png');
$image->setImageType(Gmagick::IMGTYPE_GRAYSCALE);
$image->setImageFormat('PNG');
$image->setImageDepth(8);
$image->writeImage(__DIR__ . '/gm104-constants-named-gray.png');

$gray = new Gmagick(__DIR__ . '/gm104-constants-named-gray.png');
$allGray = true;
foreach ($gray->getImageHistogram() as $pixel) {
    $r = $pixel->getColorValue(Gmagick::COLOR_RED);
    $g = $pixel->getColorValue(Gmagick::COLOR_GREEN);
    $b = $pixel->getColorValue(Gmagick::COLOR_BLUE);
    $allGray = $allGray && abs($r - $g) < 0.00001 && abs($g - $b) < 0.00001;
}

$checks = [
    'gray_channels_equal' => $allGray,
    'image_size_preserved' => $gray->getImageWidth() === 360 && $gray->getImageHeight() === 240
];
gmReport('gm104-constants-named', ["gmagick.setimagetype", "gmagick.getimagehistogram", "gmagick.writeimage"], ["gm104-constants-named-source.png", "gm104-constants-named-gray.png"], $checks, $errors ?? [], ['constant' => 'Gmagick::IMGTYPE_GRAYSCALE', 'value' => Gmagick::IMGTYPE_GRAYSCALE]);
echo "gm104-constants-named-gray.png: 360x240; all RGB channels equal\n";

gm104-constants-named-gray.png: 360x240; all RGB channels equal

Перед кодом показаны оба реально сохранённых изображения. Полный пример дополнительно читает серый PNG, проверяет равенство R/G/B у всех цветов гистограммы и прежние размеры. Это проверяет действие, а не только успешный вызов. Серая версия сама по себе не объясняет статус товара людям, которые не различают цвет: добавьте текст «недоступен». Для настоящего управления цветом и печати нужна работа с профилями, а не одно название Gray. Упражнение: заменить IMGTYPE_GRAYSCALE на IMGTYPE_TRUECOLOR. Тогда получится полноцветный вариант, и проверка равенства каналов перестанет быть подходящим ожиданием — требование и проверка должны измениться вместе.

Опорные понятия: объект и метод, константы PHP, аргументы и return, независимая копия через clone.

Все константы по 28 категориям: смысл, значение и доступность

Ниже сохранены все 28 групп и 274 имени официальной страницы. Для каждого — назначение и значение именно нашей проверенной сборки PHP 8.3.6 / Gmagick 2.0.6RC1 / GraphicsMagick 1.3.42 Q16. Из официального перечня 238 имён определены и 36 отсутствуют. Это снимок доступности, а не обещание всех функций на любом сервере. Числа показываются для диагностики; в рабочих рецептах используйте имена.

if (defined("Gmagick::FILTER_LANCZOS")) {
    $filter = constant("Gmagick::FILTER_LANCZOS");
}

defined получает строку с полным именем и безопасно возвращает bool. constant читает значение только после проверки. Прямое Gmagick::НЕСУЩЕСТВУЮЩЕЕ_ИМЯ вызовет Error. Одинаковое число в двух группах не разрешает подменять аргумент одного назначения другим. Цветовой канал, правило смешивания и фильтр масштабирования решают разные задачи.

Выбрать фильтр: чёткие клетки или сглаженные контуры

У маленького каталожного превью зубчатая окружность, а у схемы после уменьшения появилась лишняя серость. Обе задачи используют resizeImage, но не обязаны выбирать один фильтр. Здесь два уменьшения одного исходника до 90 × 60 и два увеличения этих маленьких результатов до 360 × 240: рядом видно, какие пиксели появились из-за каждого фильтра.

$small = clone $source;
$small->resizeImage(90, 60, Gmagick::FILTER_POINT, 1.0);
gmPng($small, 'gm104-constants-filters-point-small.png');

clone создаёт независимую рабочую копию: оба маршрута начинают с одного источника. Аргументы resizeImage — ширина, высота, фильтр и blur. Здесь размеры задают ту же пропорцию 3:2, поэтому нет растяжения. FILTER_POINT выбирает ближайшие отсчёты: это полезно для пиксельной графики и условных цветных клеток. FILTER_LANCZOS учитывает соседние значения и лучше сглаживает многие контуры, но на контрастных линиях может давать ореолы. 1.0 — стандартная ширина ядра, а не процент качества или степень JPEG-сжатия. Пятый необязательный fit здесь не используется. Уменьшение до 90 × 60 теряет детали в обоих случаях; последующее увеличение их не восстановит.

<?php
declare(strict_types=1);
require __DIR__ . '/gm104-constants-fixture.php';
gmRestore();

$source = new Gmagick(__DIR__ . '/constants-target.ppm');
gmPng($source, 'gm104-constants-filters-source.png');
$filters = ['point' => Gmagick::FILTER_POINT, 'lanczos' => Gmagick::FILTER_LANCZOS];
foreach ($filters as $name => $filter) {
    $small = clone $source;
    $small->resizeImage(90, 60, $filter, 1.0);
    gmPng($small, 'gm104-constants-filters-' . $name . '-small.png');
    // Одинаковое увеличение обоих вариантов только для рассмотрения пикселей.
    $zoom = clone $small;
    $zoom->resizeImage(360, 240, Gmagick::FILTER_POINT, 1.0);
    gmPng($zoom, 'gm104-constants-filters-' . $name . '-zoom.png');
}

$checks = [
    'different_small_pixels' => !gmSamePixels('gm104-constants-filters-point-small.png', 'gm104-constants-filters-lanczos-small.png'),
    'source_dimensions_unchanged' => $source->getImageWidth() === 360 && $source->getImageHeight() === 240
];
gmReport('gm104-constants-filters', ["gmagick.resizeimage", "gmagick.writeimage"], ["gm104-constants-filters-source.png", "gm104-constants-filters-point-small.png", "gm104-constants-filters-lanczos-small.png", "gm104-constants-filters-point-zoom.png", "gm104-constants-filters-lanczos-zoom.png"], $checks, $errors ?? [], ['filters' => $filters, 'blur' => 1.0, 'zoom_filter' => 'FILTER_POINT']);
echo "2 previews: 90x60; 2 pixel zooms: 360x240\n";

2 previews: 90x60; 2 pixel zooms: 360x240

gmPng — короткий helper нашего архива, который сохраняет PNG-копию; это не метод Gmagick. Для наглядного увеличения оба маленьких результата масштабируются одним Point, чтобы не подмешивать второе сглаживание. Полная программа действительно сохраняет все пять PNG и проверяет различие маленьких результатов. Цифровая разница сама по себе не означает, что один вариант лучше. Упражнение: для товарной фотографии сравните Lanczos и Mitchell в равных размерах, оцените края и текст; для QR-кода не рассчитывайте на произвольный resize — генерируйте его в нужном масштабе с целым числом пикселей на модуль.

Опорные понятия: объект и метод, константы PHP, аргументы и return, независимая копия через clone.

Проблема из реальной разработки

ImageMagick Antia-aliasing: После уменьшения чёрно-белой графики появились серые пиксели; отключение antialias не объяснило выбор фильтра. Показываем один и тот же исходник через Point и Lanczos, затем одинаково увеличиваем оба результата для сравнения: фильтр масштабирования выбирается по задаче. Обсуждение помогает выбрать задачу; контракт Gmagick и результат берём из первичных источников и выполненного кода, а не переносим API Imagick автоматически.

Наложить плашку: координаты отдельно от смешивания

Нужно поместить знак акции в угол карточки. Вопросов два: где окажется плашка и как её цвет взаимодействует с фоном. Эти параметры независимы. Первый PNG показывает непрозрачную золотую плашку сверху слева; второй — умножение цвета снизу справа, где просвечивает структура шкалы.

[$x, $y] = cornerPosition($result, $badge, Gmagick::GRAVITY_SOUTHEAST, 12);
$result->compositeImage($badge, Gmagick::COMPOSITE_MULTIPLY, $x, $y);

cornerPosition — наша функция из полного примера, не скрытый API библиотеки. Она получает холст, слой, одно из двух разрешённых мест и отступ. Для нижнего правого угла x = 360 − 80 − 12 = 268, y = 240 − 40 − 12 = 188. Эти числа задают левый верхний угол самого слоя. В записи [$x, $y] два элемента возвращённого массива попадают в две переменные. GRAVITY_SOUTHEAST используется как понятное имя выбора внутри нашей функции. Метод compositeImage получает уже готовые x/y: мы не обещаем, что произвольный setter gravity сам поменяет его координаты.

<?php
declare(strict_types=1);
require __DIR__ . '/gm104-constants-fixture.php';
gmRestore();

function cornerPosition(Gmagick $base, Gmagick $layer, int $gravity, int $margin): array {
    $right = $base->getImageWidth() - $layer->getImageWidth() - $margin;
    $bottom = $base->getImageHeight() - $layer->getImageHeight() - $margin;
    if ($margin < 0 || $right < $margin || $bottom < $margin) {
        throw new InvalidArgumentException('Layer does not fit with this margin');
    }
    return match ($gravity) {
        Gmagick::GRAVITY_NORTHWEST => [$margin, $margin],
        Gmagick::GRAVITY_SOUTHEAST => [$right, $bottom],
        default => throw new InvalidArgumentException('Only two corners are allowed'),
    };
}
$source = new Gmagick(__DIR__ . '/constants-target.ppm');
$badge = new Gmagick();
$badge->newImage(80, 40, '#f2b84b');
gmPng($source, 'gm104-constants-placement-source.png');
$positions = [];
foreach (['over-nw' => [Gmagick::COMPOSITE_OVER, Gmagick::GRAVITY_NORTHWEST],
          'multiply-se' => [Gmagick::COMPOSITE_MULTIPLY, Gmagick::GRAVITY_SOUTHEAST]] as $name => [$blend, $gravity]) {
    $result = clone $source;
    [$x, $y] = cornerPosition($result, $badge, $gravity, 12);
    $result->compositeImage($badge, $blend, $x, $y);
    gmPng($result, 'gm104-constants-placement-' . $name . '.png');
    $positions[$name] = [$x, $y];
}
$errors['unsupported_corner'] = gmTry(fn() => cornerPosition($source, $badge, Gmagick::GRAVITY_CENTER, 12));

$checks = [
    'positions_are_explicit' => $positions === ['over-nw' => [12, 12], 'multiply-se' => [268, 188]],
    'unknown_gravity_rejected' => ($errors['unsupported_corner']['class'] ?? '') === InvalidArgumentException::class
];
gmReport('gm104-constants-placement', ["gmagick.newimage", "gmagick.compositeimage", "gmagick.writeimage"], ["gm104-constants-placement-source.png", "gm104-constants-placement-over-nw.png", "gm104-constants-placement-multiply-se.png"], $checks, $errors ?? [], ['positions' => $positions, 'badge_size' => [80, 40], 'margin' => 12]);
echo "over-nw: 12,12; multiply-se: 268,188; unknown corner rejected\n";

over-nw: 12,12; multiply-se: 268,188; unknown corner rejected

COMPOSITE_OVER размещает источник поверх фона с учётом прозрачности. Здесь источник непрозрачен, поэтому плашка закрывает рисунок. COMPOSITE_MULTIPLY перемножает нормированные компоненты: на белом фоновой шкалы виден исходный цвет плашки, на тёмном он темнее. Плашка не обязана иметь тот же размер, что фон. Функция заранее отклоняет неумещающийся слой и неподдерживаемый CENTER через InvalidArgumentException; эта ошибка относится к нашей политике двух углов, а не ко всем возможностям GraphicsMagick. Упражнение: добавить третий разрешённый угол NORTHEAST. Решение: вернуть [$right, $margin], оставив режим смешивания отдельным аргументом.

Опорные понятия: объект и метод, константы PHP, аргументы и return, независимая копия через clone.

Проблема из реальной разработки

How to position watermark on right side in Imagick PHP?: Автор передаёт координаты 20,20 и хочет переместить водяной знак в нижний правый угол. Явно вычисляем x=W-w-margin и y=H-h-margin; собственная функция переводит разрешённую gravity в координаты, а режим смешивания задаётся отдельно. Обсуждение помогает выбрать задачу; контракт Gmagick и результат берём из первичных источников и выполненного кода, а не переносим API Imagick автоматически.

Запросить 8/16 бит и interlace, затем прочитать реальный PNG

Выгрузка для дизайнера должна сохранить 16-битный градиент, а web-файл — иметь определённый порядок загрузки. Успешного setter недостаточно: проверяем то, что записал PNG-кодировщик. Три настоящих файла могут выглядеть почти одинаково в браузере, но различаются глубиной отсчётов и полем interlace в заголовке.

$source->setInterlaceScheme(Gmagick::INTERLACE_LINE);
gmPng($source, 'gm104-constants-encoding-writer-line16.png', 16);

Входная мишень действительно содержит 16-битные компоненты, не просто 8-битную картинку с ярлыком «16». gmPng принимает третий аргумент — глубину записи копии. INTERLACE_LINE принадлежит Gmagick; в PNG ему соответствует режим Adam7, но это разные числовые перечисления. Функция pngHeader читает байты уже записанного файла: depth — по смещению 24, color_type — 25, interlace — 28, после проверки сигнатуры PNG и IHDR. 0 в PNG означает обычную запись, 1 — Adam7. Проверка заголовка маленькая и привязана именно к PNG, а не к JPEG.

<?php
declare(strict_types=1);
require __DIR__ . '/gm104-constants-fixture.php';
gmRestore();

function pngHeader(string $filename): array {
    $bytes = file_get_contents(__DIR__ . '/' . $filename);
    if (substr($bytes, 0, 8) !== "\x89PNG\r\n\x1a\n" || substr($bytes, 12, 4) !== 'IHDR') {
        throw new RuntimeException('PNG header expected');
    }
    return ['depth' => ord($bytes[24]), 'color_type' => ord($bytes[25]), 'interlace' => ord($bytes[28])];
}
$source = new Gmagick(__DIR__ . '/constants-target.ppm');
$source->setImageInterlaceScheme(Gmagick::INTERLACE_NO);
gmPng($source, 'gm104-constants-encoding-plain8.png', 8);
$source->setImageInterlaceScheme(Gmagick::INTERLACE_LINE);
gmPng($source, 'gm104-constants-encoding-image-line16.png', 16);
// Настройка кодировщика — другой метод, проверенный отдельно по выходному файлу.
$source->setInterlaceScheme(Gmagick::INTERLACE_LINE);
gmPng($source, 'gm104-constants-encoding-writer-line16.png', 16);
$headers = [];
foreach (['plain8', 'image-line16', 'writer-line16'] as $name) {
    $headers[$name] = pngHeader('gm104-constants-encoding-' . $name . '.png');
}
file_put_contents(__DIR__ . '/gm104-constants-encoding-encoding.json', json_encode($headers, JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR));

$checks = [
    'depths_are_in_file' => $headers['plain8']['depth'] === 8 && $headers['image-line16']['depth'] === 16 && $headers['writer-line16']['depth'] === 16,
    'image_setting_not_writer_setting' => $headers['image-line16']['interlace'] === 0 && $headers['writer-line16']['interlace'] === 1,
    'interlace_preserves_pixels' => gmSamePixels('gm104-constants-encoding-image-line16.png', 'gm104-constants-encoding-writer-line16.png')
];
gmReport('gm104-constants-encoding', ["gmagick.setimageinterlacescheme", "gmagick.setinterlacescheme", "gmagick.setimagedepth", "gmagick.writeimage"], ["gm104-constants-encoding-plain8.png", "gm104-constants-encoding-image-line16.png", "gm104-constants-encoding-writer-line16.png"], $checks, $errors ?? [], ['png_IHDR' => $headers]);
echo "PNG depth: 8,16,16; interlace: 0,0,1\n";

PNG depth: 8,16,16; interlace: 0,0,1

Первый файл: 8 бит, interlace 0. Второй: 16 бит и снова 0 — setImageInterlaceScheme(LINE) в нашей сборке не настроил кодировщик. Третий использует отдельный setInterlaceScheme(LINE): ожидаемый и проверяемый результат 16 бит, Adam7. В C-реализации методы вызывают разные функции Wand. Сравнение двух 16-битных файлов проверяет прежние пиксели, хотя их бинарные файлы разные. Поле interlace не гарантирует, что конкретный браузер покажет промежуточные проходы. На обычном 8-битном экране дополнительная точность может быть невидима; 16 бит полезны для последующей обработки, но увеличивают данные. Упражнение: принять PNG от стороннего оптимизатора. Решение — прочитать его новый IHDR, а не считать старую настройку PHP гарантией. Ошибка чтения или неверная сигнатура вызывает RuntimeException с объяснением.

Опорные понятия: объект и метод, константы PHP, аргументы и return, независимая копия через clone.

Проблема из реальной разработки

Why doesn't setImageInterlaceScheme() make a jpeg progressive?: Gmagick принимает interlace-параметр, getter подтверждает его, но сохранённый JPEG не становится прогрессивным. Разделяем настройку изображения и настройку записи; результат подтверждаем байтом IHDR реального PNG, а не успешным setter. Формат результата и версия указаны, JPEG не подменяем PNG. Обсуждение помогает выбрать задачу; контракт Gmagick и результат берём из первичных источников и выполненного кода, а не переносим API Imagick автоматически.

Принять режим из формы: разрешённые имена вместо случайных чисел

Редактор сайта выбирает «пиксельная карточка» или «серая карточка» в форме. Сервер должен получить понятный рецепт и отвергнуть опечатку, число или массив вместо одного значения. Этот пример создаёт серое превью 180 × 120 и сохраняет JSON с выбранным именем и разрешёнными числовыми значениями.

$choice = 'gray-card';
$recipe = resolveRecipe($choice);
$image->resizeImage(180, 120, $recipe['filter'], 1.0);
$image->setImageType($recipe['type']);

Сначала разрешается короткое пользовательское имя, затем внутреннее имя константы переводится в int. resolveRecipe — собственная функция: словарь фиксирует допустимые комбинации и не выполняет произвольную строку пользователя. is_string отвергает массив из поля вида recipe[], array_key_exists отвергает неизвестный ключ. defined защищает от отсутствующей константы конкретного расширения; constant вызывается только для внутренней строки из allowlist. Это не способ обходить отсутствие API: если режим недоступен, программа сообщает RuntimeException, а не незаметно выбирает случайный запасной. Полная программа демонстрирует три отклонённых входа: greay-card, строку 13 и массив.

<?php
declare(strict_types=1);
require __DIR__ . '/gm104-constants-fixture.php';
gmRestore();

function resolveRecipe(mixed $choice): array {
    $recipes = [
        'pixel-card' => ['filter' => 'Gmagick::FILTER_POINT', 'type' => 'Gmagick::IMGTYPE_TRUECOLOR'],
        'gray-card' => ['filter' => 'Gmagick::FILTER_LANCZOS', 'type' => 'Gmagick::IMGTYPE_GRAYSCALE'],
    ];
    if (!is_string($choice) || !array_key_exists($choice, $recipes)) {
        throw new InvalidArgumentException('Unknown recipe');
    }
    $resolved = [];
    foreach ($recipes[$choice] as $key => $constantName) {
        if (!defined($constantName)) {
            throw new RuntimeException('Required constant is unavailable: ' . $constantName);
        }
        $resolved[$key] = constant($constantName);
    }
    return $resolved;
}
$choice = 'gray-card'; // Здесь окажется уже извлечённое значение поля формы.
$recipe = resolveRecipe($choice);
$image = new Gmagick(__DIR__ . '/constants-target.ppm');
$image->resizeImage(180, 120, $recipe['filter'], 1.0);
$image->setImageType($recipe['type']);
gmPng($image, 'gm104-constants-config-card.png');
foreach (['typo' => 'greay-card', 'numeric_string' => '13', 'array_field' => ['gray-card']] as $name => $bad) {
    $errors[$name] = gmTry(fn() => resolveRecipe($bad));
}
$availability = ['Gmagick::COMPOSITE_BLEND' => defined('Gmagick::COMPOSITE_BLEND')];
file_put_contents(__DIR__ . '/gm104-constants-config-recipe.json', json_encode(['selected' => $choice, 'resolved' => $recipe, 'availability' => $availability], JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR));

$checks = [
    'typo_rejected' => ($errors['typo']['class'] ?? '') === InvalidArgumentException::class,
    'numeric_string_rejected' => ($errors['numeric_string']['class'] ?? '') === InvalidArgumentException::class,
    'array_field_rejected' => ($errors['array_field']['class'] ?? '') === InvalidArgumentException::class,
    'output_size' => $image->getImageWidth() === 180 && $image->getImageHeight() === 120
];
gmReport('gm104-constants-config', ["gmagick.resizeimage", "gmagick.setimagetype", "gmagick.writeimage"], ["gm104-constants-config-card.png"], $checks, $errors ?? [], ['choice' => $choice, 'recipe' => $recipe, 'availability' => $availability]);
echo "gray-card: 180x120; 3 invalid choices rejected\n";

gray-card: 180x120; 3 invalid choices rejected

Названия pixel-card/gray-card — интерфейс нашего сервиса, а не встроенные пресеты PHP. COMPOSITE_BLEND в официальном каталоге есть, а в проверенной сборке нет; в квитанции безопасно записывается false, без обращения к несуществующей константе. До обработки загрузки дополнительно нужны проверки файла и ограничений, которые разбираются отдельно. Упражнение: добавить параметр ширины из формы. Не передавайте произвольное число в resizeImage: сначала задайте разумный диапазон, проверьте целое значение и определите политику пропорций. В этом примере размеры намеренно фиксированы, поэтому одна настройка не превращается в неограниченный расход памяти.

Опорные понятия: объект и метод, константы PHP, аргументы и return, независимая копия через clone.

Продолжение: HTML-поле и $_POST, проверка загружаемого файла.

Повторяемый рецепт мини-галереи: превью, рамка и эффект

Теперь соберём маленькую галерею вариантов из одного исходника. Официальный первый пример Gmagick связывает чтение, thumbnail, рамку, масляный эффект и запись. Здесь этот маршрут разобран на функцию, создающую два реальных файла: чистое превью и оформленный вариант, плюс JSON с именами и размерами для HTML-галереи.

$image->thumbnailImage(120, 0);
$image->borderImage(new GmagickPixel('#f2b84b'), 8, 8);
$image->oilPaintImage(0.3);
$image->setImageFormat('PNG');
$image->setImageDepth(8);
$image->writeImage($output);

В thumbnailImage второй размер 0 разрешает рассчитать высоту по пропорции: 360 × 240 становится 120 × 80. Рамка добавляет по 8 пикселей с каждой стороны, поэтому файл получает 136 × 96. Цвет задаётся объектом GmagickPixel — это соответствует сигнатуре borderImage; обычная строка с именем цвета в старом вводном примере не заменяет изучение текущего типа аргумента. Радиус oilPaintImage 0.3 относится к алгоритму эффекта, а не к толщине рамки. Эффект применяется после рамки, как в официальной последовательности. Его видимость зависит от рисунка и масштаба; программа не обещает выразительную живопись на любом маленьком значке. Для превращения фотографии товара в художественную иллюстрацию сохраняйте обычный оригинал отдельно.

<?php
declare(strict_types=1);
require __DIR__ . '/gm104-constants-fixture.php';
gmRestore();

function makeGalleryCard(string $input, string $output, bool $paint): array {
    $image = new Gmagick($input);
    $image->thumbnailImage(120, 0);
    $image->borderImage(new GmagickPixel('#f2b84b'), 8, 8);
    if ($paint) {
        $image->oilPaintImage(0.3);
    }
    $image->setImageFormat('PNG');
    $image->setImageDepth(8);
    $image->writeImage($output);
    return ['width' => $image->getImageWidth(), 'height' => $image->getImageHeight(), 'paint' => $paint];
}
$input = __DIR__ . '/constants-target.ppm';
$manifest = [];
foreach (['clean' => false, 'paint' => true] as $name => $paint) {
    $filename = 'gm104-constants-gallery-' . $name . '.png';
    $manifest[$filename] = makeGalleryCard($input, __DIR__ . '/' . $filename, $paint);
}
file_put_contents(__DIR__ . '/gm104-constants-gallery-gallery.json', json_encode($manifest, JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR));

$checks = [
    'two_cards_same_canvas' => count($manifest) === 2 && array_reduce($manifest, fn($ok, $card) => $ok && $card['width'] === 136 && $card['height'] === 96, true),
    'source_still_original' => hash_file('sha256', $input) === GM_INPUT_HASHES['constants-target.ppm']
];
gmReport('gm104-constants-gallery', ["gmagick.thumbnailimage", "gmagick.borderimage", "gmagick.oilpaintimage", "gmagick.writeimage"], ["gm104-constants-gallery-clean.png", "gm104-constants-gallery-paint.png"], $checks, $errors ?? [], ['gallery' => $manifest]);
echo "gallery: 2 PNG files, 136x96 each; original preserved\n";

gallery: 2 PNG files, 136x96 each; original preserved

makeGalleryCard заново читает исходник при каждом вызове, поэтому вторая карточка не получает рамку поверх первой. Параметр $paint выбирает ветку if; return возвращает массив измерений, а сам PNG записывается через writeImage. Результат функции — информация для приложения, файл — для браузера. foreach применяет два заранее заданных варианта и записывает gallery.json. __DIR__ и входной base64 находятся в архиве, поэтому отсутствующие файлы не нужно угадывать. Если чтение, операция или запись не удалась, Gmagick выбросит исключение; реальному сервису нужен обработчик, который сообщит об ошибке и не опубликует неполную галерею. Упражнение: показывать только чистую карточку в магазине, а художественную — в редакторском просмотре. Решение: хранить обе записи, но выбирать соответствующее имя файла на уровне шаблона, не перегенерировать картинку на каждый просмотр.

Опорные понятия: объект и метод, константы PHP, аргументы и return, независимая копия через clone.

Дальше: пропорции превью, ICC и цвет web-изображения, обработка ошибки без ложного успешного результата.