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

Получить самостоятельную карточку в правильном направлении

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

Понятия до схемы

Растр — сетка пикселей. Ширина W и высота H измеряются в пикселях; x растёт вправо, y вниз от верхнего левого угла. RGB — красная, зелёная и синяя компоненты, RGBA добавляет alpha: 0 пропускает фон, 1 полностью закрывает его. OVER накладывает этот слой на непрозрачную подложку только для просмотра. Нейтральный просмотр создаётся на новом холсте и не копирует метку: на первой панели видны именно хранимые пиксели. Буквы A/B/C/D, стрелка и текст — часть нашего исходного рисунка, не автоматически измеренные свойства.

Метка ориентации — отдельное указание, как показывать сетку. EXIF — один из способов хранить метаданные; в исходном PNG метка действительно записана в eXIf, а после записи библиотека также может использовать собственную запись PNG. Мы проверяем фактическое повторное чтение, не предполагаем одинаковое поведение всех просмотрщиков. Подпись пикселей — контрольная строка по их данным. SHA-256 — алгоритм хеширования: результат здесь записан 64 шестнадцатеричными символами, то есть цифрами 0–9 и буквами a–f. SHA файла охватывает все его байты, включая служебные записи; подпись текущего изображения вычисляется отдельно.

Самая маленькая запись

Растр — сетка хранимых пикселей. RGB задаёт красную, зелёную и синюю компоненты; RGBA добавляет alpha: 0 — прозрачный, 1 — непрозрачный. Ориентация — отдельное указание, как расположить растр при показе. $image — переменная с объектом изображения; $ начинает имя, = присваивает, -> вызывает метод, () содержит аргументы, ; заканчивает инструкцию. Imagick:: обращается к именованной константе класса. Число ORIENTATION_* не является углом. clone создаёт независимую рабочую копию.

$orientation = $image->getImageOrientation();
echo $orientation;

Пустые скобки означают отсутствие аргументов. Для нашего входа прочитано RIGHTTOP, в этой сборке код 6. Getter читает указание, не распознаёт верх фотографии по содержимому и не поворачивает пиксели. ORIENTATION_UNDEFINED сообщает, что надёжного указания нет; код 0 не является bool false.

В полных примерах if выбирает действие по условию, ! отрицает его, === сравнивает значение и тип, !== означает строгое неравенство; && требует выполнения обоих условий. (int) показывает bool как 1/0. echo выводит текст; printf подставляет %d как целое число, "\n" означает новую строку. __DIR__ — папка программы, . соединяет строки пути. if с throw new RuntimeException прекращает обработку при нарушении нашей проверки. Подробнее: объекты и методы, файлы, ошибки и исключения.

Для реального исправления используем autoOrient(): в проверенной Imagick 3.8.1 это контекстный метод без аргументов, который меняет текущую картинку и не возвращает bool или новый объект. Он доступен в исходнике при ImageMagick ≥ 6.9.2; на другой установке проверьте method_exists. Он выполняет нужное отражение/поворот по метке и выставляет TOPLEFT. Это не распознавание горизонта и не самостоятельный новый узел официального справочника. Не пишите $upright = $upright->autoOrient().

$upright = clone $image;
$upright->autoOrient();
$upright->setImageOrientation(Imagick::ORIENTATION_TOPLEFT);

Перед полной программой: $signatureBefore = $image->getImageSignature(); сохраняет контрольную строку до поворота, чтобы сравнить её с результатом. setImageOrientation(TOPLEFT) после autoOrient явно назначает обычное положение уже исправленному растру и возвращает bool-статус. <?php открывает PHP, declare(strict_types=1) включает строгие типы аргументов, require подключает открытый helper. new Imagick читает файл. Запись сохраняет PNG с восемью битами на компоненту, затем новый объект читает файл заново. Массив [$a, $b] объединяет панели; [] не поворачивает картинку. Проверка !== ниже сравнивает контрольные строки на различие. Изменение порядка пикселей меняет подпись на нашем асимметричном входе.

Сохранить правильно повёрнутую карточку с прозрачным окном

