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

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(320, 180, 'white');
$image->setImageFormat('png');
$theme = new ImagickDraw();
$theme->setGravity(Imagick::GRAVITY_SOUTHEAST);
$gravity = $theme->getGravity();
$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_UNDEFINED);
$draw->setTextAntialias(true);
$draw->setGravity($gravity);
$draw->annotation(20, 20, 'Готово');
echo 'gravity=SouthEast; type=', get_debug_type($gravity), "\n";
$theme->clear();
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/copied-corner.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'copied-corner.png', "\n";
$image->clear();

Результат: copied-corner.png 320×180. Бирюзовое «Готово» находится возле правого нижнего угла, с отступами 20 в принятом gravity-контексте. Из темы скопирован int enum, а не пиксели: новый Draw отдельно получил шрифт, плотность, цвет, ALIGN_UNDEFINED и прочитанную привязку. Перед именем файла консоль: gravity=SouthEast; type=int. Последняя строка — copied-corner.png. Все четыре файла подготовки шрифта включены в архив. Распакуйте архив целиком в отдельную папку. При установленном PHP с imagick выполните в ней php example.php; PNG появится рядом с example.php и откроется обычным просмотрщиком изображений. Повторный запуск заменит одноимённый учебный PNG.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(320, 180, 'white');
$image->setImageFormat('png');
$theme = new ImagickDraw();
$theme->setGravity(Imagick::GRAVITY_CENTER);
$theme->setTextAlignment(Imagick::ALIGN_RIGHT);
$gravity = $theme->getGravity();
$alignment = $theme->getTextAlignment();
$allowed = [Imagick::GRAVITY_NORTHWEST, Imagick::GRAVITY_CENTER, Imagick::GRAVITY_SOUTHEAST];
if (!in_array($gravity, $allowed, true)) {
    $gravity = Imagick::GRAVITY_NORTHWEST;
}
$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_UNDEFINED);
$draw->setTextAntialias(true);
$draw->setGravity($gravity);
$draw->setTextAlignment(Imagick::ALIGN_UNDEFINED);
$draw->annotation(0, 0, 'Заказ');
echo 'policy=canvas-anchor; inherited-alignment=', $alignment === Imagick::ALIGN_RIGHT ? 'Right' : 'other', "\n";
$theme->clear();
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/normalized-anchor-policy.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'normalized-anchor-policy.png', "\n";
$image->clear();

Результат: normalized-anchor-policy.png 320×180. «Заказ» размещён возле центра холста с gravity Center и Undefined alignment. Мы не рисуем ошибочную исходную пару и не выдаём её getter за доказательство результата. Для иной привязки потребуются соответствующие осмысленные отступы, а не автоматическое применение (0,0). Перед именем файла консоль: policy=canvas-anchor; inherited-alignment=Right. Последняя строка — normalized-anchor-policy.png. Font.php получает данные из этого же архива. Распакуйте архив целиком в отдельную папку. При установленном PHP с imagick выполните в ней php example.php; PNG появится рядом с example.php и откроется обычным просмотрщиком изображений. Повторный запуск заменит одноимённый учебный PNG.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(320, 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_NORTHWEST);
$draw->setTextAlignment(Imagick::ALIGN_UNDEFINED);
$draw->setTextAntialias(true);
$draw->annotation(20, 20, 'Готово');
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/northwest-caption.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'northwest-caption.png', "\n";
$image->clear();

Результат: northwest-caption.png 320×180. Бирюзовое «Готово» расположено возле левого верхнего угла. В этой политике NORTHWEST и ALIGN_UNDEFINED координаты (20,20) задают смещение от привязки, а не базовую линию y=20. Верх окрашенных букв зависит от метрик шрифта; не выводите универсальную формулу из одной картинки. Последняя строка — northwest-caption.png. Все четыре файла подготовки шрифта включены в архив. Распакуйте архив целиком в отдельную папку. При установленном PHP с imagick выполните в ней php example.php; PNG появится рядом с example.php и откроется обычным просмотрщиком изображений. Повторный запуск заменит одноимённый учебный PNG.

