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

Получить отдельный ярлык и карточку с полями

Для инструкции нужен только ярлык с артикулом, а не вся товарная фотография. Сохраним этот фрагмент отдельным label.png и положим на небольшую карточку с ровными полями. Оригинальная PNG-наклейка останется полной: она пригодится для следующего макета и другого фона. Так получатель скачает готовое изображение, а не будет вручную вырезать нужный участок.

Собственный вход 400×320 уже содержит коробку, кружку, напечатанный ярлык и прозрачное отверстие ручки. Мы продолжаем работу с тем же RGBA-файлом предыдущей главы. Методы не ищут товар и не распознают текст: координаты известны заранее. Надписи — часть исходного растра, не новые измерения после обработки.

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

Переменная $image содержит картинку, $canvas — отдельный будущий холст. $ обозначает имя переменной, = присваивает результат. new Imagick() создаёт пустой объект; -> вызывает его метод; () содержит аргументы, запятые разделяют их, ; завершает инструкцию. Строки в кавычках — путь, цвет или формат. RGB — красная/зелёная/синяя компоненты; RGBA добавляет alpha: 0 прозрачно, 1 непрозрачно. Сначала используем фиксированные размеры и координаты.

В первых двух позициях стоят размеры 156×50, затем точка 72,140. Полученный $label — новый объект; $image остаётся полным. Координаты начинаются с 0; выбранные столбцы 72..227, строки 140..189. setImagePage обнуляет виртуальную рамку самостоятельной вставки, не сдвигая её пиксели:

$label = $image->getImageRegion(156, 50, 72, 140);
$label->setImagePage(0, 0, 0, 0);

В полной программе if проверяет условие, ! отрицает статус, throw new RuntimeException прекращает цепочку при отказе. clone копирует объект; echo выводит строку, . соединяет строки, "\n" добавляет перевод строки. Основы: объекты и методы, массивы, копии, исключения.

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

Переменная $image содержит картинку, $canvas — отдельный будущий холст. $ обозначает имя переменной, = присваивает результат. new Imagick() создаёт пустой объект; -> вызывает его метод; () содержит аргументы, запятые разделяют их, ; завершает инструкцию. Строки в кавычках — путь, цвет или формат. RGB — красная/зелёная/синяя компоненты; RGBA добавляет alpha: 0 прозрачно, 1 непрозрачно. Сначала используем фиксированные размеры и координаты.

После первой строки $canvas — объект, после второго вызова он содержит полотно 220×100. Вызов возвращает true как статус; запись $canvas=$canvas->newImage(...) заменила бы объект логическим значением. Третий аргумент закрашивает сам растр, четвёртый выбирает формат объекта:

$canvas = new Imagick();
$created = $canvas->newImage(220, 100, '#e6edf1', 'png');

В полной программе if проверяет условие, ! отрицает статус, throw new RuntimeException прекращает цепочку при отказе. clone копирует объект; echo выводит строку, . соединяет строки, "\n" добавляет перевод строки. Основы: объекты и методы, массивы, копии, исключения.

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

Переменная $image содержит картинку, $canvas — отдельный будущий холст. $ обозначает имя переменной, = присваивает результат. new Imagick() создаёт пустой объект; -> вызывает его метод; () содержит аргументы, запятые разделяют их, ; завершает инструкцию. Строки в кавычках — путь, цвет или формат. RGB — красная/зелёная/синяя компоненты; RGBA добавляет alpha: 0 прозрачно, 1 непрозрачно. Сначала используем фиксированные размеры и координаты.

Сначала прочитаем настройку; $background теперь ImagickPixel. getColor(1) возвращает массив нормированных компонентов 0..1; 1 передаём именно целым числом. ['r'] читает красную компоненту по ключу, *255 переводит её для показа в обычную восьмибитную шкалу, round округляет, (int) делает целое число. Это чтение сохранённого цвета, а не анализ угла изображения:

$background = $image->getImageBackgroundColor();
$color = $background->getColor(1);
$red = (int)round(255 * $color['r']);

В полной программе if проверяет условие, ! отрицает статус, throw new RuntimeException прекращает цепочку при отказе. clone копирует объект; echo выводит строку, . соединяет строки, "\n" добавляет перевод строки. Основы: объекты и методы, массивы, копии, исключения.

