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

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 220, 'white');
$image->setImageFormat('png');
$outline = new ImagickDraw();
$outline->setFillColor('none');
$outline->setStrokeColor('black');
$outline->setStrokeWidth(4);
$outline->rectangle(20, 40, 140, 180);
$outline->rectangle(220, 40, 340, 180);
$image->drawImage($outline);
$outline->clear();
$draw = new ImagickDraw();
$draw->setFillColor('#146c74');
$draw->color(60, 110, Imagick::PAINT_FLOODFILL);
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/one-closed-region-filled.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'one-closed-region-filled.png', "\n";
$image->clear();

Результат: one-closed-region-filled.png 360×220. Левый замкнутый прямоугольник закрашен бирюзовым от точки (60,110); правая белая область и фон остаются белыми, чёрные границы сохранены. Цвет берётся из fill, а режим FLOODFILL ограничивает связную область исходного цвета. Сохраните example.php в отдельной папке и выполните php example.php при PHP с imagick. PNG появится рядом; откройте его обычным просмотрщиком при 100%. Прозрачный PNG смотрите на светлом и тёмном фоне: белый фон просмотрщика не доказывает отсутствие alpha. Шрифты, входные файлы, интернет и shell-команды не нужны. Повторный запуск заменяет одноимённый учебный PNG.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 220, 'white');
$image->setImageFormat('png');
$base = new ImagickDraw();
$base->setStrokeColor('none');
$base->setFillColor('#ffe08a');
$base->rectangle(20, 40, 140, 180);
$base->rectangle(220, 40, 340, 180);
$image->drawImage($base);
$base->clear();
$draw = new ImagickDraw();
$draw->setFillColor('#146c74');
$draw->color(60, 110, Imagick::PAINT_REPLACE);
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/rebrand-two-separated-cells.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'rebrand-two-separated-cells.png', "\n";
$image->clear();

Результат: rebrand-two-separated-cells.png 360×220. Обе бывшие золотистые ячейки стали бирюзовыми, разделяющее их белое поле осталось белым. Это глобальное совпадение цвета образца, а не распознавание логического элемента приложения. На фото и сглаженных краях близкие цвета требуют отдельной политики fuzz/маски. Сохраните example.php в отдельной папке и выполните php example.php при PHP с imagick. PNG появится рядом; откройте его обычным просмотрщиком при 100%. Прозрачный PNG смотрите на светлом и тёмном фоне: белый фон просмотрщика не доказывает отсутствие alpha. Шрифты, входные файлы, интернет и shell-команды не нужны. Повторный запуск заменяет одноимённый учебный PNG.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 220, 'white');
$image->setImageFormat('png');
$logo = new Imagick();
$logo->newImage(80, 80, 'none');
$logo->setImageFormat('png');
$mark = new ImagickDraw();
$mark->setStrokeColor('none');
$mark->setFillColor('#ffe08a');
$mark->circle(40, 40, 70, 40);
$mark->setFillColor('none');
$mark->setStrokeColor('white');
$mark->setStrokeWidth(7);
$mark->polyline([['x' => 23, 'y' => 40], ['x' => 36, 'y' => 53], ['x' => 58, 'y' => 27]]);
$logo->drawImage($mark);
$mark->clear();
$draw = new ImagickDraw();
$draw->composite(Imagick::COMPOSITE_OVER, 20, 20, 80, 80, $logo);
$logo->clear();
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/own-mark-over-white.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'own-mark-over-white.png', "\n";
$image->clear();

