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

Сохранить наклейку и сделать карточку на выбранном фоне

Для сайта нужна PNG-наклейка, которую можно положить на любой цвет. Для скачивания в памятку нужна другая версия — готовая карточка со своим светлым фоном. У кружки есть прозрачное отверстие ручки и полупрозрачный край; просто выключить прозрачность недостаточно: могут проявиться скрытые чёрные пиксели. Сохраним оригинал и подготовим отдельный RGB-файл.

Наш собственный исходник 400×320 уже содержит вырезанный силуэт коробки и кружки. Эти методы не распознают товар и не удаляют фон фотографии. Надписи MUG/SKU — часть рисунка, они не являются измерением alpha. Фон окна просмотра не входит в PNG: ниже исходный RGBA-файл может быть показан на белом, тёмном или шахматном поле интерфейса.

Getter задаёт вопрос и возвращает bool: true/false. False для RGB — нормальный ответ, не ошибка. Два setter меняют текущий объект и возвращают статус true, который не является новой картинкой. Чтобы получить файл, отдельно вызываем writeImage. При сохранении непрозрачного результата в принудительном RGBA контейнер снова содержит канал: после чтения getter может стать true при всех A=1. Это ожидаемое различие состояния и содержимого.

Пусть $image уже содержит загруженную картинку: $image = new Imagick('source.png'); new создаёт объект, строка в кавычках — путь. $ обозначает переменную, = присваивает результат, -> вызывает метод этой картинки, () содержит аргументы, ; завершает инструкцию. :: обращается к именованной константе класса; например, ALPHACHANNEL_REMOVE выбирает режим удаления alpha с фоном. RGB — красная, зелёная и синяя компоненты; RGBA добавляет alpha: 0 прозрачно, 1 непрозрачно, промежуточное значение смешивает с подложкой.

Строка #e6edf1 задаёт непрозрачные RGB 230/237/241 в обычной шестнадцатеричной записи цвета. Первый вызов только сохраняет настройку. Следующий REMOVE использует её для смешивания с активной alpha. Возвращённые true — статусы; ни один не возвращает новую картинку:

$image->setImageBackgroundColor('#e6edf1');
$image->setImageAlphaChannel(Imagick::ALPHACHANNEL_REMOVE);

В полных программах clone создаёт отдельную копию, чтобы оригинал остался доступен. ! означает отрицание; if (!$image->...) проверяет отказ setter; throw new RuntimeException прерывает цепочку. writeImage сохраняет результат в файл. Основа: объекты и методы, копия через clone, if, исключения.

Перед полной программой: <?php открывает PHP; declare(strict_types=1) включает строгие типы; require подключает helper из той же папки, __DIR__ обозначает её путь. loadAlphaSource восстанавливает исходный PNG из Base64 и проверяет его контрольную сумму; это упаковка входа, не обработка alpha. Функции alphaPreview/saveAlphaNative/saveAlphaComparison имеют открытый код ниже: первая накладывает на непрозрачную подложку через OVER, следующие сохраняют отдельный PNG и сравнение. [] — массив панелей по порядку, запятые разделяют элементы. Строка "\n" означает перевод строки, echo выводит имена файлов. Связи: файлы, функции, массивы, композиция OVER.

Подготовить карточку со своим светлым фоном и сохранить исходную наклейку

Слева исходная наклейка поверх белого, в середине тот же прозрачный вход поверх тёмного, справа готовая непрозрачная card-light.png поверх тёмного. У готовой карточки светлый прямоугольник и фон внутри отверстия ручки уже записаны в RGB-пикселях.

<?php
declare(strict_types=1);
require __DIR__ . '/alpha-fixture.php';
$source = loadAlphaSource();
$card = clone $source;
if (!$card->setImageBackgroundColor('#e6edf1')) { throw new RuntimeException('Background failed'); }
if (!$card->setImageAlphaChannel(Imagick::ALPHACHANNEL_REMOVE)) { throw new RuntimeException('Remove failed'); }
saveAlphaNative($card, 'card-light.png', false);
saveAlphaComparison([alphaPreview($source, 'white'), alphaPreview($source, '#243c4d'), alphaPreview($card, '#243c4d')], 'first-alpha.png');
echo "first-alpha.png\ncard-light.png\n";

first-alpha.png
card-light.png

Разделить состояние канала и прозрачность пикселей

