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

<?php
declare(strict_types=1);
require __DIR__ . '/colorspace-fixture.php';
restoreColorspaceInputs();
$source = new Imagick(__DIR__ . '/source.jpg');
$product = new Imagick(__DIR__ . '/product.png');
$requested = $source->getColorspace();
$gray = clone $source;
if (!$gray->transformImageColorspace(Imagick::COLORSPACE_GRAY)) { throw new RuntimeException('Gray conversion failed'); }
saveColorspacePNG($source, 'source-preview8.png');
saveColorspacePNG($gray, 'first-gray.png');
saveColorspaceComparison([$source, $gray], 'colorspace-first.png');
echo "colorspace-first.png\nsource-preview8.png\nfirst-gray.png\n";
printf("reader-setting=%d image=%d gray=%d\n", $requested, $source->getImageColorspace(), $gray->getImageColorspace());

Первый PNG показывает исходный цветной каталог и самостоятельный first-gray.png. Число 0 — настройка читателя без явного запроса пространства, 23 — sRGB текущего JPEG, 3 — GRAY результата. Значения не обозначают качество. Цветной исходник сохранён отдельно и не перезаписан. Запуск: сохраните example.php, colorspace-fixture.php, source.jpg.b64 и product.png.b64 в одной папке; оставьте также прочие файлы ZIP. Команда php example.php требует Imagick с JPEG/PNG. Helper восстанавливает оба входа по точным байтам; целевые три метода вызываются открыто в программе. Выходные PNG создаются при запуске, сеть и шрифты не нужны.

<?php
declare(strict_types=1);
require __DIR__ . '/colorspace-fixture.php';
restoreColorspaceInputs();
$source = new Imagick(__DIR__ . '/source.jpg');
$product = new Imagick(__DIR__ . '/product.png');
$configured = clone $source; $before = colorspaceRawHash($configured);
$configured->setColorspace(Imagick::COLORSPACE_YCBCR);
$rawSame = $before === colorspaceRawHash($configured);
$gray = clone $source; $gray->transformImageColorspace(Imagick::COLORSPACE_GRAY);
$reader = new Imagick(); $reader->setColorspace(Imagick::COLORSPACE_YCBCR);
$reader->readImage(__DIR__ . '/source.jpg');
$reader->transformImageColorspace(Imagick::COLORSPACE_SRGB);
saveColorspacePNG($configured, 'global-after-read.png');
saveColorspacePNG($gray, 'control-gray.png');
saveColorspacePNG($reader, 'control-reader-back.png');
saveColorspaceComparison([$source, $configured, $gray, $reader], 'colorspace-controls.png');
echo "colorspace-controls.png\nglobal-after-read.png\ncontrol-gray.png\ncontrol-reader-back.png\n";
printf("after-read raw-same=%d global=%d image=%d\n", (int)$rawSame, $configured->getColorspace(), $configured->getImageColorspace());

Вторая панель точна исходнику: запрос чтения изменён после чтения, но текущий растр остаётся sRGB. Третья получена настоящим преобразованием. Четвёртая прошла отдельный путь JPEG → YCbCr → sRGB; она близка обычному чтению, но точного равенства всех пикселей не обещаем. Запуск: сохраните example.php, colorspace-fixture.php, source.jpg.b64 и product.png.b64 в одной папке; оставьте также прочие файлы ZIP. Команда php example.php требует Imagick с JPEG/PNG. Helper восстанавливает оба входа по точным байтам; целевые три метода вызываются открыто в программе. Выходные PNG создаются при запуске, сеть и шрифты не нужны.