Перед полной программой: <?php открывает PHP; declare(strict_types=1) включает строгие типы. require подключает открытый helper из той же папки, __DIR__ — её путь. loadCanvasSource восстанавливает точный PNG из Base64 и проверяет SHA; это упаковка входа, не вырезание. setImageBackgroundColor задаёт настройку, которую затем читает getter. Imagick::COMPOSITE_OVER — именованная константа класса, :: обращается к ней; compositeImage накладывает ярлык в явной точке 32,25. Вспомогательная canvasPreview создаёт только подложку просмотра, saveCanvasNative записывает файл, saveCanvasComparison собирает полные панели. [] задаёт массив по порядку. Полный helper открыт ниже; функции, файлы и OVER объяснены отдельно.

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

Слева весь вход, в середине самостоятельная вставка label.png 156×50, справа label-card.png 220×100. Ярлык лежит в (32,25), поэтому слева/справа по 32 пикселя, сверху/снизу по 25. Вставка сохраняет alpha края, карточка смешана с непрозрачным светлым фоном.

<?php
declare(strict_types=1);
require __DIR__ . '/canvas-fixture.php';
$source = loadCanvasSource();
$label = $source->getImageRegion(156, 50, 72, 140);
$label->setImagePage(0, 0, 0, 0);
$source->setImageBackgroundColor('#e6edf1');
$background = $source->getImageBackgroundColor();
$card = new Imagick();
if (!$card->newImage(220, 100, $background, 'png')) { throw new RuntimeException('New card failed'); }
$card->compositeImage($label, Imagick::COMPOSITE_OVER, 32, 25);
saveCanvasNative($label, 'label.png', true);
saveCanvasNative($card, 'label-card.png', false);
saveCanvasComparison([canvasPreview($source, 'white'), canvasPreview($label, 'white'), $card], 'first-canvas.png');
echo "first-canvas.png\nlabel.png\nlabel-card.png\n";

first-canvas.png
label.png
label-card.png

Различить статус, картинку и объект цвета

Три метода имеют разные возвращаемые значения. В controls сохраняем статус newImage в $created, новую область в $region, цвет в $background. get_debug_type выводит имя PHP-типа, а (int) показывает bool как 0/1. Прозрачное пустое полотно выглядит как выбранная подложка просмотра; это не значит, что подложка закрашена в его RGBA.

Различить статус создания, новую область и объект цвета

После входа идут заполненное светлое полотно, пустое прозрачное полотно поверх тёмной подложки и новая область ярлыка. True от newImage — статус, getImageRegion возвращает Imagick, getter background возвращает ImagickPixel. Размеры панелей естественные, меньшие панели окружены белым контекстом сравнения.

<?php
declare(strict_types=1);
require __DIR__ . '/canvas-fixture.php';
$source = loadCanvasSource();
$canvas = new Imagick();
$created = $canvas->newImage(220, 100, '#e6edf1', 'png');
if (!$created) { throw new RuntimeException('New canvas failed'); }
$transparent = new Imagick();
if (!$transparent->newImage(220, 100, 'transparent', 'png')) { throw new RuntimeException('Transparent canvas failed'); }
$region = $source->getImageRegion(156, 50, 72, 140);
$background = $canvas->getImageBackgroundColor();
saveCanvasComparison([canvasPreview($source, 'white'), $canvas, canvasPreview($transparent, '#243c4d'), canvasPreview($region, 'white')], 'canvas-controls.png');
echo "canvas-controls.png\ncreated=" . (int)$created . " region=" . get_debug_type($region) . " background=" . get_debug_type($background) . "\n";

canvas-controls.png
created=1 region=Imagick background=ImagickPixel

Создать непрозрачную карточку или прозрачные поля

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

Переменная $image содержит картинку, $canvas — отдельный будущий холст. $ обозначает имя переменной, = присваивает результат. new Imagick() создаёт пустой объект; -> вызывает его метод; () содержит аргументы, запятые разделяют их, ; завершает инструкцию. Строки в кавычках — путь, цвет или формат. RGB — красная/зелёная/синяя компоненты; RGBA добавляет alpha: 0 прозрачно, 1 непрозрачно. Сначала используем фиксированные размеры и координаты.

После первой строки $canvas — объект, после второго вызова он содержит полотно 220×100. Вызов возвращает true как статус; запись $canvas=$canvas->newImage(...) заменила бы объект логическим значением. Третий аргумент закрашивает сам растр, четвёртый выбирает формат объекта:

$canvas = new Imagick();
$created = $canvas->newImage(220, 100, '#e6edf1', 'png');