Самостоятельный upright.png имеет размер 320 × 400 и метку TOPLEFT. Текст читается прямо, окно остаётся прозрачным; два просмотра получены после чтения именно сохранённого PNG. Исходные пиксели 400 × 320 на первой панели показаны без автоматического поворота просмотрщиком.

<?php
declare(strict_types=1);
require __DIR__ . '/orientation-fixture.php';
restoreOrientationInput();
$source = new Imagick(__DIR__ . '/source.png');
$sourceWhite = orientationPreview($source);
$before = $source->getImageOrientation();
$signatureBefore = $source->getImageSignature();
$upright = clone $source;
$upright->autoOrient();
$upright->setImageOrientation(Imagick::ORIENTATION_TOPLEFT);
saveOrientationPNG($upright, 'upright.png', true);
$read = new Imagick(__DIR__ . '/upright.png');
$white = orientationPreview($read); $dark = orientationPreview($read, '#243c4d');
saveOrientationPNG($sourceWhite, 'source-preview8.png');
saveOrientationPNG($white, 'upright-white.png'); saveOrientationPNG($dark, 'upright-dark.png');
saveOrientationComparison([$sourceWhite, $white, $dark], 'orientation-first.png');
echo "orientation-first.png\nupright.png\nsource-preview8.png\nupright-white.png\nupright-dark.png\n";
printf("orientation=%d->%d size=%dx%d alpha=%d signature-changed=%d\n", $before, $read->getImageOrientation(), $read->getImageWidth(), $read->getImageHeight(), (int)$read->getImageAlphaChannel(), (int)($signatureBefore !== $read->getImageSignature()));

orientation-first.png
upright.png
source-preview8.png
upright-white.png
upright-dark.png
orientation=6->1 size=320x400 alpha=1 signature-changed=1

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

Самая маленькая запись

Растр — сетка хранимых пикселей. RGB задаёт красную, зелёную и синюю компоненты; RGBA добавляет alpha: 0 — прозрачный, 1 — непрозрачный. Ориентация — отдельное указание, как расположить растр при показе. $image — переменная с объектом изображения; $ начинает имя, = присваивает, -> вызывает метод, () содержит аргументы, ; заканчивает инструкцию. Imagick:: обращается к именованной константе класса. Число ORIENTATION_* не является углом. clone создаёт независимую рабочую копию.

$ok = $image->setImageOrientation(Imagick::ORIENTATION_TOPLEFT);

TOPLEFT говорит: пиксели уже стоят обычно. Делайте такое назначение, когда их происхождение известно, например сразу после физической нормализации. Метод возвращает true при успехе; результат изображения остаётся в $image. Если исходный растр лежит боком, одна эта строка не исправит его. Неверная метка может заставить другую программу показать его иначе.

В полных примерах if выбирает действие по условию, ! отрицает его, === сравнивает значение и тип, !== означает строгое неравенство; && требует выполнения обоих условий. (int) показывает bool как 1/0. echo выводит текст; printf подставляет %d как целое число, "\n" означает новую строку. __DIR__ — папка программы, . соединяет строки пути. if с throw new RuntimeException прекращает обработку при нарушении нашей проверки. Подробнее: объекты и методы, файлы, ошибки и исключения.

Увидеть, почему одна метка TOPLEFT не исправляет повёрнутый растр

Средняя панель остаётся боком: setter поменял только указание ориентации. Подпись потока пикселей тоже не изменилась. Последняя панель переставлена физически; метка 1 сама по себе не доказывает правильное положение предмета.

<?php
declare(strict_types=1);
require __DIR__ . '/orientation-fixture.php';
restoreOrientationInput();
$source = new Imagick(__DIR__ . '/source.png');
$sourceWhite = orientationPreview($source);
$tagOnly = clone $source;
$tagOnly->setImageOrientation(Imagick::ORIENTATION_TOPLEFT);
$upright = clone $source; $upright->autoOrient();
saveOrientationPNG($tagOnly, 'tag-only.png', true); saveOrientationPNG($upright, 'control-upright.png', true);
saveOrientationComparison([$sourceWhite, orientationPreview($tagOnly), orientationPreview($upright)], 'orientation-controls.png');
echo "orientation-controls.png\ntag-only.png\ncontrol-upright.png\n";
printf("tag=%d same-pixels=%d same-signature=%d upright=%d\n", $tagOnly->getImageOrientation(), (int)(orientationPixelHash($source) === orientationPixelHash($tagOnly)), (int)($source->getImageSignature() === $tagOnly->getImageSignature()), $upright->getImageOrientation());