<?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('#146c74');
$draw->setGravity(Imagick::GRAVITY_NORTHWEST);
$draw->setTextAlignment(Imagick::ALIGN_UNDEFINED);
$draw->setTextAntialias(true);
$draw->annotation(20, 20, 'Заказ № 42');
$draw->setGravity(Imagick::GRAVITY_SOUTHEAST);
$draw->setFontSize(18);
$draw->setFillColor('#c25732');
$draw->annotation(20, 20, 'Готово');
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/opposite-corner-captions.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'opposite-corner-captions.png', "\n";
$image->clear();

Результат: opposite-corner-captions.png 400×200. Заголовок «Заказ № 42» бирюзовый, 24 пункта, у верхнего левого угла; оранжевый статус «Готово», 18 пунктов, у нижнего правого. Отступы каждой annotation равны (20,20) в её привязке. Изменение gravity перед второй командой не переставляет уже записанный заголовок. Последняя строка — opposite-corner-captions.png. Font.php получает данные из этого же архива. Распакуйте архив целиком в отдельную папку. При установленном PHP с imagick выполните в ней php example.php; PNG появится рядом с example.php и откроется обычным просмотрщиком изображений. Повторный запуск заменит одноимённый учебный PNG.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(320, 180, 'white');
$image->setImageFormat('png');
$theme = new ImagickDraw();
$theme->setTextAlignment(Imagick::ALIGN_RIGHT);
$alignment = $theme->getTextAlignment();
$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_UNDEFINED);
$draw->setTextAntialias(true);
$draw->setTextAlignment($alignment);
$draw->annotation(300, 90, '1 250 руб.');
echo 'alignment=Right; type=', get_debug_type($alignment), "\n";
$theme->clear();
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/copied-amount-alignment.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'copied-amount-alignment.png', "\n";
$image->clear();

Результат: copied-amount-alignment.png 320×180. Цена выровнена правым краем относительно опоры x=300, базовая линия y=90. Getter дал настройку Right, которая явно передана новому Draw с GRAVITY_FORGET; ширина цены не измерялась и готовая надпись не копировалась. Перед именем файла консоль: alignment=Right; type=int. Последняя строка — copied-amount-alignment.png. Все четыре файла подготовки шрифта включены в архив. Распакуйте архив целиком в отдельную папку. При установленном PHP с imagick выполните в ней php example.php; PNG появится рядом с example.php и откроется обычным просмотрщиком изображений. Повторный запуск заменит одноимённый учебный PNG.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(320, 180, 'white');
$image->setImageFormat('png');
$theme = new ImagickDraw();
$theme->setTextAlignment(Imagick::ALIGN_CENTER);
$alignment = $theme->getTextAlignment();
$anchors = [Imagick::ALIGN_LEFT => 20, Imagick::ALIGN_CENTER => 160, Imagick::ALIGN_RIGHT => 300];
if (!array_key_exists($alignment, $anchors)) {
    $alignment = Imagick::ALIGN_LEFT;
}
$x = $anchors[$alignment];
$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_UNDEFINED);
$draw->setTextAntialias(true);
$draw->setTextAlignment($alignment);
$draw->annotation($x, 90, 'Заголовок');
echo 'anchor-x=', $x, '; policy=explicit-baseline', "\n";
$theme->clear();
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/alignment-aware-anchor.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'alignment-aware-anchor.png', "\n";
$image->clear();

Результат: alignment-aware-anchor.png 320×180. «Заголовок» центрируется вокруг x=160 на базовой линии y=90. Прочитанный int используется для выбора координаты и setter нового Draw. Это короткий известный текст; таблица опор сама по себе не вписывает произвольную длинную фразу. Перед именем файла консоль: anchor-x=160; policy=explicit-baseline. Последняя строка — alignment-aware-anchor.png. Font.php получает данные из этого же архива. Распакуйте архив целиком в отдельную папку. При установленном PHP с imagick выполните в ней php example.php; PNG появится рядом с example.php и откроется обычным просмотрщиком изображений. Повторный запуск заменит одноимённый учебный PNG.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(320, 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_UNDEFINED);
$draw->setTextAntialias(true);
foreach ([[Imagick::ALIGN_LEFT, 50], [Imagick::ALIGN_CENTER, 95], [Imagick::ALIGN_RIGHT, 140]] as [$alignment, $baseline]) {
    $draw->setTextAlignment($alignment);
    $draw->annotation(160, $baseline, 'Заказ');
}
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/three-anchor-alignments.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'three-anchor-alignments.png', "\n";
$image->clear();

