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

<?php
declare(strict_types=1);
require __DIR__ . '/type-fixture.php';
restoreTypeInputs();
$source = new Imagick(__DIR__ . '/source.png');
$catalogue = new Imagick(__DIR__ . '/catalogue.png');
$sourceWhite = typePreview($source, 'white');
$before = $source->getImageType();
$gray = clone $source;
if (!$gray->setImageType(Imagick::IMGTYPE_GRAYSCALEMATTE)) { throw new RuntimeException('Gray alpha conversion failed'); }
$gray->setImageFormat('png'); $gray->setImageDepth(8); $gray->setOption('png:bit-depth', '8');
if (!$gray->writeImage(__DIR__ . '/gray-sticker.png')) { throw new RuntimeException('PNG write failed'); }
$read = new Imagick(__DIR__ . '/gray-sticker.png');
$white = typePreview($read, 'white'); $dark = typePreview($read, '#243c4d');
saveTypePreview($sourceWhite, 'source-preview8.png'); saveTypePreview($read, 'first-gray-decoded.png', true);
saveTypePreview($white, 'first-gray-white.png'); saveTypePreview($dark, 'first-gray-dark.png');
saveTypeComparison([$sourceWhite, $white, $dark], 'types-first.png');
echo "types-first.png\ngray-sticker.png\nsource-preview8.png\nfirst-gray-decoded.png\nfirst-gray-white.png\nfirst-gray-dark.png\n";
printf("source-type=%d gray-type=%d read-type=%d alpha=%d\n", $before, $gray->getImageType(), $read->getImageType(), (int)$read->getImageAlphaChannel());

Получается самостоятельный gray-sticker.png с серыми значениями и alpha. Оба просмотра взяты после повторного чтения именно этого файла; тёмный фон показывает сохранённые отверстия. Числа 7/3 — коды типов этой сборки, не файловые форматы. Поле gray-type=7 читается после подготовки и записи, а read-type=3 относится к заново открытому серому файлу; это не непосредственный результат setter. Для запуска нужны example.php, type-fixture.php, source.png.b64 и catalogue.png.b64 в одной папке; сохраните остальные файлы ZIP. Команда php example.php с Imagick/PNG, без сети и шрифтов. Оба входа восстанавливаются из Base64 с проверкой SHA. Выходные PNG создаются программой, не выдаются за входы архива. Helper и все три целевые операции открыты ниже.

<?php
declare(strict_types=1);
require __DIR__ . '/type-fixture.php';
restoreTypeInputs();
$source = new Imagick(__DIR__ . '/source.png');
$catalogue = new Imagick(__DIR__ . '/catalogue.png');
$sourceWhite = typePreview($source, 'white');
$grayA = clone $source; $grayA->setImageType(Imagick::IMGTYPE_GRAYSCALEMATTE);
$plain = clone $source; $plain->setImageType(Imagick::IMGTYPE_GRAYSCALE);
$plain->setImageFormat('png'); $plain->setImageDepth(8); $plain->setOption('png:bit-depth', '8');
if (!$plain->writeImage(__DIR__ . '/plain-gray.png')) { throw new RuntimeException('Plain gray write failed'); }
$readPlain = new Imagick(__DIR__ . '/plain-gray.png');
$white = typePreview($grayA, 'white'); $dark = typePreview($grayA, '#243c4d');
saveTypePreview($grayA, 'control-gray-alpha.png', true); saveTypePreview($readPlain, 'control-plain-decoded.png');
saveTypePreview($white, 'control-gray-white.png'); saveTypePreview($dark, 'control-gray-dark.png');
saveTypeComparison([$sourceWhite, $white, $readPlain, $dark], 'types-controls.png');
echo "types-controls.png\nplain-gray.png\ncontrol-gray-alpha.png\ncontrol-plain-decoded.png\ncontrol-gray-white.png\ncontrol-gray-dark.png\n";
printf("MATTE-use-alpha=%d GRAY-use-alpha=%d saved-GRAY-alpha=%d\n", (int)$grayA->getImageAlphaChannel(), (int)$plain->getImageAlphaChannel(), (int)$readPlain->getImageAlphaChannel());

GRAYSCALEMATTE оставляет прозрачность, GRAYSCALE отключает её использование. У обычного серого файла исчезло прозрачное окно: скрытый RGB теперь виден. Это контрпример, а не готовая наклейка на выбранном фоне. Старые значения alpha могли остаться в текущем объекте; режим их смешивания и файл проверяем отдельно. Для запуска нужны example.php, type-fixture.php, source.png.b64 и catalogue.png.b64 в одной папке; сохраните остальные файлы ZIP. Команда php example.php с Imagick/PNG, без сети и шрифтов. Оба входа восстанавливаются из Base64 с проверкой SHA. Выходные PNG создаются программой, не выдаются за входы архива. Helper и все три целевые операции открыты ниже.