<?php
declare(strict_types=1);
require __DIR__ . '/colorspace-fixture.php';
restoreColorspaceInputs();
$source = new Imagick(__DIR__ . '/source.jpg');
$product = new Imagick(__DIR__ . '/product.png');
$reader = new Imagick(); $initial = $reader->getColorspace();
$reader->setColorspace(Imagick::COLORSPACE_YCBCR);
$configured = $reader->getColorspace();
$reader->readImage(__DIR__ . '/source.jpg'); $decodedSpace = $reader->getImageColorspace();
$reader->transformImageColorspace(Imagick::COLORSPACE_SRGB);
saveColorspacePNG($reader, 'get-reader-back.png');
saveColorspaceComparison([$source, $reader], 'colorspace-get.png');
echo "colorspace-get.png\nget-reader-back.png\n";
printf("initial=%d configured=%d decoded=%d displayed=%d retained-setting=%d\n", $initial, $configured, $decodedSpace, $reader->getImageColorspace(), $reader->getColorspace());

Getter сообщает настройку этого объекта: сначала 0, затем 27. После преобразования текущего изображения в sRGB настройка будущего чтения по-прежнему 27. Следовательно getColorspace не заменяет getImageColorspace. Запуск: сохраните example.php, colorspace-fixture.php, source.jpg.b64 и product.png.b64 в одной папке; оставьте также прочие файлы ZIP. Команда php example.php требует Imagick с JPEG/PNG. Helper восстанавливает оба входа по точным байтам; целевые три метода вызываются открыто в программе. Выходные PNG создаются при запуске, сеть и шрифты не нужны.

<?php
declare(strict_types=1);
require __DIR__ . '/colorspace-fixture.php';
restoreColorspaceInputs();
$source = new Imagick(__DIR__ . '/source.jpg');
$product = new Imagick(__DIR__ . '/product.png');
$reader = new Imagick(); $reader->setColorspace(Imagick::COLORSPACE_YCBCR);
$reader->readImage(__DIR__ . '/source.jpg');
$copy = clone $reader; $copy->clear(); $copy->setColorspace(Imagick::COLORSPACE_SRGB);
$copy->readImage(__DIR__ . '/source.jpg');
$parentSetting = $reader->getColorspace(); $copySetting = $copy->getColorspace();
$reader->transformImageColorspace(Imagick::COLORSPACE_SRGB);
saveColorspacePNG($reader, 'cloned-reader-back.png'); saveColorspacePNG($copy, 'cloned-default.png');
saveColorspaceComparison([$source, $reader, $copy], 'colorspace-reader-copy.png');
echo "colorspace-reader-copy.png\ncloned-reader-back.png\ncloned-default.png\n";
printf("parent-setting=%d copy-setting=%d parent-image=%d copy-image=%d\n", $parentSetting, $copySetting, $reader->getImageColorspace(), $copy->getImageColorspace());

Копия очищена и явно перенастроена перед новым чтением. Исходный объект сохранил запрос YCbCr; его изображение преобразовано отдельно. Последняя панель соответствует обычному sRGB-чтению. Изменение копии не является настройкой всего приложения. Запуск: сохраните example.php, colorspace-fixture.php, source.jpg.b64 и product.png.b64 в одной папке; оставьте также прочие файлы ZIP. Команда php example.php требует Imagick с JPEG/PNG. Helper восстанавливает оба входа по точным байтам; целевые три метода вызываются открыто в программе. Выходные PNG создаются при запуске, сеть и шрифты не нужны.

<?php
declare(strict_types=1);
require __DIR__ . '/colorspace-fixture.php';
restoreColorspaceInputs();
$source = new Imagick(__DIR__ . '/source.jpg');
$product = new Imagick(__DIR__ . '/product.png');
$reader = new Imagick();
if (!$reader->setColorspace(Imagick::COLORSPACE_YCBCR)) { throw new RuntimeException('Reader setting failed'); }
$reader->readImage(__DIR__ . '/source.jpg');
$triplet = $reader->exportImagePixels(80, 88, 1, 1, 'RGB', Imagick::PIXEL_DOUBLE);
$decodedSpace = $reader->getImageColorspace();
$reader->transformImageColorspace(Imagick::COLORSPACE_SRGB);
$gray = clone $reader; $gray->transformImageColorspace(Imagick::COLORSPACE_GRAY);
saveColorspacePNG($reader, 'requested-back.png'); saveColorspacePNG($gray, 'requested-gray.png');
saveColorspaceComparison([$source, $reader, $gray], 'colorspace-requested-reader.png');
echo "colorspace-requested-reader.png\nrequested-back.png\nrequested-gray.png\n";
printf("decoded=%d Y=%.6f Cb=%.6f Cr=%.6f; displayed=%d\n", $decodedSpace, $triplet[0], $triplet[1], $triplet[2], $reader->getImageColorspace());