Результат: three-anchor-alignments.png 320×180. Три строки «Заказ» на базовых линиях 50, 95 и 140. У первой начало около x=160, вторая центрируется относительно x=160, третья заканчивается около x=160. Края окрашенных букв могут немного отличаться от типографской ширины из-за боковых полей глифов. Gravity явно Undefined. Последняя строка — three-anchor-alignments.png. Все четыре файла подготовки шрифта включены в архив. Распакуйте архив целиком в отдельную папку. При установленном PHP с imagick выполните в ней php example.php; PNG появится рядом с example.php и откроется обычным просмотрщиком изображений. Повторный запуск заменит одноимённый учебный PNG.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(360, 180, 'white');
$image->setImageFormat('png');
$labels = new ImagickDraw();
$labels->setResolution(72, 72);
$labels->setFont($font);
$labels->setFontSize(18);
$labels->setStrokeColor('none');
$labels->setFillColor('#146c74');
$labels->setGravity(Imagick::GRAVITY_FORGET);
$labels->setTextAlignment(Imagick::ALIGN_LEFT);
$labels->setTextAntialias(true);
$labels->annotation(20, 50, 'Товар');
$labels->annotation(20, 95, 'Доставка');
$labels->annotation(20, 140, 'Скидка');
$image->drawImage($labels);
$labels->clear();
$draw = new ImagickDraw();
$draw->setResolution(72, 72);
$draw->setFont($font);
$draw->setFontSize(18);
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->setGravity(Imagick::GRAVITY_FORGET);
$draw->setTextAlignment(Imagick::ALIGN_RIGHT);
$draw->setTextAntialias(true);
$draw->setTextAlignment(Imagick::ALIGN_RIGHT);
$draw->annotation(340, 50, '1 250 руб.');
$draw->annotation(340, 95, '300 руб.');
$draw->annotation(340, 140, '75 руб.');
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/right-aligned-amounts.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'right-aligned-amounts.png', "\n";
$image->clear();

Результат: right-aligned-amounts.png 360×180. Слева названия на x=20, справа суммы разной длины с общей правой опорой x=340. Базовые линии строк — 50, 95, 140. Короткие русские названия и суммы помещаются в выбранный макет; код не рассчитывает максимальную ширину внешних данных. Последняя строка — right-aligned-amounts.png. Font.php получает данные из этого же архива. Распакуйте архив целиком в отдельную папку. При установленном PHP с imagick выполните в ней php example.php; PNG появится рядом с example.php и откроется обычным просмотрщиком изображений. Повторный запуск заменит одноимённый учебный PNG.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(320, 180, 'white');
$image->setImageFormat('png');
$theme = new ImagickDraw();
$theme->setTextAntialias(false);
$antialias = $theme->getTextAntialias();
$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_UNDEFINED);
$draw->setTextAntialias(true);
$draw->setTextAntialias($antialias);
$draw->annotation(20, 60, 'Заказ');
echo 'antialias=', $antialias ? 'on' : 'off', '; type=', get_debug_type($antialias), "\n";
$theme->clear();
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/copied-hard-edge-setting.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'copied-hard-edge-setting.png', "\n";
$image->clear();