<?php
declare(strict_types=1);
require __DIR__ . '/type-fixture.php';
restoreTypeInputs();
$source = new Imagick(__DIR__ . '/source.png');
$catalogue = new Imagick(__DIR__ . '/catalogue.png');
$sourceWhite = typePreview($source, 'white');
$neutral = clone $catalogue;
$neutral->setImageType(Imagick::IMGTYPE_GRAYSCALE);
$neutral->setImageType(Imagick::IMGTYPE_TRUECOLOR);
$liveType = $neutral->getImageType();
$neutral->setImageFormat('png'); $neutral->setImageDepth(8); $neutral->setOption('png:bit-depth', '8');
if (!$neutral->writeImage(__DIR__ . '/neutral-auto.png')) { throw new RuntimeException('Neutral write failed'); }
$read = new Imagick(__DIR__ . '/neutral-auto.png');
saveTypePreview($neutral, 'neutral-live.png'); saveTypePreview($read, 'neutral-decoded.png');
saveTypeComparison([$sourceWhite, $neutral, $read], 'types-get.png');
echo "types-get.png\nneutral-auto.png\nneutral-live.png\nneutral-decoded.png\n";
printf("live-type=%d read-type=%d format=%s\n", $liveType, $read->getImageType(), $read->getImageFormat());

Серые числа могут находиться в текущем TRUECOLOR-изображении. Getter перед записью сообщает 6; кодировщик сохраняет серый PNG, повторное чтение даёт 2. Две последние панели выглядят одинаково. Формат PNG узнаём отдельным getImageFormat, не из IMGTYPE. Для запуска нужны example.php, type-fixture.php, source.png.b64 и catalogue.png.b64 в одной папке; сохраните остальные файлы ZIP. Команда php example.php с Imagick/PNG, без сети и шрифтов. Оба входа восстанавливаются из Base64 с проверкой SHA. Выходные PNG создаются программой, не выдаются за входы архива. Helper и все три целевые операции открыты ниже.

<?php
declare(strict_types=1);
require __DIR__ . '/type-fixture.php';
restoreTypeInputs();
$source = new Imagick(__DIR__ . '/source.png');
$catalogue = new Imagick(__DIR__ . '/catalogue.png');
$sourceWhite = typePreview($source, 'white');
$opaque = clone $catalogue; $opaque->setImageType(Imagick::IMGTYPE_TRUECOLORMATTE);
$sourceType = $source->getImageType(); $opaqueType = $opaque->getImageType();
$a = $source->exportImagePixels(0, 0, 400, 320, 'A', Imagick::PIXEL_DOUBLE);
$b = $opaque->exportImagePixels(0, 0, 400, 320, 'A', Imagick::PIXEL_DOUBLE);
$opaqueWhite = typePreview($opaque, 'white'); $dark = typePreview($source, '#243c4d');
saveTypePreview($opaque, 'opaque-catalogue-alpha.png', true); saveTypePreview($dark, 'getter-source-dark.png');
saveTypeComparison([$sourceWhite, $opaqueWhite, $dark], 'types-alpha-diagnostic.png');
echo "types-alpha-diagnostic.png\nopaque-catalogue-alpha.png\ngetter-source-dark.png\n";
printf("source-type=%d alpha-min=%.1f; opaque-type=%d alpha-min=%.1f\n", $sourceType, min($a), $opaqueType, min($b));

Оба объекта дают 7, но только наклейка имеет alpha меньше 1. У каталога канал активен и полностью непрозрачен. Тип не заменяет проверку значений alpha и пригодности файла. Для запуска нужны example.php, type-fixture.php, source.png.b64 и catalogue.png.b64 в одной папке; сохраните остальные файлы ZIP. Команда php example.php с Imagick/PNG, без сети и шрифтов. Оба входа восстанавливаются из Base64 с проверкой SHA. Выходные PNG создаются программой, не выдаются за входы архива. Helper и все три целевые операции открыты ниже.

<?php
declare(strict_types=1);
require __DIR__ . '/type-fixture.php';
restoreTypeInputs();
$source = new Imagick(__DIR__ . '/source.png');
$catalogue = new Imagick(__DIR__ . '/catalogue.png');
$sourceWhite = typePreview($source, 'white');
$gray = clone $source;
if (!$gray->setImageType(Imagick::IMGTYPE_GRAYSCALEMATTE)) { throw new RuntimeException('Gray alpha conversion failed'); }
$gray->setImageFormat('png'); $gray->setImageDepth(8); $gray->setOption('png:bit-depth', '8');
if (!$gray->writeImage(__DIR__ . '/gray-minimal.png')) { throw new RuntimeException('Gray PNG write failed'); }
$read = new Imagick(__DIR__ . '/gray-minimal.png'); $white = typePreview($read, 'white');
saveTypePreview($read, 'gray-minimal-decoded.png', true); saveTypePreview($white, 'gray-minimal-white.png');
saveTypeComparison([$sourceWhite, $white], 'types-gray.png');
echo "types-gray.png\ngray-minimal.png\ngray-minimal-decoded.png\ngray-minimal-white.png\n";
printf("converted-type=%d read-type=%d alpha=%d\n", $gray->getImageType(), $read->getImageType(), (int)$read->getImageAlphaChannel());