В полной программе if проверяет условие, ! отрицает статус, throw new RuntimeException прекращает цепочку при отказе. clone копирует объект; echo выводит строку, . соединяет строки, "\n" добавляет перевод строки. Основы: объекты и методы, массивы, копии, исключения.

Добавить поля — значит создать большее полотно. Для входа 400×320 и полей 20 с каждой стороны получаем 440×360; накладываем исходник в 20,20. Прозрачный фон сохраняем в padded-sticker.png, а белый/тёмный вид показываем отдельно. Копия не меняет масштаб товара.

Создать полотно заданного размера для отдельной карточки ярлыка

В середине настоящий новый RGB-растр 220×100, справа тот же растр с ярлыком в (32,25). new-label-card.png — отдельный готовый результат. Параметр png задаёт формат объекта; файл появляется только после сохранения.

<?php
declare(strict_types=1);
require __DIR__ . '/canvas-fixture.php';
$source = loadCanvasSource();
$label = $source->getImageRegion(156, 50, 72, 140);
$label->setImagePage(0, 0, 0, 0);
$card = new Imagick();
if (!$card->newImage(220, 100, '#e6edf1', 'png')) { throw new RuntimeException('New card failed'); }
$blank = clone $card;
$card->compositeImage($label, Imagick::COMPOSITE_OVER, 32, 25);
saveCanvasNative($card, 'new-label-card.png', false);
saveCanvasComparison([canvasPreview($source, 'white'), $blank, $card], 'new-label.png');
echo "new-label.png\n";

new-label.png

Добавить прозрачные поля вокруг всей PNG-наклейки

padded-sticker.png имеет полный размер 440×360 и 20 прозрачных пикселей с каждой стороны. Две правые панели показывают одни RGBA-пиксели на белом и тёмном. Исходные 400×320 не масштабируются и не обрезаются; alpha отверстия ручки остаётся прозрачной.

<?php
declare(strict_types=1);
require __DIR__ . '/canvas-fixture.php';
$source = loadCanvasSource();
$padded = new Imagick();
if (!$padded->newImage(440, 360, 'transparent', 'png')) { throw new RuntimeException('New transparent canvas failed'); }
$padded->compositeImage($source, Imagick::COMPOSITE_OVER, 20, 20);
saveCanvasNative($padded, 'padded-sticker.png', true);
saveCanvasComparison([canvasPreview($source, 'white'), canvasPreview($padded, 'white'), canvasPreview($padded, '#243c4d')], 'new-padded.png');
echo "new-padded.png\n";

new-padded.png

Извлечь две вставки и согласовать page

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

Переменная $image содержит картинку, $canvas — отдельный будущий холст. $ обозначает имя переменной, = присваивает результат. new Imagick() создаёт пустой объект; -> вызывает его метод; () содержит аргументы, запятые разделяют их, ; завершает инструкцию. Строки в кавычках — путь, цвет или формат. RGB — красная/зелёная/синяя компоненты; RGBA добавляет alpha: 0 прозрачно, 1 непрозрачно. Сначала используем фиксированные размеры и координаты.

В первых двух позициях стоят размеры 156×50, затем точка 72,140. Полученный $label — новый объект; $image остаётся полным. Координаты начинаются с 0; выбранные столбцы 72..227, строки 140..189. setImagePage обнуляет виртуальную рамку самостоятельной вставки, не сдвигая её пиксели:

$label = $image->getImageRegion(156, 50, 72, 140);
$label->setImagePage(0, 0, 0, 0);

В полной программе if проверяет условие, ! отрицает статус, throw new RuntimeException прекращает цепочку при отказе. clone копирует объект; echo выводит строку, . соединяет строки, "\n" добавляет перевод строки. Основы: объекты и методы, массивы, копии, исключения.

Получить самостоятельный точный фрагмент ярлыка без изменения исходника

label-extract.png содержит выбранные 156×50 пикселей исходника от (72,140). Нет изменения масштаба или интерполяции; alpha края сохраняется. Для самостоятельного файла page явно обнулён, исходное изображение не обрезано.

<?php
declare(strict_types=1);
require __DIR__ . '/canvas-fixture.php';
$source = loadCanvasSource();
$label = $source->getImageRegion(156, 50, 72, 140);
$label->setImagePage(0, 0, 0, 0);
saveCanvasNative($label, 'label-extract.png', true);
saveCanvasComparison([canvasPreview($source, 'white'), canvasPreview($label, 'white')], 'region-label.png');
echo "region-label.png\n";

