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

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 200, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setViewbox(0, 0, 360, 200);
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->roundRectangle(30, 30, 300, 170, 18, 18);
$draw->setFillColor('#ffe08a');
$draw->circle(245, 100, 280, 100);
$draw->setFillColor('none');
$draw->setStrokeColor('white');
$draw->setStrokeWidth(8);
$draw->polyline([['x' => 226, 'y' => 100], ['x' => 240, 'y' => 114], ['x' => 264, 'y' => 86]]);
$draw->setStrokeColor('none');
$draw->setFillColor('#bdebe2');
$draw->rectangle(55, 62, 175, 76);
$draw->rectangle(55, 95, 145, 109);
$draw->rectangle(55, 128, 165, 142);
$saved = $draw->getVectorGraphics();
if (!str_contains($saved, '<drawing-wand>') || !str_contains($saved, 'roundrectangle')) {
    throw new LogicException('Ожидался снимок своей очереди');
}
echo 'snapshot=string; command=roundrectangle', "\n";
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/exported-parcel.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'exported-parcel.png', "\n";
$image->clear();

Результат: exported-parcel.png 360×200. Бирюзовая карточка с тремя мятными строками и золотистым кругом с белой галочкой. Переменная $saved содержит XML DrawingWand с командами; PNG появляется отдельно после drawImage/writeImage. Консоль до имени файла: snapshot=string; command=roundrectangle. Распакуйте архив целиком в отдельную папку и выполните php example.php при PHP с imagick. Откройте PNG рядом с example.php обычным просмотрщиком при 100%. Повторный запуск заменит одноимённые учебные файлы. Шрифты, интернет и shell-команды этим примерам не нужны.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 200, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setViewbox(0, 0, 360, 200);
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->roundRectangle(30, 30, 300, 170, 18, 18);
$draw->setFillColor('#ffe08a');
$draw->circle(245, 100, 280, 100);
$draw->setFillColor('none');
$draw->setStrokeColor('white');
$draw->setStrokeWidth(8);
$draw->polyline([['x' => 226, 'y' => 100], ['x' => 240, 'y' => 114], ['x' => 264, 'y' => 86]]);
$draw->setStrokeColor('none');
$draw->setFillColor('#bdebe2');
$draw->rectangle(55, 62, 175, 76);
$draw->rectangle(55, 95, 145, 109);
$draw->rectangle(55, 128, 165, 142);
$saved = $draw->getVectorGraphics();
$templatePath = __DIR__ . '/drawing.xml';
if (file_put_contents($templatePath, $saved) !== strlen($saved)) {
    throw new RuntimeException('Снимок записан не полностью');
}
$loaded = file_get_contents($templatePath);
if ($loaded === false || $loaded !== $saved) {
    throw new RuntimeException('Снимок не прочитан точно');
}
$replay = new ImagickDraw();
$replay->setVectorGraphics($loaded);
$image->drawImage($replay);
echo 'drawing.xml=written-and-read; replay=ready', "\n";
$draw->clear();
$replay->clear();
$path = __DIR__ . '/parcel-from-saved-file.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'parcel-from-saved-file.png', "\n";
$image->clear();

Результат: parcel-from-saved-file.png 360×200. Та же карточка восстановлена из реально созданного drawing.xml. В файле остаются команды, а в PNG — пиксели их исполнения. Это снимок для совместимого DrawingWand; не обещана бессрочная совместимость разных ImageMagick и не гарантируется наличие внешних шрифтов/изображений. Консоль до имени файла: drawing.xml=written-and-read; replay=ready. Распакуйте архив целиком в отдельную папку и выполните php example.php при PHP с imagick. Откройте PNG рядом с example.php обычным просмотрщиком при 100%. Повторный запуск заменит одноимённые учебные файлы. Шрифты, интернет и shell-команды этим примерам не нужны.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 200, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setViewbox(0, 0, 360, 200);
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->roundRectangle(30, 30, 300, 170, 18, 18);
$draw->setFillColor('#ffe08a');
$draw->circle(245, 100, 280, 100);
$draw->setFillColor('none');
$draw->setStrokeColor('white');
$draw->setStrokeWidth(8);
$draw->polyline([['x' => 226, 'y' => 100], ['x' => 240, 'y' => 114], ['x' => 264, 'y' => 86]]);
$draw->setStrokeColor('none');
$draw->setFillColor('#bdebe2');
$draw->rectangle(55, 62, 175, 76);
$draw->rectangle(55, 95, 145, 109);
$draw->rectangle(55, 128, 165, 142);
$saved = $draw->getVectorGraphics();
$replay = new ImagickDraw();
if (!$replay->setVectorGraphics($saved)) {
    throw new RuntimeException('Не удалось восстановить свой рисунок');
}
$image->drawImage($replay);
$draw->clear();
$replay->clear();
$path = __DIR__ . '/restored-parcel.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'restored-parcel.png', "\n";
$image->clear();