До отображения снимаем числовую пробу Y/Cb/Cr в точке (80,88), затем явно преобразуем изображение в sRGB. Эти три числа не являются RGB-цветом. Отдельная серая производная нужна для макета без цвета; исходный JPEG не перекодируется. Запуск: сохраните example.php, colorspace-fixture.php, source.jpg.b64 и product.png.b64 в одной папке; оставьте также прочие файлы ZIP. Команда php example.php требует Imagick с JPEG/PNG. Helper восстанавливает оба входа по точным байтам; целевые три метода вызываются открыто в программе. Выходные PNG создаются при запуске, сеть и шрифты не нужны.

<?php
declare(strict_types=1);
require __DIR__ . '/colorspace-fixture.php';
restoreColorspaceInputs();
$source = new Imagick(__DIR__ . '/source.jpg');
$product = new Imagick(__DIR__ . '/product.png');
$reader = new Imagick(); $reader->setColorspace(Imagick::COLORSPACE_YCBCR);
$reader->readImage(__DIR__ . '/product.png');
$same = colorspaceRawHash($reader) === colorspaceRawHash($product);
$pngSpace = $reader->getImageColorspace();
$gray = clone $reader; $gray->transformImageColorspace(Imagick::COLORSPACE_GRAY);
$white = colorspacePreview($reader, 'white'); $grayWhite = colorspacePreview($gray, 'white');
saveColorspacePNG($reader, 'png-unchanged.png', true); saveColorspacePNG($gray, 'png-gray.png', true);
saveColorspacePNG($grayWhite, 'png-gray-white.png');
saveColorspaceComparison([$source, $white, $grayWhite], 'colorspace-png-boundary.png');
echo "colorspace-png-boundary.png\npng-unchanged.png\npng-gray.png\npng-gray-white.png\n";
printf("requested=%d PNG-image=%d raw-same=%d alpha-retained=%d\n", $reader->getColorspace(), $pngSpace, (int)$same, (int)($reader->exportImagePixels(0,0,400,320,'A',Imagick::PIXEL_DOUBLE)===$gray->exportImagePixels(0,0,400,320,'A',Imagick::PIXEL_DOUBLE)));

Запрос YCbCr остался настройкой, но PNG прочитан как sRGB с исходной RGBA. После настоящего преобразования серые значения изменились, alpha сохранилась. Белая подложка есть только в картинке просмотра; png-gray.png хранит прозрачность. Запуск: сохраните example.php, colorspace-fixture.php, source.jpg.b64 и product.png.b64 в одной папке; оставьте также прочие файлы ZIP. Команда php example.php требует Imagick с JPEG/PNG. Helper восстанавливает оба входа по точным байтам; целевые три метода вызываются открыто в программе. Выходные PNG создаются при запуске, сеть и шрифты не нужны.