region-label.png

Для кружки берём 160×190 в 232,72. getImagePage возвращает массив, ['x']/['y'] читают смещение. После reset page пиксели не двигаются: задаём самостоятельной вставке нулевое виртуальное положение, а фактическое место на следующем canvas всё равно задаётся координатами compositeImage.

Сохранить прозрачную вставку кружки и обнулить её виртуальное положение

mug-insert.png — целая RGBA-вставка 160×190 из области (232,72). После извлечения текущий объект помнит page-offset232,72; reset задаёт 0,0 без изменения пикселей. Белая и тёмная панели — только два просмотра прозрачной вставки, а не два её фона.

<?php
declare(strict_types=1);
require __DIR__ . '/canvas-fixture.php';
$source = loadCanvasSource();
$mug = $source->getImageRegion(160, 190, 232, 72);
$pageBefore = $mug->getImagePage();
$mug->setImagePage(0, 0, 0, 0);
$pageAfter = $mug->getImagePage();
saveCanvasNative($mug, 'mug-insert.png', true);
saveCanvasComparison([canvasPreview($source, 'white'), canvasPreview($mug, 'white'), canvasPreview($mug, '#243c4d')], 'region-insert.png');
echo "region-insert.png\npage-before=" . $pageBefore['x'] . "," . $pageBefore['y'] . "\npage-after=" . $pageAfter['x'] . "," . $pageAfter['y'] . "\n";

region-insert.png
page-before=232,72
page-after=0,0

Прочитать настройку и перенести явный цвет шаблона

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

Переменная $image содержит картинку, $canvas — отдельный будущий холст. $ обозначает имя переменной, = присваивает результат. new Imagick() создаёт пустой объект; -> вызывает его метод; () содержит аргументы, запятые разделяют их, ; завершает инструкцию. Строки в кавычках — путь, цвет или формат. RGB — красная/зелёная/синяя компоненты; RGBA добавляет alpha: 0 прозрачно, 1 непрозрачно. Сначала используем фиксированные размеры и координаты.

Сначала прочитаем настройку; $background теперь ImagickPixel. getColor(1) возвращает массив нормированных компонентов 0..1; 1 передаём именно целым числом. ['r'] читает красную компоненту по ключу, *255 переводит её для показа в обычную восьмибитную шкалу, round округляет, (int) делает целое число. Это чтение сохранённого цвета, а не анализ угла изображения:

$background = $image->getImageBackgroundColor();
$color = $background->getColor(1);
$red = (int)round(255 * $color['r']);

В полной программе if проверяет условие, ! отрицает статус, throw new RuntimeException прекращает цепочку при отказе. clone копирует объект; echo выводит строку, . соединяет строки, "\n" добавляет перевод строки. Основы: объекты и методы, массивы, копии, исключения.

Не принять настройку background за цвет реального поля

Тёмное полотно заполнено через newImage, но его metadata background в проверенной сборке белая. Чтение настройки и создание нового поля этим цветом даёт белую панель справа. filled-canvas.png остаётся тёмным: getter не измеряет пиксели и не ищет доминирующий цвет.

<?php
declare(strict_types=1);
require __DIR__ . '/canvas-fixture.php';
$source = loadCanvasSource();
$filled = new Imagick();
if (!$filled->newImage(220, 100, '#243c4d', 'png')) { throw new RuntimeException('New filled canvas failed'); }
$background = $filled->getImageBackgroundColor();
$fromSetting = new Imagick();
if (!$fromSetting->newImage(220, 100, $background, 'png')) { throw new RuntimeException('New metadata canvas failed'); }
$color = $background->getColor(1);
saveCanvasNative($filled, 'filled-canvas.png', false);
saveCanvasComparison([canvasPreview($source, 'white'), $filled, $fromSetting], 'background-read.png');
echo "background-read.png\nstored-rgb=" . (int)round(255 * $color['r']) . "," . (int)round(255 * $color['g']) . "," . (int)round(255 * $color['b']) . "\n";

background-read.png
stored-rgb=255,255,255

Для шаблона цвет должен быть задан осознанно. setImageBackgroundColor('#e6edf1') сохраняет его в исходнике. Getter возвращает независимый ImagickPixel, который можно передать новому холсту и затем изменить через setColor для второй версии. Изменение этого объекта не является setter исходника: повторное чтение настройки остаётся светлым.

Использовать явный цвет шаблона и сделать независимый второй вариант

