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

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(320, 140, 'white');
$image->setImageFormat('png');
$theme = new ImagickDraw();
$theme->setTextKerning(3);
$kerning = $theme->getTextKerning();
$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->setTextKerning(0);
$draw->setTextInterwordSpacing(0);
$draw->setTextInterlineSpacing(0);
$draw->setTextKerning($kerning);
$draw->annotation(20, 60, 'AB-42');
echo 'kerning=', $kerning, '; type=', get_debug_type($kerning), "\n";
$theme->clear();
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/copied-letter-spacing.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'copied-letter-spacing.png', "\n";
$image->clear();

Результат: copied-letter-spacing.png 320×140. Идентификатор AB-42 набран с дополнительным межсимвольным интервалом 3 в нашей системе координат. Float из темы явно применён новому Draw. Это перенос настройки, а не готовой картинки или измеренной ширины. Перед именем файла консоль: kerning=3; type=float. Последняя строка — copied-letter-spacing.png. Распакуйте все файлы в отдельную папку и при установленном PHP с imagick выполните php example.php. PNG появится рядом с example.php: откройте его обычным просмотрщиком при масштабе 100%. Повторный запуск заменит одноимённый учебный файл; font.php восстановит приложенный шрифт без скачивания или установки.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(320, 140, 'white');
$image->setImageFormat('png');
$theme = new ImagickDraw();
$theme->setTextKerning(9);
$provided = $theme->getTextKerning();
$effective = min(3.0, max(-0.5, $provided));
$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->setTextKerning(0);
$draw->setTextInterwordSpacing(0);
$draw->setTextInterlineSpacing(0);
$draw->setTextKerning($effective);
$draw->annotation(20, 60, 'AB-42');
echo 'effective-kerning=', $effective, "\n";
$theme->clear();
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/bounded-letter-spacing.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'bounded-letter-spacing.png', "\n";
$image->clear();

Результат: bounded-letter-spacing.png 320×140. Короткий AB-42 с интервалом 3 вместо полученных 9. Значение действительно участвует в выборе оформления. Для длинного артикула одного ограничения недостаточно — нужно измерение и решение о переносе или сокращении. Перед именем файла консоль: effective-kerning=3. Последняя строка — bounded-letter-spacing.png. Распакуйте все файлы в отдельную папку и при установленном PHP с imagick выполните php example.php. PNG появится рядом с example.php: откройте его обычным просмотрщиком при масштабе 100%. Повторный запуск заменит одноимённый учебный файл; font.php восстановит приложенный шрифт без скачивания или установки.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(640, 220, 'white');
$image->setImageFormat('png');
foreach ([0, 4, -1] as $index => $spacing) {
    $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->setTextKerning(0);
    $draw->setTextInterwordSpacing(0);
    $draw->setTextInterlineSpacing(0);
    $draw->setTextKerning($spacing);
    $draw->annotation(20 + $index * 210, 60, 'AB-42');
    $image->drawImage($draw);
    $draw->clear();
}
$path = __DIR__ . '/letter-spacing-comparison.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'letter-spacing-comparison.png', "\n";
$image->clear();

Результат: letter-spacing-comparison.png 640×220. Три одинаковых AB-42 на одной базовой линии y=60, начала x=20,230,440: kerning 0, 4 и −1. Средняя надпись шире, правая немного плотнее. В реальной проверке этого шрифта ширины окрашенной области были 65, 81 и 61 пиксель; это наблюдение данного рисунка, не универсальные метрики любого текста. Последняя строка — letter-spacing-comparison.png. Распакуйте все файлы в отдельную папку и при установленном PHP с imagick выполните php example.php. PNG появится рядом с example.php: откройте его обычным просмотрщиком при масштабе 100%. Повторный запуск заменит одноимённый учебный файл; font.php восстановит приложенный шрифт без скачивания или установки.

<?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->setTextKerning(2);
$draw->setTextInterwordSpacing(0);
$draw->setTextInterlineSpacing(0);
$draw->annotation(20, 60, 'ДОСТАВКА');
$draw->setTextKerning(0);
$draw->setFontSize(18);
$draw->annotation(20, 120, 'Сегодня, 12:00');
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/delivery-letter-spacing.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'delivery-letter-spacing.png', "\n";
$image->clear();

Результат: delivery-letter-spacing.png 400×180. Верхний заголовок «ДОСТАВКА», 24 пункта и kerning 2, нижнее пояснение «Сегодня, 12:00», 18 пунктов и kerning 0. Изменение настройки перед второй annotation не перенабирает уже записанный заголовок. Последняя строка — delivery-letter-spacing.png. Распакуйте все файлы в отдельную папку и при установленном PHP с imagick выполните php example.php. PNG появится рядом с example.php: откройте его обычным просмотрщиком при масштабе 100%. Повторный запуск заменит одноимённый учебный файл; font.php восстановит приложенный шрифт без скачивания или установки.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(320, 140, 'white');
$image->setImageFormat('png');
$theme = new ImagickDraw();
$theme->setTextInterwordSpacing(18);
$spacing = $theme->getTextInterwordSpacing();
$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->setTextKerning(0);
$draw->setTextInterwordSpacing(0);
$draw->setTextInterlineSpacing(0);
$draw->setTextInterwordSpacing($spacing);
$draw->annotation(20, 60, 'Склад готов');
echo 'word-spacing=', $spacing, '; type=', get_debug_type($spacing), "\n";
$theme->clear();
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/copied-word-spacing.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'copied-word-spacing.png', "\n";
$image->clear();