Чтобы не спутать канал и прозрачные пиксели, сравним вход с двумя одинаковыми светлыми полями. new Imagick() создаёт пустой объект, newImage(400,320,цвет) — полный непрозрачный растр. clone копирует его, OPAQUE создаёт/заполняет alpha единицами. getImageAlphaChannel не принимает аргументов:

$hasAlpha = $source->getImageAlphaChannel();
$opaque->setImageAlphaChannel(Imagick::ALPHACHANNEL_OPAQUE);

(int) переводит bool в число 0/1 для понятного stdout; точка . соединяет строки. Поэтому одинаковый вид двух полей не требует одинакового ответа getter.

Сравнить канал alpha и непрозрачность пикселей

Слева наклейка на белом; в середине созданное RGB-поле без alpha; справа то же поле после OPAQUE с активным alpha и всеми A=1. Последние две панели выглядят одинаково, но getter возвращает разные ответы.

<?php
declare(strict_types=1);
require __DIR__ . '/alpha-fixture.php';
$source = loadAlphaSource();
$rgb = new Imagick();
$rgb->newImage(400, 320, '#e6edf1');
$opaque = clone $rgb;
if (!$opaque->setImageAlphaChannel(Imagick::ALPHACHANNEL_OPAQUE)) { throw new RuntimeException('Opaque failed'); }
$sourceHas = $source->getImageAlphaChannel();
$rgbHas = $rgb->getImageAlphaChannel();
$opaqueHas = $opaque->getImageAlphaChannel();
saveAlphaComparison([alphaPreview($source, 'white'), $rgb, alphaPreview($opaque, 'white')], 'alpha-controls.png');
echo "alpha-controls.png\nsource=" . (int)$sourceHas . " rgb=" . (int)$rgbHas . " opaque-rgba=" . (int)$opaqueHas . "\n";

alpha-controls.png
source=1 rgb=0 opaque-rgba=1

Сохранить alpha и проверить доставленный файл

Первый сценарий сохраняет существующую наклейку как RGBA, не трогая её пиксели. Второй нужен при приёмке готового файла: наличие канала не подтверждает прозрачность. Мы намеренно записываем непрозрачную карточку в RGBA и считаем значения A после чтения.

Пусть $image уже содержит загруженную картинку: $image = new Imagick('source.png'); new создаёт объект, строка в кавычках — путь. $ обозначает переменную, = присваивает результат, -> вызывает метод этой картинки, () содержит аргументы, ; завершает инструкцию. :: обращается к именованной константе класса; например, ALPHACHANNEL_REMOVE выбирает режим удаления alpha с фоном. RGB — красная, зелёная и синяя компоненты; RGBA добавляет alpha: 0 прозрачно, 1 непрозрачно, промежуточное значение смешивает с подложкой.

$hasAlpha получает логический ответ, а не изображение. if выполняет ветку, когда ответ true; false здесь не нужно превращать в исключение. Проверка не подтверждает наличие хотя бы одного пикселя с alpha меньше 1:

$hasAlpha = $image->getImageAlphaChannel();
if ($hasAlpha) {
    echo "Channel is present\n";
}

В полных программах clone создаёт отдельную копию, чтобы оригинал остался доступен. ! означает отрицание; if (!$image->...) проверяет отказ setter; throw new RuntimeException прерывает цепочку. writeImage сохраняет результат в файл. Основа: объекты и методы, копия через clone, if, исключения.

alphaCounts читает A у каждого пикселя. Imagick::getQuantumRange() — статический вызов класса, возвращающий массив; ['quantumRangeLong'] читает максимум по ключу, $Q хранит это число. exportImagePixels(...,'A',Imagick::PIXEL_SHORT) возвращает массив значений A в 16-битной шкале проверенной Q16-сборки. foreach проходит по значениям, === сравнивает точно, ++ увеличивает счётчик; $counts['zero'] читает итог. Это дополнительный проход по растру, а не скрытая работа getter.

Сохранить наклейку с существующим alpha-каналом

retained-alpha.png хранит исходные RGBA-пиксели, включая отверстие ручки и частично прозрачный край. Сравнение показывает один и тот же файл на двух подложках; белый фон слева не закрашен в самой наклейке.

<?php
declare(strict_types=1);
require __DIR__ . '/alpha-fixture.php';
$source = loadAlphaSource();
$hasAlpha = $source->getImageAlphaChannel();
saveAlphaNative($source, 'retained-alpha.png', $hasAlpha);
saveAlphaComparison([alphaPreview($source, 'white'), alphaPreview($source, '#243c4d')], 'alpha-preserve.png');
echo "alpha-preserve.png\nhas-channel=" . (int)$hasAlpha . "\n";