Результат: restored-parcel.png 360×200. Карточка восстановлена из строки, полученной своим getVectorGraphics. В проверенной сборке строка уже содержит drawing-wand и передана без дополнительного root. Setter не читает PNG и не преобразует произвольный SVG. Распакуйте архив целиком в отдельную папку и выполните php example.php при PHP с imagick. Откройте PNG рядом с example.php обычным просмотрщиком при 100%. Повторный запуск заменит одноимённые учебные файлы. Шрифты, интернет и shell-команды этим примерам не нужны.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 200, 'white');
$image->setImageFormat('png');
$xml = file_get_contents(__DIR__ . '/parcel.xml');
if ($xml === false || strlen($xml) > 10000 || hash('sha256', $xml) !== 'ab402d53b98109a3ea3bf9f75d09229a8270c79ad4ad4425e28b61ea318e4ae0') {
    throw new RuntimeException('Ожидался неизменённый приложенный parcel.xml');
}
$draw = new ImagickDraw();
if (!$draw->setVectorGraphics($xml)) {
    throw new RuntimeException('Шаблон не импортирован');
}
$image->drawImage($draw);
echo 'parcel.xml=verified; replay=ready', "\n";
$draw->clear();
$path = __DIR__ . '/parcel-from-trusted-template.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'parcel-from-trusted-template.png', "\n";
$image->clear();

Результат: parcel-from-trusted-template.png 360×200. Карточка 360×200 восстановлена из parcel.xml, который находится в архиве. Известный шаблон содержит только фиксированные векторные команды, без путей к ресурсам и шрифтов. Не принимайте такие команды напрямую от посетителя сайта и не считайте успешный XML-разбор полной проверкой будущей растеризации. Консоль до имени файла: parcel.xml=verified; replay=ready. Распакуйте архив целиком в отдельную папку и выполните php example.php при PHP с imagick. Откройте PNG рядом с example.php обычным просмотрщиком при 100%. Повторный запуск заменит одноимённые учебные файлы. Шрифты, интернет и shell-команды этим примерам не нужны.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 200, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->rectangle(20, 50, 120, 150);
try {
    $draw->render();
    throw new LogicException('В проверенной сборке ожидался отказ отдельного Draw');
} catch (ImagickException $error) {
    echo 'render=ImagickException; fallback=drawImage', "\n";
}
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/render-diagnostic-fallback.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'render-diagnostic-fallback.png', "\n";
$image->clear();

Результат: render-diagnostic-fallback.png 360×200. Видимый бирюзовый квадрат создан вызовом $image->drawImage($draw). Вызов $draw->render() реально выполнен и обработан как ImagickException; создание отдельного $image не связало его с внутренним Draw. Это пример диагностированного отказа и рабочей замены, а не успешного render(). Консоль до имени файла: render=ImagickException; fallback=drawImage. Распакуйте архив целиком в отдельную папку и выполните php example.php при PHP с imagick. Откройте PNG рядом с example.php обычным просмотрщиком при 100%. Повторный запуск заменит одноимённые учебные файлы. Шрифты, интернет и shell-команды этим примерам не нужны.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 200, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setViewbox(0, 0, 360, 200);
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->roundRectangle(30, 30, 300, 170, 18, 18);
$draw->setFillColor('#ffe08a');
$draw->circle(245, 100, 280, 100);
$draw->setFillColor('none');
$draw->setStrokeColor('white');
$draw->setStrokeWidth(8);
$draw->polyline([['x' => 226, 'y' => 100], ['x' => 240, 'y' => 114], ['x' => 264, 'y' => 86]]);
$draw->setStrokeColor('none');
$draw->setFillColor('#bdebe2');
$draw->rectangle(55, 62, 175, 76);
$draw->rectangle(55, 95, 145, 109);
$draw->rectangle(55, 128, 165, 142);
$saved = $draw->getVectorGraphics();
try {
    $draw->render();
    throw new LogicException('Ожидался диагностический отказ render');
} catch (ImagickException $error) {
    echo 'render=handled; separate-canvas=not-bound', "\n";
}
$replay = new ImagickDraw();
$replay->setVectorGraphics($saved);
$image->drawImage($replay);
echo 'drawImage=rendered', "\n";
$draw->clear();
$replay->clear();
$path = __DIR__ . '/parcel-after-render-diagnostic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'parcel-after-render-diagnostic.png', "\n";
$image->clear();