<?php
declare(strict_types=1);
require __DIR__ . '/colorspace-fixture.php';
restoreColorspaceInputs();
$source = new Imagick(__DIR__ . '/source.jpg');
$product = new Imagick(__DIR__ . '/product.png');
$tagged = clone $source; $before = colorspaceRawHash($tagged);
if (!$tagged->setImageColorspace(Imagick::COLORSPACE_RGB)) { throw new RuntimeException('Image tag failed'); }
$same = $before === colorspaceRawHash($tagged); $tagSpace = $tagged->getImageColorspace();
$displayed = clone $tagged; $displayed->transformImageColorspace(Imagick::COLORSPACE_SRGB);
saveColorspacePNG($displayed, 'tag-linear-preview.png');
saveColorspaceComparison([$source, $displayed], 'colorspace-tag-consequence.png');
echo "colorspace-tag-consequence.png\ntag-linear-preview.png\n";
printf("tag=%d numeric-same=%d gamma=%.1f; converted=%d\n", $tagSpace, (int)$same, $tagged->getImageGamma(), $displayed->getImageColorspace());

setImageColorspace(RGB) сохранил числа этой RGB-пробы, но объявил их линейными. Следующее реальное преобразование в sRGB сделало картинку светлее. Это диагностический контрпример: менять метку известного sRGB ради слова RGB не нужно. Запуск: сохраните example.php, colorspace-fixture.php, source.jpg.b64 и product.png.b64 в одной папке; оставьте также прочие файлы ZIP. Команда php example.php требует Imagick с JPEG/PNG. Helper восстанавливает оба входа по точным байтам; целевые три метода вызываются открыто в программе. Выходные PNG создаются при запуске, сеть и шрифты не нужны.

<?php
declare(strict_types=1);
require __DIR__ . '/colorspace-fixture.php';
restoreColorspaceInputs();
$source = new Imagick(__DIR__ . '/source.jpg');
$product = new Imagick(__DIR__ . '/product.png');
$mislabeled = clone $product;
$mislabeled->setImageColorspace(Imagick::COLORSPACE_RGB);
$wrong = clone $mislabeled; $wrong->transformImageColorspace(Imagick::COLORSPACE_SRGB);
$repaired = clone $mislabeled;
if (!$repaired->setImageColorspace(Imagick::COLORSPACE_SRGB)) { throw new RuntimeException('Known tag repair failed'); }
$exact = colorspaceRawHash($repaired) === colorspaceRawHash($product);
$white = colorspacePreview($product, 'white'); $wrongWhite = colorspacePreview($wrong, 'white'); $repairedWhite = colorspacePreview($repaired, 'white');
saveColorspacePNG($wrong, 'tag-wrong.png', true); saveColorspacePNG($repaired, 'tag-repaired.png', true);
saveColorspacePNG($wrongWhite, 'tag-wrong-white.png'); saveColorspacePNG($repairedWhite, 'tag-repaired-white.png');
saveColorspaceComparison([$source, $wrongWhite, $repairedWhite], 'colorspace-known-tag-repair.png');
echo "colorspace-known-tag-repair.png\ntag-wrong.png\ntag-repaired.png\ntag-wrong-white.png\ntag-repaired-white.png\n";
printf("known-sRGB repair-exact=%d alpha-exact=%d repaired-space=%d\n", (int)$exact, (int)($product->exportImagePixels(0,0,400,320,'A',Imagick::PIXEL_DOUBLE)===$repaired->exportImagePixels(0,0,400,320,'A',Imagick::PIXEL_DOUBLE)), $repaired->getImageColorspace());

Мы сами испортили только обозначение собственного sRGB-источника, поэтому можем вернуть правильную метку без преобразования чисел. tag-repaired.png полностью равен входной наклейке по декодированным значениям RGBA; одинаковые PNG-байты не обещаем. Это решение для известного происхождения, а не угадывание пространства чужого CMYK/ICC-файла. Запуск: сохраните example.php, colorspace-fixture.php, source.jpg.b64 и product.png.b64 в одной папке; оставьте также прочие файлы ZIP. Команда php example.php требует Imagick с JPEG/PNG. Helper восстанавливает оба входа по точным байтам; целевые три метода вызываются открыто в программе. Выходные PNG создаются при запуске, сеть и шрифты не нужны.