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

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(360, 160, 'white');
$image->setImageFormat('png');
$theme = new ImagickDraw();
$theme->setTextDecoration(Imagick::DECORATION_UNDERLINE);
$decoration = $theme->getTextDecoration();
$draw = new ImagickDraw();
$draw->setResolution(72, 72);
$draw->setFont($font);
$draw->setFontSize(24);
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->setGravity(Imagick::GRAVITY_FORGET);
$draw->setTextAlignment(Imagick::ALIGN_LEFT);
$draw->setTextAntialias(true);
$draw->setTextDecoration(Imagick::DECORATION_NO);
$draw->setTextUnderColor('none');
$draw->setTextEncoding('UTF-8');
$draw->setTextDecoration($decoration);
$draw->annotation(20, 65, 'Проверено');
echo 'decoration=Underline; type=', get_debug_type($decoration), "\n";
$theme->clear();
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/copied-decoration.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'copied-decoration.png', "\n";
$image->clear();

Результат: copied-decoration.png 360×160. Надпись «Проверено» подчёркнута. Новый Draw получил int настройки из темы; getter не вернул готовую линию или рисунок. Шрифт, цвет и плотность нового объекта задаются отдельно. Перед именем файла консоль: decoration=Underline; type=int. Последняя строка — copied-decoration.png. Распакуйте архив целиком в отдельную папку и выполните php example.php при установленном PHP с imagick. PNG сохранится рядом с example.php: откройте его обычным просмотрщиком при 100%. Повторный запуск заменит одноимённый учебный файл. Font.php восстановит приложенный font.ttf без скачивания и установки.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(400, 180, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setResolution(72, 72);
$draw->setFont($font);
$draw->setFontSize(24);
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->setGravity(Imagick::GRAVITY_FORGET);
$draw->setTextAlignment(Imagick::ALIGN_LEFT);
$draw->setTextAntialias(true);
$draw->setTextDecoration(Imagick::DECORATION_LINETHROUGH);
$draw->setTextUnderColor('none');
$draw->setTextEncoding('UTF-8');
$previous = $draw->getTextDecoration();
$draw->setTextDecoration(Imagick::DECORATION_NO);
$draw->annotation(20, 50, 'Акция');
$draw->setTextDecoration($previous);
$draw->annotation(20, 110, '1 500 руб.');
echo 'restored=LineThrough', "\n";
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/restored-price-decoration.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'restored-price-decoration.png', "\n";
$image->clear();

Результат: restored-price-decoration.png 400×180. Сверху обычный заголовок «Акция», ниже зачёркнутые «1 500 руб.». Сохранённый getter enum участвует в восстановлении; он не считывает перечёркнутую линию с PNG и не меняет уже записанный заголовок. Перед именем файла консоль: restored=LineThrough. Последняя строка — restored-price-decoration.png. Распакуйте архив целиком в отдельную папку и выполните php example.php при установленном PHP с imagick. PNG сохранится рядом с example.php: откройте его обычным просмотрщиком при 100%. Повторный запуск заменит одноимённый учебный файл. Font.php восстановит приложенный font.ttf без скачивания и установки.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(640, 180, 'white');
$image->setImageFormat('png');
foreach ([Imagick::DECORATION_NO, Imagick::DECORATION_UNDERLINE, Imagick::DECORATION_OVERLINE, Imagick::DECORATION_LINETHROUGH] as $index => $decoration) {
    $draw = new ImagickDraw();
    $draw->setResolution(72, 72);
    $draw->setFont($font);
    $draw->setFontSize(24);
    $draw->setStrokeColor('none');
    $draw->setFillColor('#146c74');
    $draw->setGravity(Imagick::GRAVITY_FORGET);
    $draw->setTextAlignment(Imagick::ALIGN_LEFT);
    $draw->setTextAntialias(true);
    $draw->setTextDecoration(Imagick::DECORATION_NO);
    $draw->setTextUnderColor('none');
    $draw->setTextEncoding('UTF-8');
    $draw->setTextDecoration($decoration);
    $draw->annotation(20 + $index * 160, 60, 'Цена');
    $image->drawImage($draw);
    $draw->clear();
}
$path = __DIR__ . '/four-text-decorations.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'four-text-decorations.png', "\n";
$image->clear();

Результат: four-text-decorations.png 640×180. Четыре одинаковых «Цена» на y=60 с началами x=20,180,340,500: без линии, с подчёркиванием, с линией сверху и с зачёркиванием. Положение/толщина служебной линии определяются шрифтовыми метриками и renderer, а не произвольным CSS padding. Последняя строка — four-text-decorations.png. Распакуйте архив целиком в отдельную папку и выполните php example.php при установленном PHP с imagick. PNG сохранится рядом с example.php: откройте его обычным просмотрщиком при 100%. Повторный запуск заменит одноимённый учебный файл. Font.php восстановит приложенный font.ttf без скачивания и установки.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(400, 200, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setResolution(72, 72);
$draw->setFont($font);
$draw->setFontSize(24);
$draw->setStrokeColor('none');
$draw->setFillColor('#526b70');
$draw->setGravity(Imagick::GRAVITY_FORGET);
$draw->setTextAlignment(Imagick::ALIGN_LEFT);
$draw->setTextAntialias(true);
$draw->setTextDecoration(Imagick::DECORATION_LINETHROUGH);
$draw->setTextUnderColor('none');
$draw->setTextEncoding('UTF-8');
$draw->annotation(20, 65, '1 500 руб.');
$draw->setTextDecoration(Imagick::DECORATION_NO);
$draw->setFontSize(32);
$draw->setFillColor('#146c74');
$draw->annotation(20, 135, '1 250 руб.');
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/old-and-new-price.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'old-and-new-price.png', "\n";
$image->clear();

Результат: old-and-new-price.png 400×200. Верхняя цена 1 500 руб. серая и зачёркнутая, 24 пункта, baseline 65. Нижняя 1 250 руб. бирюзовая и без линии, 32 пункта, baseline 135. Сброс — именованная DECORATION_NO; текущий шрифт и холст позволяют обеим строкам поместиться. Последняя строка — old-and-new-price.png. Распакуйте архив целиком в отдельную папку и выполните php example.php при установленном PHP с imagick. PNG сохранится рядом с example.php: откройте его обычным просмотрщиком при 100%. Повторный запуск заменит одноимённый учебный файл. Font.php восстановит приложенный font.ttf без скачивания и установки.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(360, 160, 'white');
$image->setImageFormat('png');
$theme = new ImagickDraw();
$theme->setTextUnderColor('#ffe08a');
$under = $theme->getTextUnderColor();
$background = new ImagickDraw();
$background->setStrokeColor('none');
$background->setFillColor('#bdebe2');
$background->rectangle(10, 20, 350, 140);
$background->setFillColor('#c25732');
$background->rectangle(120, 20, 350, 140);
$image->drawImage($background);
$background->clear();
$draw = new ImagickDraw();
$draw->setResolution(72, 72);
$draw->setFont($font);
$draw->setFontSize(24);
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->setGravity(Imagick::GRAVITY_FORGET);
$draw->setTextAlignment(Imagick::ALIGN_LEFT);
$draw->setTextAntialias(true);
$draw->setTextDecoration(Imagick::DECORATION_NO);
$draw->setTextUnderColor('none');
$draw->setTextEncoding('UTF-8');
$draw->setTextUnderColor($under);
$draw->annotation(20, 80, 'Заказ готов');
echo 'under-type=', get_debug_type($under), "\n";
$theme->clear();
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/copied-text-background.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'copied-text-background.png', "\n";
$image->clear();

Результат: copied-text-background.png 360×160. Бирюзовый «Заказ готов» имеет золотистую подложку на двухцветной карточке. Getter дал отдельный ImagickPixel, и новый Draw явно получил этот цвет. Фон всего изображения не менялся. Перед именем файла консоль: under-type=ImagickPixel. Последняя строка — copied-text-background.png. Распакуйте архив целиком в отдельную папку и выполните php example.php при установленном PHP с imagick. PNG сохранится рядом с example.php: откройте его обычным просмотрщиком при 100%. Повторный запуск заменит одноимённый учебный файл. Font.php восстановит приложенный font.ttf без скачивания и установки.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(360, 160, 'white');
$image->setImageFormat('png');
$theme = new ImagickDraw();
$theme->setTextUnderColor('rgba(255,224,138,0.5)');
$under = $theme->getTextUnderColor();
$alpha = $under->getColorValue(Imagick::COLOR_ALPHA);
if ($alpha < 0.8) {
    $under->setColor('#ffe08a');
}
$background = new ImagickDraw();
$background->setStrokeColor('none');
$background->setFillColor('#bdebe2');
$background->rectangle(10, 20, 350, 140);
$background->setFillColor('#c25732');
$background->rectangle(120, 20, 350, 140);
$image->drawImage($background);
$background->clear();
$draw = new ImagickDraw();
$draw->setResolution(72, 72);
$draw->setFont($font);
$draw->setFontSize(24);
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->setGravity(Imagick::GRAVITY_FORGET);
$draw->setTextAlignment(Imagick::ALIGN_LEFT);
$draw->setTextAntialias(true);
$draw->setTextDecoration(Imagick::DECORATION_NO);
$draw->setTextUnderColor('none');
$draw->setTextEncoding('UTF-8');
$draw->setTextUnderColor($under);
$draw->annotation(20, 80, 'Заказ готов');
$original = $theme->getTextUnderColor();
echo 'theme-alpha=', round($original->getColorValue(Imagick::COLOR_ALPHA), 2), '; applied-alpha=', round($under->getColorValue(Imagick::COLOR_ALPHA), 2), "\n";
$theme->clear();
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/opaque-copy-for-status.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'opaque-copy-for-status.png', "\n";
$image->clear();

Результат: opaque-copy-for-status.png 360×160. Статус имеет непрозрачную золотистую подложку, а исходная тема сохраняет alpha около 0.5. Alpha прочитана нормализованным getColorValue(COLOR_ALPHA), округление касается только диагностики. Изменение ImagickPixel не действует на тему до отдельного setter. Перед именем файла консоль: theme-alpha=0.5; applied-alpha=1. Последняя строка — opaque-copy-for-status.png. Распакуйте архив целиком в отдельную папку и выполните php example.php при установленном PHP с imagick. PNG сохранится рядом с example.php: откройте его обычным просмотрщиком при 100%. Повторный запуск заменит одноимённый учебный файл. Font.php восстановит приложенный font.ttf без скачивания и установки.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(640, 180, 'white');
$image->setImageFormat('png');
$background = new ImagickDraw();
$background->setStrokeColor('none');
$background->setFillColor('#bdebe2');
$background->rectangle(10, 20, 630, 160);
$image->drawImage($background);
$background->clear();
foreach (['none', '#ffe08a', 'rgba(255,224,138,0.5)'] as $index => $color) {
    $draw = new ImagickDraw();
    $draw->setResolution(72, 72);
    $draw->setFont($font);
    $draw->setFontSize(24);
    $draw->setStrokeColor('none');
    $draw->setFillColor('#146c74');
    $draw->setGravity(Imagick::GRAVITY_FORGET);
    $draw->setTextAlignment(Imagick::ALIGN_LEFT);
    $draw->setTextAntialias(true);
    $draw->setTextDecoration(Imagick::DECORATION_NO);
    $draw->setTextUnderColor('none');
    $draw->setTextEncoding('UTF-8');
    $draw->setTextUnderColor($color);
    $draw->annotation(20 + $index * 210, 60, 'Цена');
    $image->drawImage($draw);
    $draw->clear();
}
$path = __DIR__ . '/three-text-backgrounds.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'three-text-backgrounds.png', "\n";
$image->clear();

Результат: three-text-backgrounds.png 640×180. Три «Цена» на одинаковой мятной подложке: без text undercolor, с непрозрачным #ffe08a и с тем же цветом при alpha 0.5. Последний смешивается с мятным фоном. Заливка букв остаётся бирюзовой во всех случаях; полунепрозрачный фон текста не делает буквы прозрачными. Последняя строка — three-text-backgrounds.png. Распакуйте архив целиком в отдельную папку и выполните php example.php при установленном PHP с imagick. PNG сохранится рядом с example.php: откройте его обычным просмотрщиком при 100%. Повторный запуск заменит одноимённый учебный файл. Font.php восстановит приложенный font.ttf без скачивания и установки.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(400, 220, 'white');
$image->setImageFormat('png');
$background = new ImagickDraw();
$background->setStrokeColor('none');
$background->setFillColor('#bdebe2');
$background->rectangle(10, 20, 390, 200);
$background->setFillColor('#c25732');
$background->rectangle(133, 20, 390, 200);
$image->drawImage($background);
$background->clear();
$draw = new ImagickDraw();
$draw->setResolution(72, 72);
$draw->setFont($font);
$draw->setFontSize(24);
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->setGravity(Imagick::GRAVITY_FORGET);
$draw->setTextAlignment(Imagick::ALIGN_LEFT);
$draw->setTextAntialias(true);
$draw->setTextDecoration(Imagick::DECORATION_NO);
$draw->setTextUnderColor('#ffe08a');
$draw->setTextEncoding('UTF-8');
$draw->annotation(35, 65, 'Готово');
$image->drawImage($draw);
$draw->clear();
$badge = new ImagickDraw();
$badge->setStrokeColor('none');
$badge->setFillColor('#ffe08a');
$badge->rectangle(20, 115, 180, 185);
$image->drawImage($badge);
$badge->clear();
$draw = new ImagickDraw();
$draw->setResolution(72, 72);
$draw->setFont($font);
$draw->setFontSize(24);
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->setGravity(Imagick::GRAVITY_FORGET);
$draw->setTextAlignment(Imagick::ALIGN_LEFT);
$draw->setTextAntialias(true);
$draw->setTextDecoration(Imagick::DECORATION_NO);
$draw->setTextUnderColor('none');
$draw->setTextEncoding('UTF-8');
$draw->setTextUnderColor('none');
$draw->annotation(35, 160, 'Готово');
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/status-background-and-padding.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'status-background-and-padding.png', "\n";
$image->clear();

Результат: status-background-and-padding.png 400×220. Два «Готово» на двухцветной карточке. У верхнего фон ограничен прямоугольником по метрикам. Нижний расположен внутри заранее нарисованного бейджа (20,115)—(180,185), поэтому вокруг него есть управляемое свободное место. Undercolor не является CSS padding и не рисует скругления автоматически. Последняя строка — status-background-and-padding.png. Распакуйте архив целиком в отдельную папку и выполните php example.php при установленном PHP с imagick. PNG сохранится рядом с example.php: откройте его обычным просмотрщиком при 100%. Повторный запуск заменит одноимённый учебный файл. Font.php восстановит приложенный font.ttf без скачивания и установки.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(360, 160, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setResolution(72, 72);
$draw->setFont($font);
$draw->setFontSize(24);
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->setGravity(Imagick::GRAVITY_FORGET);
$draw->setTextAlignment(Imagick::ALIGN_LEFT);
$draw->setTextAntialias(true);
$draw->setTextDecoration(Imagick::DECORATION_NO);
$draw->setTextUnderColor('none');
$observed = $draw->getTextEncoding();
if ($observed !== 'UTF-8') {
    $draw->setTextEncoding('UTF-8');
}
$draw->annotation(20, 65, 'Заказ № 42');
echo 'initial-encoding=', $observed === false ? 'unset' : ($observed === '' ? 'system-default' : $observed), '; effective=UTF-8', "\n";
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/explicit-encoding-policy.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'explicit-encoding-policy.png', "\n";
$image->clear();

Результат: explicit-encoding-policy.png 360×160. Видимая кириллическая подпись «Заказ № 42». В проверенной сборке исходная настройка false привела к явному выбору UTF-8. False — отсутствие заданной кодировки, а не повреждение файла или ошибка getter; исходные байты строки уже UTF-8. Перед именем файла консоль: initial-encoding=unset; effective=UTF-8. Последняя строка — explicit-encoding-policy.png. Распакуйте архив целиком в отдельную папку и выполните php example.php при установленном PHP с imagick. PNG сохранится рядом с example.php: откройте его обычным просмотрщиком при 100%. Повторный запуск заменит одноимённый учебный файл. Font.php восстановит приложенный font.ttf без скачивания и установки.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(360, 160, 'white');
$image->setImageFormat('png');
$theme = new ImagickDraw();
$theme->setTextEncoding('UTF-8');
$encoding = $theme->getTextEncoding();
if ($encoding !== 'UTF-8') {
    throw new LogicException('Компоненту нужна явная UTF-8 политика');
}
$bytes = file_get_contents(__DIR__ . '/label.txt');
if ($bytes === false || preg_match('//u', $bytes) !== 1) {
    throw new RuntimeException('Ожидался доступный UTF-8 файл label.txt');
}
$text = trim($bytes);
if ($text === '') {
    throw new RuntimeException('Подпись не должна быть пустой');
}
$draw = new ImagickDraw();
$draw->setResolution(72, 72);
$draw->setFont($font);
$draw->setFontSize(24);
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->setGravity(Imagick::GRAVITY_FORGET);
$draw->setTextAlignment(Imagick::ALIGN_LEFT);
$draw->setTextAntialias(true);
$draw->setTextDecoration(Imagick::DECORATION_NO);
$draw->setTextUnderColor('none');
$draw->setTextEncoding($encoding);
$draw->annotation(20, 65, $text);
echo 'encoding=', $encoding, '; input=valid', "\n";
$theme->clear();
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/label-from-utf8-file.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'label-from-utf8-file.png', "\n";
$image->clear();

Результат: label-from-utf8-file.png 360×160. В PNG находится «Заказ № 42», прочитанный из настоящего label.txt архива. Сохранённый getter string использован setter другого объекта, а preg_match отдельно подтвердил корректную последовательность UTF-8. Перевод строки в конце файла убирает trim. Перед именем файла консоль: encoding=UTF-8; input=valid. Последняя строка — label-from-utf8-file.png. Распакуйте архив целиком в отдельную папку и выполните php example.php при установленном PHP с imagick. PNG сохранится рядом с example.php: откройте его обычным просмотрщиком при 100%. Повторный запуск заменит одноимённый учебный файл. Font.php восстановит приложенный font.ttf без скачивания и установки.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(360, 160, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setResolution(72, 72);
$draw->setFont($font);
$draw->setFontSize(24);
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->setGravity(Imagick::GRAVITY_FORGET);
$draw->setTextAlignment(Imagick::ALIGN_LEFT);
$draw->setTextAntialias(true);
$draw->setTextDecoration(Imagick::DECORATION_NO);
$draw->setTextUnderColor('none');
$draw->setTextEncoding('UTF-8');
$draw->annotation(20, 65, 'Ёлка № 7');
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/utf8-cyrillic-label.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'utf8-cyrillic-label.png', "\n";
$image->clear();

Результат: utf8-cyrillic-label.png 360×160. Кириллическая надпись «Ёлка № 7» с буквой Ё и знаком №. Исходник сохранён в UTF-8, Draw получает UTF-8 и приложенный font содержит эти символы. Setter не создаёт нужные байты и не добавляет отсутствующие глифы. Последняя строка — utf8-cyrillic-label.png. Распакуйте архив целиком в отдельную папку и выполните php example.php при установленном PHP с imagick. PNG сохранится рядом с example.php: откройте его обычным просмотрщиком при 100%. Повторный запуск заменит одноимённый учебный файл. Font.php восстановит приложенный font.ttf без скачивания и установки.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(360, 160, 'white');
$image->setImageFormat('png');
$legacy = hex2bin('cff0e8e2e5f2');
if (preg_match('//u', $legacy) !== 1) {
    echo 'invalid-input=rejected', "\n";
} else {
    throw new LogicException('Учебные байты должны быть некорректным UTF-8');
}
$bytes = file_get_contents(__DIR__ . '/label.txt');
if ($bytes === false || preg_match('//u', $bytes) !== 1) {
    throw new RuntimeException('Ожидался доступный UTF-8 файл label.txt');
}
$text = trim($bytes);
if ($text === '') {
    throw new RuntimeException('Подпись не должна быть пустой');
}
$draw = new ImagickDraw();
$draw->setResolution(72, 72);
$draw->setFont($font);
$draw->setFontSize(24);
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->setGravity(Imagick::GRAVITY_FORGET);
$draw->setTextAlignment(Imagick::ALIGN_LEFT);
$draw->setTextAntialias(true);
$draw->setTextDecoration(Imagick::DECORATION_NO);
$draw->setTextUnderColor('none');
$draw->setTextEncoding('UTF-8');
$draw->annotation(20, 65, $text);
echo 'valid-input=rendered', "\n";
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/validated-utf8-input.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'validated-utf8-input.png', "\n";
$image->clear();

Результат: validated-utf8-input.png 360×160. PNG содержит правильное «Заказ № 42» из label.txt; некорректная последовательность не попала в annotation. Это отказ по контракту входа, а не попытка угадать кодировку или тихо выбросить русские буквы. Преобразование известной исходной кодировки потребовало бы отдельной явной операции конвертации. Перед именем файла консоль: invalid-input=rejected; valid-input=rendered. Последняя строка — validated-utf8-input.png. Распакуйте архив целиком в отдельную папку и выполните php example.php при установленном PHP с imagick. PNG сохранится рядом с example.php: откройте его обычным просмотрщиком при 100%. Повторный запуск заменит одноимённый учебный файл. Font.php восстановит приложенный font.ttf без скачивания и установки.