alpha-preserve.png
has-channel=1

Проверить реальную прозрачность повторно прочитанного файла

REMOVE со светлым фоном даёт live-channel=0. Мы намеренно сохраняем этот результат как RGBA: при чтении reloaded-channel=1, хотя все 128000 пикселей непрозрачны. Две правые панели одинаковы; наличие канала и прозрачных пикселей — разные проверки.

<?php
declare(strict_types=1);
require __DIR__ . '/alpha-fixture.php';
$source = loadAlphaSource();
$card = clone $source;
if (!$card->setImageBackgroundColor('#e6edf1')) { throw new RuntimeException('Background failed'); }
if (!$card->setImageAlphaChannel(Imagick::ALPHACHANNEL_REMOVE)) { throw new RuntimeException('Remove failed'); }
$liveHas = $card->getImageAlphaChannel();
saveAlphaNative($card, 'delivery-rgba.png', true);
$reloaded = new Imagick(__DIR__ . '/delivery-rgba.png');
$reloadedHas = $reloaded->getImageAlphaChannel();
$counts = alphaCounts($reloaded);
saveAlphaComparison([alphaPreview($source, 'white'), alphaPreview($card, '#243c4d'), alphaPreview($reloaded, '#243c4d')], 'alpha-audit.png');
echo "alpha-audit.png\nlive-channel=" . (int)$liveHas . " reloaded-channel=" . (int)$reloadedHas . " zero=" . $counts['zero'] . " partial=" . $counts['partial'] . " opaque=" . $counts['opaque'] . "\n";

alpha-audit.png
live-channel=0 reloaded-channel=1 zero=0 partial=0 opaque=128000

Выбрать режим и извлечь карту alpha

Пусть $image уже содержит загруженную картинку: $image = new Imagick('source.png'); new создаёт объект, строка в кавычках — путь. $ обозначает переменную, = присваивает результат, -> вызывает метод этой картинки, () содержит аргументы, ; завершает инструкцию. :: обращается к именованной константе класса; например, ALPHACHANNEL_REMOVE выбирает режим удаления alpha с фоном. RGB — красная, зелёная и синяя компоненты; RGBA добавляет alpha: 0 прозрачно, 1 непрозрачно, промежуточное значение смешивает с подложкой.

:: обращается к именованной константе класса. В этой записи EXTRACT выбирает извлечение: исходная alpha становится непрозрачной серой картой, которую затем можно сохранить. Возвращённое true — статус, растр остаётся в $image:

$image->setImageAlphaChannel(Imagick::ALPHACHANNEL_EXTRACT);

В полных программах clone создаёт отдельную копию, чтобы оригинал остался доступен. ! означает отрицание; if (!$image->...) проверяет отказ setter; throw new RuntimeException прерывает цепочку. writeImage сохраняет результат в файл. Основа: объекты и методы, копия через clone, if, исключения.

Увидеть различие OFF, OPAQUE и удаления alpha с фоном

После входа на белом идут OFF, OPAQUE, REMOVE со светлым фоном, все показаны на тёмной подложке. OFF/OPAQUE открывают скрытые RGB: снаружи силуэта они чёрные. Только REMOVE смешивает край с выбранным фоном. opaque-reset.png сохраняет результат OPAQUE как RGBA со всеми A=1.

<?php
declare(strict_types=1);
require __DIR__ . '/alpha-fixture.php';
$source = loadAlphaSource();
$off = clone $source;
$opaque = clone $source;
$removed = clone $source;
if (!$off->setImageAlphaChannel(Imagick::ALPHACHANNEL_OFF)) { throw new RuntimeException('Off failed'); }
if (!$opaque->setImageAlphaChannel(Imagick::ALPHACHANNEL_OPAQUE)) { throw new RuntimeException('Opaque failed'); }
$removed->setImageBackgroundColor('#e6edf1');
if (!$removed->setImageAlphaChannel(Imagick::ALPHACHANNEL_REMOVE)) { throw new RuntimeException('Remove failed'); }
saveAlphaNative($opaque, 'opaque-reset.png', true);
saveAlphaComparison([alphaPreview($source, 'white'), alphaPreview($off, '#243c4d'), alphaPreview($opaque, '#243c4d'), alphaPreview($removed, '#243c4d')], 'alpha-modes.png');
echo "alpha-modes.png\n";