orientation-controls.png
tag-only.png
control-upright.png
tag=1 same-pixels=1 same-signature=1 upright=1

Прочитать указание и проверить доставку после повторного чтения

Самая маленькая запись

Растр — сетка хранимых пикселей. RGB задаёт красную, зелёную и синюю компоненты; RGBA добавляет alpha: 0 — прозрачный, 1 — непрозрачный. Ориентация — отдельное указание, как расположить растр при показе. $image — переменная с объектом изображения; $ начинает имя, = присваивает, -> вызывает метод, () содержит аргументы, ; заканчивает инструкцию. Imagick:: обращается к именованной константе класса. Число ORIENTATION_* не является углом. clone создаёт независимую рабочую копию.

$orientation = $image->getImageOrientation();
echo $orientation;

Пустые скобки означают отсутствие аргументов. Для нашего входа прочитано RIGHTTOP, в этой сборке код 6. Getter читает указание, не распознаёт верх фотографии по содержимому и не поворачивает пиксели. ORIENTATION_UNDEFINED сообщает, что надёжного указания нет; код 0 не является bool false.

В полных примерах if выбирает действие по условию, ! отрицает его, === сравнивает значение и тип, !== означает строгое неравенство; && требует выполнения обоих условий. (int) показывает bool как 1/0. echo выводит текст; printf подставляет %d как целое число, "\n" означает новую строку. __DIR__ — папка программы, . соединяет строки пути. if с throw new RuntimeException прекращает обработку при нарушении нашей проверки. Подробнее: объекты и методы, файлы, ошибки и исключения.

Прочитать указание ориентации и решить, нужна ли нормализация

Getter возвращает целый код, здесь RIGHTTOP. Условие выбирает обработку, а сам getter ничего не поворачивает. UNDEFINED не сообщает, как предмет должен стоять: в минимальном примере мы не угадываем отсутствующую информацию.

<?php
declare(strict_types=1);
require __DIR__ . '/orientation-fixture.php';
restoreOrientationInput();
$source = new Imagick(__DIR__ . '/source.png');
$sourceWhite = orientationPreview($source);
$orientation = $source->getImageOrientation();
$needsNormalization = $orientation !== Imagick::ORIENTATION_TOPLEFT && $orientation !== Imagick::ORIENTATION_UNDEFINED;
$result = clone $source;
if ($needsNormalization) { $result->autoOrient(); }
saveOrientationPNG($result, 'getter-upright.png', true);
saveOrientationComparison([$sourceWhite, orientationPreview($result)], 'orientation-get.png');
echo "orientation-get.png\ngetter-upright.png\n";
printf("orientation=%d needs-normalization=%d result=%d\n", $orientation, (int)$needsNormalization, $result->getImageOrientation());

orientation-get.png
getter-upright.png
orientation=6 needs-normalization=1 result=1

Для второй задачи важно обработать уже готовый файл повторно и не повернуть его ещё раз по старому предположению. in_array(..., true) проверяет принадлежность разрешённому списку с учётом типа. Это выбранная проверка входа, не обещание автоматического отказа Imagick. У UNDEFINED нет достоверного направления: в таком проекте нужна отдельная договорённость с поставщиком или ручное решение.

Проверить направление после записи и безопасно обработать повторно

Для доставки наша политика требует известный код из восьми вариантов. После записи проверяем метку заново. Повторный autoOrient на нормализованном результате не меняет его пиксели в этой проверке; это помогает избежать повторного ручного поворота по старой метке.