Результат: own-mark-over-white.png 360×220. В области 80×80 с левым верхним углом (20,20) расположен свой золотистый круг с белой галочкой. Углы исходного PNG прозрачны и пропускают белый фон. Источник очищен после постановки команды, но встроенный снимок в очереди продолжает работать. Сохраните example.php в отдельной папке и выполните php example.php при PHP с imagick. PNG появится рядом; откройте его обычным просмотрщиком при 100%. Прозрачный PNG смотрите на светлом и тёмном фоне: белый фон просмотрщика не доказывает отсутствие alpha. Шрифты, входные файлы, интернет и shell-команды не нужны. Повторный запуск заменяет одноимённый учебный PNG.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 220, 'white');
$image->setImageFormat('png');
$logo = new Imagick();
$logo->newImage(80, 80, 'none');
$logo->setImageFormat('png');
$mark = new ImagickDraw();
$mark->setStrokeColor('none');
$mark->setFillColor('#ffe08a');
$mark->circle(40, 40, 70, 40);
$mark->setFillColor('none');
$mark->setStrokeColor('white');
$mark->setStrokeWidth(7);
$mark->polyline([['x' => 23, 'y' => 40], ['x' => 36, 'y' => 53], ['x' => 58, 'y' => 27]]);
$logo->drawImage($mark);
$mark->clear();
$draw = new ImagickDraw();
$draw->composite(Imagick::COMPOSITE_OVER, 20, 60, 80, 80, $logo);
$change = new ImagickDraw();
$change->setStrokeColor('none');
$change->setFillColor('#c25732');
$change->rectangle(0, 0, 79, 79);
$logo->drawImage($change);
$change->clear();
$draw->composite(Imagick::COMPOSITE_OVER, 220, 40, 120, 120, $logo);
$logo->clear();
$image->drawImage($draw);
$draw->clear();
echo 'first=snapshot-80x80; second=changed-source-120x120', "\n";
$path = __DIR__ . '/queued-source-snapshots-and-size.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'queued-source-snapshots-and-size.png', "\n";
$image->clear();

Результат: queued-source-snapshots-and-size.png 360×220. Слева золотистый круг с галочкой в прежней области 80×80, справа красный квадрат ровно 120×120. Изменение/очистка источника после первого composite не меняет встроенный снимок первой команды. Указанные размеры изменяют только вставляемое изображение, холст остаётся 360×220. Консоль до имени файла: first=snapshot-80x80; second=changed-source-120x120. Сохраните example.php в отдельной папке и выполните php example.php при PHP с imagick. PNG появится рядом; откройте его обычным просмотрщиком при 100%. Прозрачный PNG смотрите на светлом и тёмном фоне: белый фон просмотрщика не доказывает отсутствие alpha. Шрифты, входные файлы, интернет и shell-команды не нужны. Повторный запуск заменяет одноимённый учебный PNG.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 220, 'white');
$image->setImageFormat('png');
$legacy = new ImagickDraw();
try {
    $legacy->matte(0, 0, Imagick::PAINT_FLOODFILL);
    throw new LogicException('В проверенной сборке ImageMagick 7 ожидалось отсутствие matte');
} catch (Error $error) {
    if (!str_contains($error->getMessage(), 'ImagickDraw::matte')) {
        throw $error;
    }
    echo 'matte=unavailable-in-IM7; modern-operation=used', "\n";
}
$legacy->clear();
$object = new ImagickDraw();
$object->setStrokeColor('none');
$object->setFillColor('#146c74');
$object->roundRectangle(60, 30, 300, 190, 18, 18);
$image->drawImage($object);
$object->clear();
$image->setImageAlphaChannel(Imagick::ALPHACHANNEL_ACTIVATE);
$image->transparentPaintImage('white', 0.0, 0, false);
$path = __DIR__ . '/legacy-matte-modern-transparent-color.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'legacy-matte-modern-transparent-color.png', "\n";
$image->clear();