alpha-modes.png

Сделать отдельную непрозрачную карту alpha для проверки края

alpha-mask.png — самостоятельная RGB-карта: чёрное соответствует A=0, белое A=1, серое частичной прозрачности. Это непрозрачное изображение значений alpha, пригодное для осмотра и передачи в дальнейший явно выбранный алгоритм маскирования.

<?php
declare(strict_types=1);
require __DIR__ . '/alpha-fixture.php';
$source = loadAlphaSource();
$mask = clone $source;
if (!$mask->setImageAlphaChannel(Imagick::ALPHACHANNEL_EXTRACT)) { throw new RuntimeException('Extract failed'); }
saveAlphaNative($mask, 'alpha-mask.png', false);
saveAlphaComparison([alphaPreview($source, 'white'), $mask], 'alpha-mask-comparison.png');
echo "alpha-mask-comparison.png\n";

alpha-mask-comparison.png

Подготовить настройку и выпустить светлую или тёмную карточку

Пусть $image уже содержит загруженную картинку: $image = new Imagick('source.png'); new создаёт объект, строка в кавычках — путь. $ обозначает переменную, = присваивает результат, -> вызывает метод этой картинки, () содержит аргументы, ; завершает инструкцию. :: обращается к именованной константе класса; например, ALPHACHANNEL_REMOVE выбирает режим удаления alpha с фоном. RGB — красная, зелёная и синяя компоненты; RGBA добавляет alpha: 0 прозрачно, 1 непрозрачно, промежуточное значение смешивает с подложкой.

Строка #e6edf1 задаёт непрозрачные RGB 230/237/241 в обычной шестнадцатеричной записи цвета. Первый вызов только сохраняет настройку. Следующий REMOVE использует её для смешивания с активной alpha. Возвращённые true — статусы; ни один не возвращает новую картинку:

$image->setImageBackgroundColor('#e6edf1');
$image->setImageAlphaChannel(Imagick::ALPHACHANNEL_REMOVE);

В полных программах clone создаёт отдельную копию, чтобы оригинал остался доступен. ! означает отрицание; if (!$image->...) проверяет отказ setter; throw new RuntimeException прерывает цепочку. writeImage сохраняет результат в файл. Основа: объекты и методы, копия через clone, if, исключения.

Задать фон в настройке и отдельно применить его к пикселям

Первые две панели имеют одинаковые RGBA-пиксели: setter записал только настройку. background-staged.png остаётся прозрачным. Третья панель после REMOVE уже содержит светлый фон в самих пикселях.

<?php
declare(strict_types=1);
require __DIR__ . '/alpha-fixture.php';
$source = loadAlphaSource();
$staged = clone $source;
if (!$staged->setImageBackgroundColor('#e6edf1')) { throw new RuntimeException('Background failed'); }
saveAlphaNative($staged, 'background-staged.png', true);
$removed = clone $staged;
if (!$removed->setImageAlphaChannel(Imagick::ALPHACHANNEL_REMOVE)) { throw new RuntimeException('Remove failed'); }
saveAlphaComparison([alphaPreview($source, 'white'), alphaPreview($staged, 'white'), alphaPreview($removed, 'white')], 'background-setting.png');
echo "background-setting.png\n";

background-setting.png

Выпустить две скачиваемые карточки на разных фонах

Из одного RGBA-оригинала получены card-light-final.png и card-dark-final.png. Обе карточки RGB, включая фон отверстия ручки и сглаженный край. Новый фон выбирается до REMOVE; исходная наклейка остаётся отдельным прозрачным файлом.

<?php
declare(strict_types=1);
require __DIR__ . '/alpha-fixture.php';
$source = loadAlphaSource();
$light = clone $source;
$dark = clone $source;
if (!$light->setImageBackgroundColor('#e6edf1')) { throw new RuntimeException('Light background failed'); }
if (!$dark->setImageBackgroundColor('#243c4d')) { throw new RuntimeException('Dark background failed'); }
if (!$light->setImageAlphaChannel(Imagick::ALPHACHANNEL_REMOVE)) { throw new RuntimeException('Light remove failed'); }
if (!$dark->setImageAlphaChannel(Imagick::ALPHACHANNEL_REMOVE)) { throw new RuntimeException('Dark remove failed'); }
saveAlphaNative($light, 'card-light-final.png', false);
saveAlphaNative($dark, 'card-dark-final.png', false);
saveAlphaComparison([alphaPreview($source, 'white'), $light, $dark], 'background-cards.png');
echo "background-cards.png\n";