GRAYSCALEMATTE преобразует цветные компоненты и сохраняет исходную alpha данного RGBA. Поле converted-type=7 снято уже после подготовки и записи, а read-type=3 — с повторно открытого файла. Серый файл с alpha и RGB/RGBA-просмотр — разные представления одного результата; белая подложка относится только к просмотру. Для запуска нужны example.php, type-fixture.php, source.png.b64 и catalogue.png.b64 в одной папке; сохраните остальные файлы ZIP. Команда php example.php с Imagick/PNG, без сети и шрифтов. Оба входа восстанавливаются из Base64 с проверкой SHA. Выходные PNG создаются программой, не выдаются за входы архива. Helper и все три целевые операции открыты ниже.

<?php
declare(strict_types=1);
require __DIR__ . '/type-fixture.php';
restoreTypeInputs();
$source = new Imagick(__DIR__ . '/source.png');
$catalogue = new Imagick(__DIR__ . '/catalogue.png');
$sourceWhite = typePreview($source, 'white');
$palette = clone $catalogue; $palette->setImageArtifact('dither', 'false');
if (!$palette->setImageType(Imagick::IMGTYPE_PALETTE)) { throw new RuntimeException('Palette conversion failed'); }
$unpacked = clone $palette;
if (!$unpacked->setImageType(Imagick::IMGTYPE_TRUECOLOR)) { throw new RuntimeException('Truecolor conversion failed'); }
$same = typeRawHash($palette) === typeRawHash($unpacked);
$palette->setImageFormat('png'); $palette->setImageDepth(8); $palette->setOption('png:bit-depth', '8');
$unpacked->setImageFormat('png'); $unpacked->setImageDepth(8); $unpacked->setOption('png:bit-depth', '8');
if (!$palette->writeImage(__DIR__ . '/palette-catalogue.png') || !$unpacked->writeImage(__DIR__ . '/unpacked-catalogue.png')) { throw new RuntimeException('Palette files failed'); }
$a = new Imagick(__DIR__ . '/palette-catalogue.png'); $b = new Imagick(__DIR__ . '/unpacked-catalogue.png');
saveTypePreview($a, 'palette-decoded.png'); saveTypePreview($b, 'unpacked-decoded.png');
saveTypeComparison([$sourceWhite, $catalogue, $a, $b], 'types-palette.png');
echo "types-palette.png\npalette-catalogue.png\nunpacked-catalogue.png\npalette-decoded.png\nunpacked-decoded.png\n";
printf("palette-live=%d unpacked-live=%d colors=%d/%d same-values=%d read=%d/%d\n", $palette->getImageType(), $unpacked->getImageType(), $palette->getImageColors(), $unpacked->getImageColors(), (int)$same, $a->getImageType(), $b->getImageType());

На этом входе палитра использует 169 цветов; это не обещанные 256 и не число записей PLTE. TRUECOLOR меняет организацию хранения, но не возвращает утраченные оттенки: обе последние панели точны друг другу. PNG-кодировщик снова выбрал палитру и для распакованной копии. Для запуска нужны example.php, type-fixture.php, source.png.b64 и catalogue.png.b64 в одной папке; сохраните остальные файлы ZIP. Команда php example.php с Imagick/PNG, без сети и шрифтов. Оба входа восстанавливаются из Base64 с проверкой SHA. Выходные PNG создаются программой, не выдаются за входы архива. Helper и все три целевые операции открыты ниже.