Результат: legacy-matte-modern-transparent-color.png 360×220. Бирюзовая фигура непрозрачна, весь точно белый фон имеет alpha 0. Matte действительно отсутствует и его вызов обработан как Error; прозрачность создаёт transparentPaintImage. Эта операция заменяет все совпадающие белые пиксели, а не только связанные с одной точкой. Шахматная подложка в поясняющей схеме не записана в PNG. Консоль до имени файла: matte=unavailable-in-IM7; modern-operation=used. Сохраните example.php в отдельной папке и выполните php example.php при PHP с imagick. PNG появится рядом; откройте его обычным просмотрщиком при 100%. Прозрачный PNG смотрите на светлом и тёмном фоне: белый фон просмотрщика не доказывает отсутствие alpha. Шрифты, входные файлы, интернет и shell-команды не нужны. Повторный запуск заменяет одноимённый учебный PNG.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 220, 'white');
$image->setImageFormat('png');
$legacy = new ImagickDraw();
try {
    $legacy->matte(0, 0, Imagick::PAINT_FLOODFILL);
    throw new LogicException('В проверенной сборке ImageMagick 7 ожидалось отсутствие matte');
} catch (Error $error) {
    if (!str_contains($error->getMessage(), 'ImagickDraw::matte')) {
        throw $error;
    }
    echo 'matte=unavailable-in-IM7; modern-operation=used', "\n";
}
$legacy->clear();
$object = new ImagickDraw();
$object->setStrokeColor('none');
$object->setFillColor('#146c74');
$object->roundRectangle(60, 30, 300, 190, 18, 18);
$object->setFillColor('white');
$object->circle(180, 110, 205, 110);
$image->drawImage($object);
$object->clear();
$image->setImageAlphaChannel(Imagick::ALPHACHANNEL_ACTIVATE);
$image->floodFillPaintImage('none', 0, 'white', 0, 0, false);
$path = __DIR__ . '/connected-background-keeps-white-detail.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'connected-background-keeps-white-detail.png', "\n";
$image->clear();

Результат: connected-background-keeps-white-detail.png 360×220. Внешний белый фон прозрачен (alpha 0), бирюзовый предмет непрозрачен (alpha 1), белый внутренний круг тоже остаётся непрозрачным. Точка (0,0) принадлежит внешнему фону; floodfill не проходит через бирюзовую границу к изолированному белому кругу. Это работа современной операции над Imagick, не успешный matte. Консоль до имени файла: matte=unavailable-in-IM7; modern-operation=used. Сохраните example.php в отдельной папке и выполните php example.php при PHP с imagick. PNG появится рядом; откройте его обычным просмотрщиком при 100%. Прозрачный PNG смотрите на светлом и тёмном фоне: белый фон просмотрщика не доказывает отсутствие alpha. Шрифты, входные файлы, интернет и shell-команды не нужны. Повторный запуск заменяет одноимённый учебный PNG.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 220, 'none');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('none');
$draw->setFillColor('#146c74');
$deprecated = 0;
set_error_handler(static function (int $severity, string $message) use (&$deprecated): bool {
    if ($severity === E_DEPRECATED && str_contains($message, 'ImagickDraw::setFillAlpha')) {
        ++$deprecated;
        return true;
    }
    return false;
}, E_DEPRECATED);
try {
    $draw->setFillAlpha(0.5);
} finally {
    restore_error_handler();
}
if ($deprecated !== 1) {
    throw new LogicException('Ожидалось одно предупреждение устаревшего setFillAlpha в этой сборке');
}
echo 'deprecated=1; replacement=setFillOpacity', "\n";
$draw->rectangle(20, 40, 140, 180);
$image->drawImage($draw);
$draw->clear();
$modern = new ImagickDraw();
$modern->setStrokeColor('none');
$modern->setFillColor('#146c74');
$modern->setFillOpacity(0.5);
$modern->rectangle(220, 40, 340, 180);
$image->drawImage($modern);
$modern->clear();
$path = __DIR__ . '/legacy-fill-and-modern-opacity.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'legacy-fill-and-modern-opacity.png', "\n";
$image->clear();