background-cards.png

Проверить результат и не потерять прозрачный оригинал

Результаты относятся к собственной RGBA-графике и проверенному окружению. Полупрозрачные края в сохранённом 8-битном PNG могут округляться; обратно восстановить удалённую alpha по карточке нельзя. Сохранение alpha не гарантирует одинаковую цветопередачу всех приложений; CMYK/PDF, профили, последовательности кадров и безопасность недоверенного reader — отдельные задачи. Все программы здесь CLI: они не отправляют HTTP-ответ и не проверяют загрузку через браузер. Для PNG-наклейки нужен формат с alpha; один выбор JPEG её не сохранит.

<?php
declare(strict_types=1);
function loadAlphaSource(): Imagick {
    $encoded = file_get_contents(__DIR__ . '/source.png.b64');
    if ($encoded === false) { throw new RuntimeException('Cannot read source.png.b64'); }
    $bytes = base64_decode($encoded, true);
    if ($bytes === false || hash('sha256', $bytes) !== 'f51e5780445e0f5130a7f23112b2a00618035afd5545b8e3042c7ccff09b617c') {
        throw new RuntimeException('Unexpected RGBA source bytes');
    }
    if (file_put_contents(__DIR__ . '/source.png', $bytes) === false) { throw new RuntimeException('Cannot restore source.png'); }
    return new Imagick(__DIR__ . '/source.png');
}
function alphaPreview(Imagick $image, string $background): Imagick {
    $canvas = new Imagick();
    $canvas->newImage($image->getImageWidth(), $image->getImageHeight(), $background);
    $canvas->compositeImage($image, Imagick::COMPOSITE_OVER, 0, 0);
    return $canvas;
}
function saveAlphaNative(Imagick $image, string $filename, bool $withAlpha): void {
    $saved = clone $image;
    $saved->setImageFormat('png');
    $saved->setImageDepth(8);
    $saved->setOption('png:color-type', $withAlpha ? '6' : '2');
    if (!$saved->writeImage(__DIR__ . '/' . $filename)) { throw new RuntimeException('Cannot save ' . $filename); }
}
function saveAlphaComparison(array $panels, string $filename): void {
    $width = 0; $height = 0;
    foreach ($panels as $panel) { $width += $panel->getImageWidth(); $height = max($height, $panel->getImageHeight()); }
    $canvas = new Imagick();
    $canvas->newImage($width, $height, 'white');
    $x = 0;
    foreach ($panels as $panel) {
        $canvas->compositeImage($panel, Imagick::COMPOSITE_OVER, $x, intdiv($height - $panel->getImageHeight(), 2));
        $x += $panel->getImageWidth();
    }
    saveAlphaNative($canvas, $filename, false);
}
function alphaCounts(Imagick $image): array {
    $Q = Imagick::getQuantumRange()['quantumRangeLong'];
    $values = $image->exportImagePixels(0, 0, $image->getImageWidth(), $image->getImageHeight(), 'A', Imagick::PIXEL_SHORT);
    $counts = ['zero' => 0, 'partial' => 0, 'opaque' => 0];
    foreach ($values as $alpha) {
        if ($alpha === 0) { ++$counts['zero']; }
        elseif ($alpha === $Q) { ++$counts['opaque']; }
        else { ++$counts['partial']; }
    }
    return $counts;
}

Самостоятельная карточка и следующий шаг

Упражнение: подготовить ещё одну карточку на белом фоне, сохранив отверстие ручки белым в самом файле. Решение: взять копию исходного $source, вызвать setImageBackgroundColor('white'), затем setImageAlphaChannel(Imagick::ALPHACHANNEL_REMOVE) и saveAlphaNative(...,false). Проверить угол (0,0) и отверстие (340,150): оба должны быть белыми, а RGB непрозрачных деталей — прежними. Этот вариант выполните отдельно; сохранённые свидетельства относятся к исходным восьми программам.

Для уменьшения видимости слоя с сохранением нулевых отверстий смотрите умножение alpha; для готовой композиции — тень и OVER; для рамки — границы и размеры PNG. Исторические setImageOpacity/setImageMatte остаются отдельными узлами полного справочника: этот пакет их не заменяет и не исключает. В текущей IM7-сборке старый setImageOpacity не нужно считать обязательной доступной альтернативой.