<?php
declare(strict_types=1);
require __DIR__ . '/orientation-fixture.php';
restoreOrientationInput();
$source = new Imagick(__DIR__ . '/source.png');
$sourceWhite = orientationPreview($source);
$allowed = [Imagick::ORIENTATION_TOPLEFT, Imagick::ORIENTATION_TOPRIGHT, Imagick::ORIENTATION_BOTTOMRIGHT, Imagick::ORIENTATION_BOTTOMLEFT, Imagick::ORIENTATION_LEFTTOP, Imagick::ORIENTATION_RIGHTTOP, Imagick::ORIENTATION_RIGHTBOTTOM, Imagick::ORIENTATION_LEFTBOTTOM];
if (!in_array($source->getImageOrientation(), $allowed, true)) { throw new RuntimeException('Orientation needs a known policy'); }
$normalized = clone $source; $normalized->autoOrient();
saveOrientationPNG($normalized, 'delivery.png', true);
$delivery = new Imagick(__DIR__ . '/delivery.png');
if ($delivery->getImageOrientation() !== Imagick::ORIENTATION_TOPLEFT) { throw new RuntimeException('Delivery orientation is not normalized'); }
$second = clone $delivery; $second->autoOrient();
saveOrientationPNG($second, 'delivery-second.png', true);
saveOrientationComparison([$sourceWhite, orientationPreview($delivery), orientationPreview($second)], 'orientation-delivery-check.png');
echo "orientation-delivery-check.png\ndelivery.png\ndelivery-second.png\n";
printf("delivery=%d second-same=%d size=%dx%d\n", $delivery->getImageOrientation(), (int)(orientationPixelHash($delivery) === orientationPixelHash($second)), $delivery->getImageWidth(), $delivery->getImageHeight());

orientation-delivery-check.png
delivery.png
delivery-second.png
delivery=1 second-same=1 size=320x400

Назначать метку по известному происхождению и учитывать отражения

Самая маленькая запись

Растр — сетка хранимых пикселей. RGB задаёт красную, зелёную и синюю компоненты; RGBA добавляет alpha: 0 — прозрачный, 1 — непрозрачный. Ориентация — отдельное указание, как расположить растр при показе. $image — переменная с объектом изображения; $ начинает имя, = присваивает, -> вызывает метод, () содержит аргументы, ; заканчивает инструкцию. Imagick:: обращается к именованной константе класса. Число ORIENTATION_* не является углом. clone создаёт независимую рабочую копию.

$ok = $image->setImageOrientation(Imagick::ORIENTATION_TOPLEFT);

TOPLEFT говорит: пиксели уже стоят обычно. Делайте такое назначение, когда их происхождение известно, например сразу после физической нормализации. Метод возвращает true при успехе; результат изображения остаётся в $image. Если исходный растр лежит боком, одна эта строка не исправит его. Неверная метка может заставить другую программу показать его иначе.

В полных примерах if выбирает действие по условию, ! отрицает его, === сравнивает значение и тип, !== означает строгое неравенство; && требует выполнения обоих условий. (int) показывает bool как 1/0. echo выводит текст; printf подставляет %d как целое число, "\n" означает новую строку. __DIR__ — папка программы, . соединяет строки пути. if с throw new RuntimeException прекращает обработку при нарушении нашей проверки. Подробнее: объекты и методы, файлы, ошибки и исключения.

Исправить известную неверную метку уже правильно стоящих пикселей

Здесь положение пикселей известно: его только что получили физической нормализацией. Намеренно неверную метку 6 заменяем на 1 без второго поворота. Две последние нейтральные панели одинаковы по пикселям; потенциальное поведение стороннего просмотрщика не моделируется.