Результат: legacy-fill-and-modern-opacity.png 360×220. Два одинаковых полупрозрачных бирюзовых прямоугольника на настоящем прозрачном холсте: слева устаревший alias, справа современный setFillOpacity. У внутренних пикселей alpha около 0.5, снаружи 0. У старого вызова зафиксировано ровно одно ожидаемое E_DEPRECATED; остальные ошибки не подавляются. Консоль до имени файла: deprecated=1; replacement=setFillOpacity. Сохраните example.php в отдельной папке и выполните php example.php при PHP с imagick. PNG появится рядом; откройте его обычным просмотрщиком при 100%. Прозрачный PNG смотрите на светлом и тёмном фоне: белый фон просмотрщика не доказывает отсутствие alpha. Шрифты, входные файлы, интернет и shell-команды не нужны. Повторный запуск заменяет одноимённый учебный PNG.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 220, 'white');
$image->setImageFormat('png');
$base = new Imagick();
$base->newImage(160, 220, 'white');
$base->setImageFormat('png');
$background = new ImagickDraw();
$background->setStrokeColor('none');
$background->setFillColor('#bdebe2');
$background->rectangle(10, 20, 150, 200);
$base->drawImage($background);
$background->clear();
$left = clone $base;
$right = clone $base;
$base->clear();
$draw = new ImagickDraw();
$draw->setFillColor('#146c74');
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(8);
$draw->setStrokeOpacity(1);
$deprecated = 0;
set_error_handler(static function (int $severity, string $message) use (&$deprecated): bool {
    if ($severity === E_DEPRECATED && str_contains($message, 'ImagickDraw::setFillAlpha')) {
        ++$deprecated;
        return true;
    }
    return false;
}, E_DEPRECATED);
try {
    $draw->setFillAlpha(0.25);
} finally {
    restore_error_handler();
}
if ($deprecated !== 1) {
    throw new LogicException('Ожидалось одно предупреждение устаревшего setFillAlpha в этой сборке');
}
echo 'deprecated=1; replacement=setFillOpacity', "\n";
$draw->rectangle(25, 45, 135, 175);
$left->drawImage($draw);
$draw->clear();
$modern = new ImagickDraw();
$modern->setFillColor('#146c74');
$modern->setFillOpacity(0.25);
$modern->setStrokeColor('#146c74');
$modern->setStrokeOpacity(1);
$modern->setStrokeWidth(8);
$modern->rectangle(25, 45, 135, 175);
$right->drawImage($modern);
$modern->clear();
$image->compositeImage($left, Imagick::COMPOSITE_OVER, 0, 0);
$image->compositeImage($right, Imagick::COMPOSITE_OVER, 200, 0);
$left->clear();
$right->clear();
$path = __DIR__ . '/translucent-fill-opaque-outline.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'translucent-fill-opaque-outline.png', "\n";
$image->clear();

Результат: translucent-fill-opaque-outline.png 360×220. Две одинаковые области на отдельных мятных панелях: мягкая смешанная заливка, но непрозрачные бирюзовые рамки. Одинаковые локальные координаты исключают различие сглаживания при переносе геометрии. Итоговый PNG непрозрачен, потому что под фигурами был непрозрачный фон; fill alpha 0.25 не означает alpha 0.25 у уже смешанного конечного пикселя. Консоль до имени файла: deprecated=1; replacement=setFillOpacity. Сохраните example.php в отдельной папке и выполните php example.php при PHP с imagick. PNG появится рядом; откройте его обычным просмотрщиком при 100%. Прозрачный PNG смотрите на светлом и тёмном фоне: белый фон просмотрщика не доказывает отсутствие alpha. Шрифты, входные файлы, интернет и shell-команды не нужны. Повторный запуск заменяет одноимённый учебный PNG.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 220, 'none');
$image->setImageFormat('png');
$left = new Imagick();
$left->newImage(160, 220, 'none');
$left->setImageFormat('png');
$right = clone $left;
$draw = new ImagickDraw();
$draw->setFillColor('none');
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(10);
$deprecated = 0;
set_error_handler(static function (int $severity, string $message) use (&$deprecated): bool {
    if ($severity === E_DEPRECATED && str_contains($message, 'ImagickDraw::setStrokeAlpha')) {
        ++$deprecated;
        return true;
    }
    return false;
}, E_DEPRECATED);
try {
    $draw->setStrokeAlpha(0.5);
} finally {
    restore_error_handler();
}
if ($deprecated !== 1) {
    throw new LogicException('Ожидалось одно предупреждение устаревшего setStrokeAlpha в этой сборке');
}
echo 'deprecated=1; replacement=setStrokeOpacity', "\n";
$draw->rectangle(25, 40, 135, 180);
$left->drawImage($draw);
$draw->clear();
$modern = new ImagickDraw();
$modern->setFillColor('none');
$modern->setStrokeColor('#146c74');
$modern->setStrokeWidth(10);
$modern->setStrokeOpacity(0.5);
$modern->rectangle(25, 40, 135, 180);
$right->drawImage($modern);
$modern->clear();
$image->compositeImage($left, Imagick::COMPOSITE_OVER, 0, 0);
$image->compositeImage($right, Imagick::COMPOSITE_OVER, 200, 0);
$left->clear();
$right->clear();
$path = __DIR__ . '/legacy-stroke-and-modern-opacity.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'legacy-stroke-and-modern-opacity.png', "\n";
$image->clear();