Явно заданный background исходника прочитан как ImagickPixel и передан новому светлому полотну. Затем изменён только возвращённый объект цвета: создана тёмная карточка, а настройка исходника осталась 230/237/241. Оба самостоятельных RGB-файла 440×360 сохраняют полный товар с полями 20 пикселей.

<?php
declare(strict_types=1);
require __DIR__ . '/canvas-fixture.php';
$source = loadCanvasSource();
$source->setImageBackgroundColor('#e6edf1');
$background = $source->getImageBackgroundColor();
$light = new Imagick();
if (!$light->newImage(440, 360, $background, 'png')) { throw new RuntimeException('Light card failed'); }
$light->compositeImage($source, Imagick::COMPOSITE_OVER, 20, 20);
$background->setColor('#243c4d');
$dark = new Imagick();
if (!$dark->newImage(440, 360, $background, 'png')) { throw new RuntimeException('Dark card failed'); }
$dark->compositeImage($source, Imagick::COMPOSITE_OVER, 20, 20);
$stored = $source->getImageBackgroundColor()->getColor(1);
saveCanvasNative($light, 'metadata-light-card.png', false);
saveCanvasNative($dark, 'metadata-dark-card.png', false);
saveCanvasComparison([canvasPreview($source, 'white'), $light, $dark], 'metadata-cards.png');
echo "metadata-cards.png\nstored-rgb=" . (int)round(255 * $stored['r']) . "," . (int)round(255 * $stored['g']) . "," . (int)round(255 * $stored['b']) . "\n";

metadata-cards.png
stored-rgb=230,237,241

Проверить размеры, фон и границы запроса

Проверенные PNG созданы локальным CLI. Это не HTTP-загрузчик и не браузерный crop-editor: координаты CSS с масштабированием нужно переводить к натуральным пикселям отдельно. Контроль сохранности относится к собственному RGBA-входу; мы не сертифицируем одинаковый показ всех редакторов, OCR, профили CMYK или произвольные анимации. Цветной preview не доказывает alpha; raw RGBA-файлы сохранены отдельно. Поля сравнения белые, они не входят в самостоятельные вставки. PNG type2/type6 хранит 8 бит на компоненту, это не индексированный PNG.

<?php
declare(strict_types=1);
function loadCanvasSource(): Imagick {
    $encoded = file_get_contents(__DIR__ . '/source.png.b64');
    if ($encoded === false) { throw new RuntimeException('Cannot read source.png.b64'); }
    $bytes = base64_decode($encoded, true);
    if ($bytes === false || hash('sha256', $bytes) !== 'f51e5780445e0f5130a7f23112b2a00618035afd5545b8e3042c7ccff09b617c') {
        throw new RuntimeException('Unexpected RGBA source bytes');
    }
    if (file_put_contents(__DIR__ . '/source.png', $bytes) === false) { throw new RuntimeException('Cannot restore source.png'); }
    return new Imagick(__DIR__ . '/source.png');
}
function canvasPreview(Imagick $image, string $background): Imagick {
    $preview = new Imagick();
    $preview->newImage($image->getImageWidth(), $image->getImageHeight(), $background);
    $preview->compositeImage($image, Imagick::COMPOSITE_OVER, 0, 0);
    return $preview;
}
function saveCanvasNative(Imagick $image, string $filename, bool $withAlpha): void {
    $saved = clone $image;
    $saved->setImageFormat('png');
    $saved->setImageDepth(8);
    $saved->setOption('png:color-type', $withAlpha ? '6' : '2');
    if (!$saved->writeImage(__DIR__ . '/' . $filename)) { throw new RuntimeException('Cannot save ' . $filename); }
}
function saveCanvasComparison(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();
    }
    saveCanvasNative($canvas, $filename, false);
}

Самостоятельные поля и следующий шаг

Упражнение: оставить ярлык 156×50, но сделать поля по 20 пикселей со всех сторон. Решение: новое полотно 196×90, наложение в 20,20; исходный getImageRegion(156,50,72,140) не менять. Сохраните новый самостоятельный PNG и проверьте размер 196×90, точную область в 20,20 и цвет углов. Этот изменённый вариант выполните отдельно; свидетельства относятся к исходным восьми программам.

Дальше: канал alpha и настройка фона, тень и композиция, рамка и размер растра, градиенты и текстуры. getImageRegion не заменяет исторические crop/paint aliases; оставшиеся методы сохраняются в полном объёме справочника.