<?php
declare(strict_types=1);
require __DIR__ . '/orientation-fixture.php';
restoreOrientationInput();
$source = new Imagick(__DIR__ . '/source.png');
$sourceWhite = orientationPreview($source);
$alreadyUpright = clone $source; $alreadyUpright->autoOrient();
$wrongTag = clone $alreadyUpright;
$wrongTag->setImageOrientation(Imagick::ORIENTATION_RIGHTTOP);
$fixedTag = clone $wrongTag;
if (!$fixedTag->setImageOrientation(Imagick::ORIENTATION_TOPLEFT)) { throw new RuntimeException('Tag change failed'); }
saveOrientationPNG($fixedTag, 'fixed-tag.png', true);
$read = new Imagick(__DIR__ . '/fixed-tag.png');
saveOrientationComparison([$sourceWhite, orientationPreview($wrongTag), orientationPreview($read)], 'orientation-tag-repair.png');
echo "orientation-tag-repair.png\nfixed-tag.png\n";
printf("wrong=%d fixed=%d same-pixels=%d\n", $wrongTag->getImageOrientation(), $read->getImageOrientation(), (int)(orientationPixelHash($wrongTag) === orientationPixelHash($read)));

orientation-tag-repair.png
fixed-tag.png
wrong=6 fixed=1 same-pixels=1

Вторая задача — известный зеркальный источник. flopImage отражает растр слева направо; здесь это открытая подготовка контролируемого примера, а не автоматическое определение зеркальности. После такого отражения нашего входа корректирующее указание RIGHTBOTTOM означает поперечное отражение с перестановкой осей. Произвольной фотографии такой код по догадке назначать нельзя. Восемь действий из модели не сводятся к четырём поворотам: буквы в углах помогают заметить ошибочное отражение.

Описать известный зеркальный вход и получить обычную доставку

Собственное отражение исходника имеет известное происхождение. Для него назначаем RIGHTBOTTOM и затем нормализуем: сочетание отражения и перестановки осей возвращает читаемую карточку. Восемь orientation-вариантов включают четыре зеркальных; простой rotate на 90 градусов их все не заменяет.

<?php
declare(strict_types=1);
require __DIR__ . '/orientation-fixture.php';
restoreOrientationInput();
$source = new Imagick(__DIR__ . '/source.png');
$sourceWhite = orientationPreview($source);
$mirrored = clone $source;
$mirrored->flopImage();
$mirrored->setImageOrientation(Imagick::ORIENTATION_RIGHTBOTTOM);
saveOrientationPNG($mirrored, 'mirrored-tagged.png', true);
$normalized = clone $mirrored; $normalized->autoOrient();
$normalized->setImageOrientation(Imagick::ORIENTATION_TOPLEFT);
saveOrientationPNG($normalized, 'mirror-upright.png', true);
saveOrientationComparison([$sourceWhite, orientationPreview($mirrored), orientationPreview($normalized)], 'orientation-mirror.png');
echo "orientation-mirror.png\nmirrored-tagged.png\nmirror-upright.png\n";
printf("assigned=%d normalized=%d size=%dx%d\n", $mirrored->getImageOrientation(), $normalized->getImageOrientation(), $normalized->getImageWidth(), $normalized->getImageHeight());

orientation-mirror.png
mirrored-tagged.png
mirror-upright.png
assigned=7 normalized=1 size=320x400

Отличать точные данные, разные файлы и похожие изображения

Самая маленькая запись

Растр — сетка хранимых пикселей. RGB задаёт красную, зелёную и синюю компоненты; RGBA добавляет alpha: 0 — прозрачный, 1 — непрозрачный. Ориентация — отдельное указание, как расположить растр при показе. $image — переменная с объектом изображения; $ начинает имя, = присваивает, -> вызывает метод, () содержит аргументы, ; заканчивает инструкцию. Imagick:: обращается к именованной константе класса. Число ORIENTATION_* не является углом. clone создаёт независимую рабочую копию.

$signature = $image->getImageSignature();
echo $signature;

Подпись — короткая контрольная строка по данным, прочитанным библиотекой; SHA-256 — применённый алгоритм хеширования. Метод заново вычисляет её для текущего изображения. Для SHA байтов файла используется отдельная hash_file('sha256', $path). Подпись не определяет, правильно ли стоит предмет, и не оценивает похожесть фотографий. Сравнивайте в одной среде вместе с размерами, цветовой моделью, каналами и одинаковым правилом обработки.