Результат: parcel-after-render-diagnostic.png 360×200. PNG с реальной карточкой создан рабочим drawImage после обработанного отказа render. Снимок взят до диагностического вызова. Точный текст native-ошибки зависит от сборки, поэтому пользовательская диагностика опирается на класс исключения, а не на английское сообщение с номером строки C. Консоль до имени файла: render=handled; separate-canvas=not-bound; drawImage=rendered. Распакуйте архив целиком в отдельную папку и выполните php example.php при PHP с imagick. Откройте PNG рядом с example.php обычным просмотрщиком при 100%. Повторный запуск заменит одноимённые учебные файлы. Шрифты, интернет и shell-команды этим примерам не нужны.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 200, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->rectangle(20, 50, 120, 150);
$draw->resetVectorGraphics();
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->rectangle(220, 50, 320, 150);
$image->drawImage($draw);
echo 'old-rectangle=removed; new-rectangle=teal', "\n";
$draw->clear();
$path = __DIR__ . '/reset-before-raster.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'reset-before-raster.png', "\n";
$image->clear();

Результат: reset-before-raster.png 360×200. Слева белое место: старая фигура была удалена из очереди до её исполнения. Справа бирюзовый квадрат. После reset настройки заново записаны командами перед новой фигурой; готовые пиксели reset не стирал. Консоль до имени файла: old-rectangle=removed; new-rectangle=teal. Распакуйте архив целиком в отдельную папку и выполните php example.php при PHP с imagick. Откройте PNG рядом с example.php обычным просмотрщиком при 100%. Повторный запуск заменит одноимённые учебные файлы. Шрифты, интернет и shell-команды этим примерам не нужны.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(600, 200, 'white');
$image->setImageFormat('png');
$original = new ImagickDraw();
$original->setStrokeColor('none');
$original->setFillColor('#146c74');
$original->rectangle(20, 50, 120, 150);
$image->drawImage($original);
$original->resetVectorGraphics();
$retained = $original->getFillColor()->getColor();
if ($retained['r'] !== 20 || $retained['g'] !== 108 || $retained['b'] !== 116) {
    throw new LogicException('Ожидалась сохранённая настройка fill');
}
$original->rectangle(220, 50, 320, 150);
$image->drawImage($original);
$original->resetVectorGraphics();
$original->setStrokeColor('none');
$original->setFillColor('#146c74');
$original->rectangle(420, 50, 520, 150);
$image->drawImage($original);
echo 'fill-getter=teal; commands=reapplied', "\n";
$original->clear();
$path = __DIR__ . '/reset-settings-versus-commands.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'reset-settings-versus-commands.png', "\n";
$image->clear();

Результат: reset-settings-versus-commands.png 600×200. Три квадрата: бирюзовый (20..120), чёрный (220..320), бирюзовый (420..520), все y=50..150. В середине показан намеренный неправильный результат после удаления команд настройки; справа — явная повторная запись fill/stroke. Reset не равен clear и не стирает уже нарисованный левый квадрат. Консоль до имени файла: fill-getter=teal; commands=reapplied. Распакуйте архив целиком в отдельную папку и выполните php example.php при PHP с imagick. Откройте PNG рядом с example.php обычным просмотрщиком при 100%. Повторный запуск заменит одноимённые учебные файлы. Шрифты, интернет и shell-команды этим примерам не нужны.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 200, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setViewbox(0, 0, 360, 200);
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->rectangle(20, 50, 120, 150);
$saved = $draw->getVectorGraphics();
if (!str_contains($saved, 'viewbox 0 0 360 200')) {
    throw new LogicException('Размер не записан в команды');
}
$image->drawImage($draw);
echo 'viewbox=0,0,360,200; PNG=360x200', "\n";
$draw->clear();
$path = __DIR__ . '/viewbox-matches-canvas.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'viewbox-matches-canvas.png', "\n";
$image->clear();