<?php
declare(strict_types=1);
require __DIR__ . '/type-fixture.php';
restoreTypeInputs();
$source = new Imagick(__DIR__ . '/source.png');
$catalogue = new Imagick(__DIR__ . '/catalogue.png');
$sourceWhite = typePreview($source, 'white');
$gray = clone $source; $gray->setImageType(Imagick::IMGTYPE_GRAYSCALEMATTE);
$natural = clone $gray; $natural->setImageFormat('png'); $natural->setImageDepth(8); $natural->setOption('png:bit-depth', '8');
if (!$natural->writeImage(__DIR__ . '/gray-natural.png')) { throw new RuntimeException('Natural write failed'); }
$requested = clone $gray; $before = typeRawHash($requested);
if (!$requested->setType(Imagick::IMGTYPE_TRUECOLORMATTE)) { throw new RuntimeException('Writer setting failed'); }
$same = $before === typeRawHash($requested); $liveType = $requested->getImageType();
$requested->setImageFormat('png'); $requested->setImageDepth(8); $requested->setOption('png:bit-depth', '8');
if (!$requested->writeImage(__DIR__ . '/gray-requested-rgba.png')) { throw new RuntimeException('Requested write failed'); }
$a = new Imagick(__DIR__ . '/gray-natural.png'); $b = new Imagick(__DIR__ . '/gray-requested-rgba.png');
saveTypePreview($a, 'natural-gray-decoded.png', true); saveTypePreview($b, 'requested-rgba-decoded.png', true);
saveTypeComparison([$sourceWhite, typePreview($a, 'white'), typePreview($b, 'white')], 'types-writer-request.png');
echo "types-writer-request.png\ngray-natural.png\ngray-requested-rgba.png\nnatural-gray-decoded.png\nrequested-rgba-decoded.png\n";
printf("live-type=%d setting-numeric-noop=%d natural-read=%d requested-read=%d\n", $liveType, (int)$same, $a->getImageType(), $b->getImageType());

setType не изменил числовые значения и текущий тип 3. При записи PNG запрос TRUECOLORMATTE дал RGBA-хранение, тогда как обычная запись дала grayscale+alpha. После чтения getter отражает новое представление файла; внешний вид одинаков. Для запуска нужны example.php, type-fixture.php, source.png.b64 и catalogue.png.b64 в одной папке; сохраните остальные файлы ZIP. Команда php example.php с Imagick/PNG, без сети и шрифтов. Оба входа восстанавливаются из Base64 с проверкой SHA. Выходные PNG создаются программой, не выдаются за входы архива. Helper и все три целевые операции открыты ниже.

<?php
declare(strict_types=1);
require __DIR__ . '/type-fixture.php';
restoreTypeInputs();
$source = new Imagick(__DIR__ . '/source.png');
$catalogue = new Imagick(__DIR__ . '/catalogue.png');
$sourceWhite = typePreview($source, 'white');
$gray = clone $source; $gray->setImageType(Imagick::IMGTYPE_GRAYSCALEMATTE);
$flat = typePreview($gray, '#e6edf1');
$flat->setType(Imagick::IMGTYPE_TRUECOLOR); $flat->setImageFormat('png'); $flat->setImageDepth(8); $flat->setOption('png:bit-depth', '8');
if (!$flat->writeImage(__DIR__ . '/opaque-delivery.png')) { throw new RuntimeException('Opaque delivery failed'); }
$overridden = clone $gray; $overridden->setType(Imagick::IMGTYPE_TRUECOLORMATTE);
$overridden->setImageFormat('png'); $overridden->setImageDepth(8); $overridden->setOption('png:bit-depth', '8');
$overridden->setOption('png:color-type', '2');
if (!$overridden->writeImage(__DIR__ . '/override-rgb.png')) { throw new RuntimeException('Override write failed'); }
$a = new Imagick(__DIR__ . '/opaque-delivery.png'); $b = new Imagick(__DIR__ . '/override-rgb.png');
$white = typePreview($b, 'white'); $dark = typePreview($b, '#243c4d');
saveTypePreview($a, 'opaque-delivery-decoded.png'); saveTypePreview($b, 'override-decoded.png', true);
saveTypePreview($white, 'override-white.png'); saveTypePreview($dark, 'override-dark.png');
saveTypeComparison([$sourceWhite, $a, $white, $dark], 'types-writer-policy.png');
echo "types-writer-policy.png\nopaque-delivery.png\noverride-rgb.png\nopaque-delivery-decoded.png\noverride-decoded.png\noverride-white.png\noverride-dark.png\n";
printf("flattened-alpha=%d overridden-reload-alpha=%d\n", (int)$a->getImageAlphaChannel(), (int)$b->getImageAlphaChannel());

Непрозрачная доставка сначала получает выбранный светлый фон через OVER, затем RGB-хранение. Отдельный контрпример задаёт PNG color-type 2 поверх запроса RGBA: настройка PNG имеет приоритет. RGB-файл сохранил чёрный прозрачный ключ tRNS, но потерял исходные промежуточные alpha; один IHDR не доказывает непрозрачность. Для запуска нужны example.php, type-fixture.php, source.png.b64 и catalogue.png.b64 в одной папке; сохраните остальные файлы ZIP. Команда php example.php с Imagick/PNG, без сети и шрифтов. Оба входа восстанавливаются из Base64 с проверкой SHA. Выходные PNG создаются программой, не выдаются за входы архива. Helper и все три целевые операции открыты ниже.