В полных примерах if выбирает действие по условию, ! отрицает его, === сравнивает значение и тип, !== означает строгое неравенство; && требует выполнения обоих условий. (int) показывает bool как 1/0. echo выводит текст; printf подставляет %d как целое число, "\n" означает новую строку. __DIR__ — папка программы, . соединяет строки пути. if с throw new RuntimeException прекращает обработку при нарушении нашей проверки. Подробнее: объекты и методы, файлы, ошибки и исключения.

Отделить подпись пикселей от SHA двух сохранённых файлов

Оба файла записаны одним способом из одинаковых пикселей; у копии другой комментарий. Их SHA файлов различаются, подписи потоков пикселей и декодированные RGBA совпадают. Это проверка в одной сборке, а не универсальный идентификатор между любыми форматами и декодерами.

<?php
declare(strict_types=1);
require __DIR__ . '/orientation-fixture.php';
restoreOrientationInput();
$source = new Imagick(__DIR__ . '/source.png');
$sourceWhite = orientationPreview($source);
$copy = clone $source;
$copy->setImageProperty('comment', 'Another description; the same pixel stream');
$signatureA = $source->getImageSignature(); $signatureB = $copy->getImageSignature();
saveOrientationPNG($source, 'signature-a.png', true); saveOrientationPNG($copy, 'signature-b.png', true);
saveOrientationComparison([$sourceWhite, orientationPreview($copy)], 'orientation-signature-metadata.png');
echo "orientation-signature-metadata.png\nsignature-a.png\nsignature-b.png\n";
printf("signature-length=%d same-pixels=%d same-signature=%d same-file=%d\n", strlen($signatureA), (int)(orientationPixelHash($source) === orientationPixelHash($copy)), (int)($signatureA === $signatureB), (int)(hash_file('sha256', __DIR__ . '/signature-a.png') === hash_file('sha256', __DIR__ . '/signature-b.png')));

orientation-signature-metadata.png
signature-a.png
signature-b.png
signature-length=64 same-pixels=1 same-signature=1 same-file=0

Во второй задаче сравниваем доставку после приведения к одному направлению. getImageColorspace читает цветовую модель, getImageAlphaChannel — состояние канала, они дополняют размеры и подпись. Это ещё не полноценный поиск похожих фотографий. ImagickDraw ниже создаёт перо: setStrokeColor выбирает красный цвет линии, setStrokeWidth задаёт ширину 4 пикселя, line — её концы (40,247) и (280,247), drawImage наносит линию на копию. Такой видимый контроль меняет поток пикселей; повторная запись комментария его не меняет.

Проверить точную нормализованную копию и обнаружить видимую правку

Перед сравнением изображения приведены к одному направлению. Проверяем размеры, цветовую модель, состояние alpha и подпись в той же среде. Точная сохранённая копия проходит; добавленная красная линия меняет подпись. Сходные фотографии, антиалиасинг и поиск похожих изображений требуют другой задачи и критериев.

<?php
declare(strict_types=1);
require __DIR__ . '/orientation-fixture.php';
restoreOrientationInput();
$source = new Imagick(__DIR__ . '/source.png');
$sourceWhite = orientationPreview($source);
$normal = clone $source; $normal->autoOrient();
saveOrientationPNG($normal, 'signature-normal.png', true);
$copy = clone $normal; $copy->setImageProperty('comment', 'Same normalized delivery');
saveOrientationPNG($copy, 'signature-copy.png', true);
$read = new Imagick(__DIR__ . '/signature-copy.png');
$edited = clone $normal;
$pen = new ImagickDraw(); $pen->setStrokeColor('#c7413c'); $pen->setStrokeWidth(4); $pen->line(40, 247, 280, 247);
$edited->drawImage($pen); saveOrientationPNG($edited, 'signature-edited.png', true);
$sameGeometry = $normal->getImageWidth() === $read->getImageWidth() && $normal->getImageHeight() === $read->getImageHeight();
$sameContext = $normal->getImageColorspace() === $read->getImageColorspace() && $normal->getImageAlphaChannel() === $read->getImageAlphaChannel();
$exactCopy = $sameGeometry && $sameContext && $normal->getImageSignature() === $read->getImageSignature();
saveOrientationComparison([orientationPreview($normal), orientationPreview($read), orientationPreview($edited)], 'orientation-signature-delivery.png');
echo "orientation-signature-delivery.png\nsignature-normal.png\nsignature-copy.png\nsignature-edited.png\n";
printf("normalized-copy=%d edited-copy=%d geometry=%dx%d\n", (int)$exactCopy, (int)($normal->getImageSignature() === $edited->getImageSignature()), $normal->getImageWidth(), $normal->getImageHeight());