Результат: copied-hard-edge-setting.png 320×180. Бирюзовое «Заказ» имеет более ступенчатый край в данной связке шрифта и renderer: новое рисование унаследовало выключенный режим. False — обычное значение настройки, а не сообщение об ошибке. Getter не смотрит на пиксели готового файла. Перед именем файла консоль: antialias=off; type=bool. Последняя строка — copied-hard-edge-setting.png. Все четыре файла подготовки шрифта включены в архив. Распакуйте архив целиком в отдельную папку. При установленном PHP с imagick выполните в ней php example.php; PNG появится рядом с example.php и откроется обычным просмотрщиком изображений. Повторный запуск заменит одноимённый учебный PNG.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(320, 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_UNDEFINED);
$draw->setTextAntialias(true);
$previous = $draw->getTextAntialias();
$draw->setTextAntialias(false);
$draw->annotation(20, 60, 'AB-42');
$draw->setTextAntialias($previous);
$draw->annotation(20, 120, 'Заказ');
echo 'restored=', $previous ? 'on' : 'off', "\n";
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/restored-text-edge-policy.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'restored-text-edge-policy.png', "\n";
$image->clear();

Результат: restored-text-edge-policy.png 320×180. Верхняя техническая метка «AB-42» записана без сглаживания, нижнее «Заказ» — с исходным включённым режимом. Это две независимые текстовые команды; сохранённый getter bool служит восстановлению настройки, а не анализу резкости картинки. Перед именем файла консоль: restored=on. Последняя строка — restored-text-edge-policy.png. Font.php получает данные из этого же архива. Распакуйте архив целиком в отдельную папку. При установленном PHP с imagick выполните в ней php example.php; PNG появится рядом с example.php и откроется обычным просмотрщиком изображений. Повторный запуск заменит одноимённый учебный PNG.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(640, 180, 'white');
$image->setImageFormat('png');
foreach ([[20, false], [340, true]] as [$x, $antialias]) {
    $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_UNDEFINED);
    $draw->setTextAntialias(true);
    $draw->setTextAntialias($antialias);
    $draw->annotation($x, 60, 'Заказ');
    $image->drawImage($draw);
    $draw->clear();
}
$path = __DIR__ . '/hard-and-smooth-text.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'hard-and-smooth-text.png', "\n";
$image->clear();

Результат: hard-and-smooth-text.png 640×180. В этом отдельном PHP-файле слева «Заказ» без сглаживания, справа — со сглаживанием (порядок обратный иллюстрации выше) при одинаковых 24 пунктах, плотности 72, цвете и белом фоне. Режим влияет на покрытие крайних пикселей глифов. Он не меняет point size, не переносит строку и не растягивает PNG. Смотрите файл при масштабе 100%, а не только его уменьшенную копию в браузере. Последняя строка — hard-and-smooth-text.png. Все четыре файла подготовки шрифта включены в архив. Распакуйте архив целиком в отдельную папку. При установленном PHP с imagick выполните в ней php example.php; PNG появится рядом с example.php и откроется обычным просмотрщиком изображений. Повторный запуск заменит одноимённый учебный PNG.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(320, 180, 'white');
$image->setImageFormat('png');
$background = new ImagickDraw();
$background->setStrokeColor('none');
$background->setFillColor('#bdebe2');
$background->rectangle(20, 30, 300, 150);
$image->drawImage($background);
$background->clear();
$draw = new ImagickDraw();
$draw->setResolution(72, 72);
$draw->setFont($font);
$draw->setFontSize(18);
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->setGravity(Imagick::GRAVITY_FORGET);
$draw->setTextAlignment(Imagick::ALIGN_LEFT);
$draw->setTextAntialias(true);
$draw->setTextAntialias(true);
$draw->annotation(35, 95, 'Доставка готова');
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/smooth-small-card-caption.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'smooth-small-card-caption.png', "\n";
$image->clear();

Результат: smooth-small-card-caption.png 320×180. Мятная карточка (20,30)—(300,150) с бирюзовой надписью «Доставка готова», 18 пунктов, базовая линия y=95. Край букв сглаживается относительно фактического мятного фона. AA не заменяет файл шрифта, достаточный контраст и подходящий размер. Последняя строка — smooth-small-card-caption.png. Font.php получает данные из этого же архива. Распакуйте архив целиком в отдельную папку. При установленном PHP с imagick выполните в ней php example.php; PNG появится рядом с example.php и откроется обычным просмотрщиком изображений. Повторный запуск заменит одноимённый учебный PNG.