Результат: copied-word-spacing.png 320×140. Между словами «Склад готов» установлен ненулевой advance пробела 18. Getter сообщает сохранённый float, который использует новый Draw; он не возвращает число белых пикселей между последней и первой буквами. Перед именем файла консоль: word-spacing=18; type=float. Последняя строка — copied-word-spacing.png. Распакуйте все файлы в отдельную папку и при установленном PHP с imagick выполните php example.php. PNG появится рядом с example.php: откройте его обычным просмотрщиком при масштабе 100%. Повторный запуск заменит одноимённый учебный файл; font.php восстановит приложенный шрифт без скачивания или установки.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(360, 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->setTextKerning(0);
$draw->setTextInterwordSpacing(18);
$draw->setTextInterlineSpacing(0);
$previous = $draw->getTextInterwordSpacing();
$draw->setTextInterwordSpacing(0);
$draw->annotation(20, 60, 'BOX 42');
$draw->setTextInterwordSpacing($previous);
$draw->annotation(20, 120, 'Склад готов');
echo 'restored-word-spacing=', $previous, "\n";
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/restored-word-spacing.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'restored-word-spacing.png', "\n";
$image->clear();

Результат: restored-word-spacing.png 360×180. Верхнее BOX 42 использует обычный пробел, нижнее «Склад готов» — восстановленный advance 18. Getter нужен для возврата оформления, а не для подсчёта пробелов в строке или чтения старого изображения. Перед именем файла консоль: restored-word-spacing=18. Последняя строка — restored-word-spacing.png. Распакуйте все файлы в отдельную папку и при установленном PHP с imagick выполните php example.php. PNG появится рядом с example.php: откройте его обычным просмотрщиком при масштабе 100%. Повторный запуск заменит одноимённый учебный файл; font.php восстановит приложенный шрифт без скачивания или установки.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(640, 220, 'white');
$image->setImageFormat('png');
foreach ([0, 18, 3] as $index => $spacing) {
    $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->setTextKerning(0);
    $draw->setTextInterwordSpacing(0);
    $draw->setTextInterlineSpacing(0);
    $draw->setTextInterwordSpacing($spacing);
    $draw->annotation(20 + $index * 210, 60, 'Склад готов');
    $image->drawImage($draw);
    $draw->clear();
}
$path = __DIR__ . '/word-spacing-comparison.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'word-spacing-comparison.png', "\n";
$image->clear();

Результат: word-spacing-comparison.png 640×220. Три «Склад готов»: natural spacing при 0, явный advance пробела 18 и 3. В проверенной связке natural advance был 6, поэтому вариант 18 шире natural на 12, а не на 18 пикселей. Ненулевое значение здесь заменяет advance пробела; реальный белый просвет также зависит от боковых полей соседних букв. Последняя строка — word-spacing-comparison.png. Распакуйте все файлы в отдельную папку и при установленном PHP с imagick выполните php example.php. PNG появится рядом с example.php: откройте его обычным просмотрщиком при масштабе 100%. Повторный запуск заменит одноимённый учебный файл; font.php восстановит приложенный шрифт без скачивания или установки.

<?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(20);
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->setGravity(Imagick::GRAVITY_FORGET);
$draw->setTextAlignment(Imagick::ALIGN_LEFT);
$draw->setTextAntialias(true);
$draw->setTextKerning(0);
$draw->setTextInterwordSpacing(20);
$draw->setTextInterlineSpacing(0);
$draw->annotation(20, 60, '12 мест 3 коробки');
$draw->setTextInterwordSpacing(0);
$draw->setFontSize(16);
$draw->annotation(20, 115, 'Выдать на складе');
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/warehouse-word-groups.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'warehouse-word-groups.png', "\n";
$image->clear();

Результат: warehouse-word-groups.png 400×180. Сводка в 20 пунктов имеет расширенные промежутки между группами, пояснение в 16 пунктов — обычные. Буквы внутри «коробки» не раздвигаются этим setter. Для настоящих табличных колонок нужны отдельные опоры, а не попытка подобрать пробелы. Последняя строка — warehouse-word-groups.png. Распакуйте все файлы в отдельную папку и при установленном PHP с imagick выполните php example.php. PNG появится рядом с example.php: откройте его обычным просмотрщиком при масштабе 100%. Повторный запуск заменит одноимённый учебный файл; font.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->setTextInterlineSpacing(10);
$spacing = $theme->getTextInterlineSpacing();
$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->setTextKerning(0);
$draw->setTextInterwordSpacing(0);
$draw->setTextInterlineSpacing(0);
$draw->setTextInterlineSpacing($spacing);
$draw->annotation(20, 60, "Склад
Готово");
echo 'line-spacing=', $spacing, '; type=', get_debug_type($spacing), "\n";
$theme->clear();
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/copied-line-spacing.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'copied-line-spacing.png', "\n";
$image->clear();

Результат: copied-line-spacing.png 320×180. Две строки «Склад» и «Готово» с увеличенным шагом. Считанные 10 добавлены к естественному шагу строк этого шрифта; это не абсолютная высота каждой строки 10 пикселей. Перенос явно находится в строковом литерале. Перед именем файла консоль: line-spacing=10; type=float. Последняя строка — copied-line-spacing.png. Распакуйте все файлы в отдельную папку и при установленном PHP с imagick выполните php example.php. PNG появится рядом с example.php: откройте его обычным просмотрщиком при масштабе 100%. Повторный запуск заменит одноимённый учебный файл; font.php восстановит приложенный шрифт без скачивания или установки.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(640, 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_FORGET);
$draw->setTextAlignment(Imagick::ALIGN_LEFT);
$draw->setTextAntialias(true);
$draw->setTextKerning(0);
$draw->setTextInterwordSpacing(0);
$draw->setTextInterlineSpacing(12);
$previous = $draw->getTextInterlineSpacing();
$draw->setTextInterlineSpacing(0);
$draw->annotation(20, 60, "12 мест
3 коробки");
$draw->setTextInterlineSpacing($previous);
$draw->annotation(330, 60, "Получение
На складе");
echo 'restored-line-spacing=', $previous, "\n";
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/restored-line-spacing.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'restored-line-spacing.png', "\n";
$image->clear();

Результат: restored-line-spacing.png 640×200. Слева две строки количеств с естественным шагом, справа две строки инструкции с восстановленной прибавкой 12. Обе первые базовые линии y=60; второй блок имеет более низкую следующую строку. Сам getter ничего не переставляет: считанный float применяется setter до команды текста. Перед именем файла консоль: restored-line-spacing=12. Последняя строка — restored-line-spacing.png. Распакуйте все файлы в отдельную папку и при установленном PHP с imagick выполните php example.php. PNG появится рядом с example.php: откройте его обычным просмотрщиком при масштабе 100%. Повторный запуск заменит одноимённый учебный файл; font.php восстановит приложенный шрифт без скачивания или установки.

<?php
declare(strict_types=1);

$font = require __DIR__ . '/font.php';
$image = new Imagick();
$image->newImage(640, 220, 'white');
$image->setImageFormat('png');
foreach ([0, 12, -4] as $index => $spacing) {
    $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->setTextKerning(0);
    $draw->setTextInterwordSpacing(0);
    $draw->setTextInterlineSpacing(0);
    $draw->setTextInterlineSpacing($spacing);
    $draw->annotation(20 + $index * 210, 60, "Склад\nГотово");
    $image->drawImage($draw);
    $draw->clear();
}
$path = __DIR__ . '/line-spacing-comparison.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'line-spacing-comparison.png', "\n";
$image->clear();

Результат: line-spacing-comparison.png 640×220. Три двухстрочных блока с одинаковой первой базовой линией y=60: interline 0, 12 и −4. Во втором блоке вторая строка ниже обычной на 12, в третьем выше обычной на 4. Первые строки остаются на месте. Это прибавка к естественному шагу, а не полная line-height и не расстояние между белыми краями букв. Последняя строка — line-spacing-comparison.png. Распакуйте все файлы в отдельную папку и при установленном PHP с imagick выполните php example.php. PNG появится рядом с example.php: откройте его обычным просмотрщиком при масштабе 100%. Повторный запуск заменит одноимённый учебный файл; font.php восстановит приложенный шрифт без скачивания или установки.

<?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(20, 20, 380, 200);
$image->drawImage($background);
$background->clear();
$draw = new ImagickDraw();
$draw->setResolution(72, 72);
$draw->setFont($font);
$draw->setFontSize(20);
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$draw->setGravity(Imagick::GRAVITY_FORGET);
$draw->setTextAlignment(Imagick::ALIGN_LEFT);
$draw->setTextAntialias(true);
$draw->setTextKerning(0);
$draw->setTextInterwordSpacing(0);
$draw->setTextInterlineSpacing(10);
$draw->annotation(35, 60, "Получатель: Анна
Склад № 2
Выдача после 12:00");
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/pickup-multiline-card.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'pickup-multiline-card.png', "\n";
$image->clear();

Результат: pickup-multiline-card.png 400×220. Мятная карточка (20,20)—(380,200), три строки «Получатель: Анна», «Склад № 2», «Выдача после 12:00», 20 пунктов, начало (35,60), interline 10. В тексте два явных перевода строки. Шрифт и холст те же; длинная внешняя фамилия потребовала бы дополнительного измерения. Последняя строка — pickup-multiline-card.png. Распакуйте все файлы в отдельную папку и при установленном PHP с imagick выполните php example.php. PNG появится рядом с example.php: откройте его обычным просмотрщиком при масштабе 100%. Повторный запуск заменит одноимённый учебный файл; font.php восстановит приложенный шрифт без скачивания или установки.