orientation-signature-delivery.png
signature-normal.png
signature-copy.png
signature-edited.png
normalized-copy=1 edited-copy=0 geometry=320x400

Проверять ошибки, alpha, запись и границы подписи

Обрабатывается текущее изображение, не автоматически все кадры анимации. Повороты на прямой угол здесь переставляют сетку, и размеры 400 × 320 становятся 320 × 400; принудительного растягивания или обрезки нет. Подпись заново проходит по данным, поэтому её вычисление имеет стоимость чтения изображения; абсолютных обещаний скорости не делаем.

<?php
declare(strict_types=1);
function restoreOrientationInput(): void {
    $text = file_get_contents(__DIR__ . '/source.png.b64');
    if ($text === false) { throw new RuntimeException('Input missing'); }
    $bytes = base64_decode($text, true);
    if ($bytes === false || hash('sha256', $bytes) !== 'c89a6a08a2f4354797ae7160357e96c72480c7ff8558da16d548a471350eaafa') { throw new RuntimeException('Input mismatch'); }
    if (file_put_contents(__DIR__ . '/source.png', $bytes) === false) { throw new RuntimeException('Restore failed'); }
}
function orientationPreview(Imagick $image, string $background = 'white'): Imagick {
    $view = new Imagick(); $view->newImage($image->getImageWidth(), $image->getImageHeight(), $background);
    $view->compositeImage($image, Imagick::COMPOSITE_OVER, 0, 0); return $view;
}
function saveOrientationPNG(Imagick $image, string $filename, bool $alpha = false): void {
    $copy = clone $image; $copy->setImageFormat('png'); $copy->setImageDepth(8);
    $copy->setOption('png:bit-depth', '8'); $copy->setOption('png:color-type', $alpha ? '6' : '2');
    if (!$copy->writeImage(__DIR__ . '/' . $filename)) { throw new RuntimeException('PNG write failed'); }
}
function saveOrientationComparison(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(); }
    saveOrientationPNG($canvas, $filename);
}
function orientationPixelHash(Imagick $image): string {
    return hash('sha256', json_encode($image->exportImagePixels(0, 0, $image->getImageWidth(), $image->getImageHeight(), 'RGBA', Imagick::PIXEL_DOUBLE), JSON_THROW_ON_ERROR));
}

TOPLEFT относится к ориентации, а не к виртуальной странице — дополнительным размерам и смещению холста. После некоторых отражений они могут отличаться от ширины и высоты пикселей. Для выбранного входа RIGHTTOP самостоятельный результат проверен с нулевым смещением. Если другому проекту нужен самостоятельный холст с началом в (0, 0), его виртуальную страницу следует проверить и при необходимости явно сбросить через setImagePage; один код TOPLEFT этого не обещает.

Выбрать обработку под достоверную метку и реального получателя

Упражнение: готовая карточка уже прямая, но поставщик оставил RIGHTTOP. Решение при подтверждённом происхождении — назначить TOPLEFT и проверить, что пиксели не изменились. Если исходные пиксели лежат боком и метка достоверна, сначала autoOrient, затем запись и повторное чтение. Для поиска похожих фотографий точная подпись не подходит: отдельный проект должен определить допустимые изменения.

Дальше: самостоятельные вставки и виртуальная страница, прозрачность и выбранный фон, формат и реальные байты файла, цветовые модели и преобразование. Существующие узлы rotate/flip/flop и контекстный autoOrient не меняют владельцев и не засчитываются как новые официальные API.