Результат: legacy-stroke-and-modern-opacity.png 360×220. Две одинаковые полупрозрачные рамки без заливки на прозрачном холсте. Для строгого сравнения обе нарисованы в одинаковых координатах на независимых панелях 160×220, затем вставлены в общий PNG. В середине alpha 0, на прямом участке контура около 0.5. Слева alias с ожидаемым предупреждением, справа современный setStrokeOpacity. Консоль до имени файла: deprecated=1; replacement=setStrokeOpacity. Сохраните example.php в отдельной папке и выполните php example.php при PHP с imagick. PNG появится рядом; откройте его обычным просмотрщиком при 100%. Прозрачный PNG смотрите на светлом и тёмном фоне: белый фон просмотрщика не доказывает отсутствие alpha. Шрифты, входные файлы, интернет и shell-команды не нужны. Повторный запуск заменяет одноимённый учебный PNG.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 220, 'none');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setFillColor('#ffe08a');
$draw->setFillOpacity(1);
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(10);
$deprecated = 0;
set_error_handler(static function (int $severity, string $message) use (&$deprecated): bool {
    if ($severity === E_DEPRECATED && str_contains($message, 'ImagickDraw::setStrokeAlpha')) {
        ++$deprecated;
        return true;
    }
    return false;
}, E_DEPRECATED);
try {
    $draw->setStrokeAlpha(0.25);
} finally {
    restore_error_handler();
}
if ($deprecated !== 1) {
    throw new LogicException('Ожидалось одно предупреждение устаревшего setStrokeAlpha в этой сборке');
}
echo 'deprecated=1; replacement=setStrokeOpacity', "\n";
$draw->rectangle(25, 40, 135, 180);
$image->drawImage($draw);
$draw->clear();
$modern = new ImagickDraw();
$modern->setFillColor('#ffe08a');
$modern->setFillOpacity(1);
$modern->setStrokeColor('#146c74');
$modern->setStrokeOpacity(0.25);
$modern->setStrokeWidth(10);
$modern->rectangle(225, 40, 335, 180);
$image->drawImage($modern);
$modern->clear();
$path = __DIR__ . '/soft-outline-opaque-fill.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'soft-outline-opaque-fill.png', "\n";
$image->clear();

Результат: soft-outline-opaque-fill.png 360×220. Два одинаковых золотистых блока на прозрачном фоне: центры имеют alpha 1, внешняя часть контура около 0.25, снаружи alpha 0. На участке наложения полупрозрачной обводки поверх уже непрозрачной заливки результирующая alpha остаётся 1; для проверки 0.25 берём наружную половину stroke. Консоль до имени файла: deprecated=1; replacement=setStrokeOpacity. Сохраните example.php в отдельной папке и выполните php example.php при PHP с imagick. PNG появится рядом; откройте его обычным просмотрщиком при 100%. Прозрачный PNG смотрите на светлом и тёмном фоне: белый фон просмотрщика не доказывает отсутствие alpha. Шрифты, входные файлы, интернет и shell-команды не нужны. Повторный запуск заменяет одноимённый учебный PNG.