Результат: viewbox-matches-canvas.png 360×200. Квадрат от (20,50) до (120,150) на холсте 360×200. Viewbox записывает границы рисунка в векторные данные; реальный PNG 360×200 создан ранее newImage. Четыре числа — две пары координат, а не ширина/высота и не команда resize. Консоль до имени файла: viewbox=0,0,360,200; PNG=360x200. Распакуйте архив целиком в отдельную папку и выполните php example.php при PHP с imagick. Откройте PNG рядом с example.php обычным просмотрщиком при 100%. Повторный запуск заменит одноимённые учебные файлы. Шрифты, интернет и shell-команды этим примерам не нужны.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(600, 200, 'white');
$image->setImageFormat('png');
foreach ([100, 200, 100] as $index => $right) {
    $draw = new ImagickDraw();
    $draw->setViewbox(0, 0, $right, 200);
    $draw->translate(200 * $index, 0);
    if ($index === 2) {
        $draw->scale(1.5, 1.5);
    }
    $draw->setStrokeColor('none');
    $draw->setFillColor('#146c74');
    $draw->rectangle(20, 40, 80, 100);
    $image->drawImage($draw);
    $draw->clear();
}
echo 'viewbox-only=same-geometry; explicit-scale=1.5', "\n";
$path = __DIR__ . '/viewbox-does-not-resize-pixels.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'viewbox-does-not-resize-pixels.png', "\n";
$image->clear();

Результат: viewbox-does-not-resize-pixels.png 600×200. Слева и в центре два одинаковых квадрата 60×60 по геометрии, несмотря на right_x 100 и 200. Справа scale(1.5,1.5) даёт квадрат 90×90. Сам PNG по-прежнему 600×200. Viewbox не заменяет scale/resize и не подбирает размер текста под прямоугольник. Консоль до имени файла: viewbox-only=same-geometry; explicit-scale=1.5. Распакуйте архив целиком в отдельную папку и выполните php example.php при PHP с imagick. Откройте PNG рядом с example.php обычным просмотрщиком при 100%. Повторный запуск заменит одноимённые учебные файлы. Шрифты, интернет и shell-команды этим примерам не нужны.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 200, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->rectangle(20, 50, 120, 150);
$draw->comment('asset=warehouse-parcel-v1');
$saved = $draw->getVectorGraphics();
if (!str_contains($saved, 'asset=warehouse-parcel-v1')) {
    throw new LogicException('Служебная пометка не сохранена');
}
$image->drawImage($draw);
echo 'comment=saved-in-vector; visible-label=no', "\n";
$draw->clear();
$path = __DIR__ . '/comment-is-not-a-label.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'comment-is-not-a-label.png', "\n";
$image->clear();

Результат: comment-is-not-a-label.png 360×200. Только бирюзовый квадрат; слова asset=warehouse-parcel-v1 на PNG нет. Комментарий записан в поток команд для человека, читающего снимок, и не рисуется как annotation. Служебная пометка не является защищённым журналом или метаданными PNG. Консоль до имени файла: comment=saved-in-vector; visible-label=no. Распакуйте архив целиком в отдельную папку и выполните php example.php при PHP с imagick. Откройте PNG рядом с example.php обычным просмотрщиком при 100%. Повторный запуск заменит одноимённые учебные файлы. Шрифты, интернет и shell-команды этим примерам не нужны.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(400, 200, 'white');
$image->setImageFormat('png');
foreach ([false, true] as $index => $withComment) {
    $draw = new ImagickDraw();
    $draw->translate(200 * $index, 0);
    if ($withComment) {
        $draw->comment('stage=parcel-body');
    }
    $draw->setStrokeColor('none');
    $draw->setFillColor('#146c74');
    $draw->rectangle(20, 40, 160, 160);
    if ($withComment) {
        $draw->comment('stage=confirmation-mark');
    }
    $draw->setFillColor('#ffe08a');
    $draw->circle(90, 100, 125, 100);
    $saved = $draw->getVectorGraphics();
    if ($withComment && !str_contains($saved, 'stage=confirmation-mark')) {
        throw new LogicException('Пометка не попала в снимок');
    }
    $image->drawImage($draw);
    $draw->clear();
}
echo 'comments=two; expected-pixel-difference=0', "\n";
$path = __DIR__ . '/comments-do-not-change-pixels.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'comments-do-not-change-pixels.png', "\n";
$image->clear();

Результат: comments-do-not-change-pixels.png 400×200. Два бирюзовых прямоугольника с золотистыми кругами. В правом потоке есть две служебные пометки, в левом нет; сравнение соответствующих 200×200 панелей даёт одинаковые пиксели. Для видимой надписи нужен annotation и подходящий font, а не comment. Консоль до имени файла: comments=two; expected-pixel-difference=0. Распакуйте архив целиком в отдельную папку и выполните php example.php при PHP с imagick. Откройте PNG рядом с example.php обычным просмотрщиком при 100%. Повторный запуск заменит одноимённые учебные файлы. Шрифты, интернет и shell-команды этим примерам не нужны.