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

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(240, 180, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setFillColor('#bdebe2');
$draw->rectangle(30, 30, 210, 150);
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/constructor-card.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'constructor-card.png', "\n";
$image->clear();

При успешном выполнении создаётся constructor-card.png 240×180. Мятная карточка (30,30)—(210,150), бирюзовый край толщиной 4 на белом холсте. new создал Draw; только rectangle записал фигуру, drawImage нанёс её на изображение. Последняя строка — constructor-card.png.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(320, 200, 'white');
$image->setImageFormat('png');
$grid = new ImagickDraw();
$grid->setStrokeColor('#d6e1df');
$grid->setStrokeWidth(1);
$grid->setFillColor('none');
foreach ([40, 80, 120, 160] as $y) {
    $grid->line(10, $y, 310, $y);
}
$image->drawImage($grid);
$grid->clear();
$card = new ImagickDraw();
$card->setStrokeColor('#146c74');
$card->setStrokeWidth(4);
$card->setFillColor('#bdebe2');
$card->rectangle(60, 30, 260, 150);
$card->line(80, 70, 240, 70);
$card->line(80, 110, 190, 110);
$image->drawImage($card);
$card->clear();
unset($grid, $card);
$path = __DIR__ . '/separate-components.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'separate-components.png', "\n";
$image->clear();

Результат: separate-components.png 320×200. Серая сетка видна в полях, поверх неё лежит непрозрачная мятная карточка с двумя бирюзовыми строками. Карточка не изменила состояние сетки, потому что new создал второй Draw; применение каждого объекта выполнено отдельно. Последняя строка — separate-components.png.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(300, 180, 'white');
$image->setImageFormat('png');
$base = new ImagickDraw();
$base->setStrokeColor('#146c74');
$base->setStrokeWidth(4);
$base->setFillColor('#bdebe2');
$copy = $base->clone(); // Исторический метод; в новом коде: $copy = clone $base;
$copy->setFillColor('#c25732');
$base->rectangle(20, 30, 120, 130);
$copy->rectangle(160, 30, 260, 130);
$image->drawImage($base);
$image->drawImage($copy);
echo 'same-object=', $base === $copy ? 'yes' : 'no', "\n";
$base->clear();
$copy->clear();
$path = __DIR__ . '/independent-copy.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'independent-copy.png', "\n";
$image->clear();

При успешном выполнении создаётся independent-copy.png 300×180. Слева мятная карточка, справа оранжевая. База клонирована до записи фигур, поэтому каждая очередь содержит только свою карточку. === сравнивает идентичность объектов, а не сходство рисунков. В текущем binding метод clone() помечен deprecated; он может дополнительно выдать E_DEPRECATED в зависимости от настройки диагностики. Перед именем файла консоль: same-object=no. Последняя строка — independent-copy.png.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(280, 180, 'white');
$image->setImageFormat('png');
$base = new ImagickDraw();
$base->setStrokeColor('#146c74');
$base->setStrokeWidth(4);
$base->setFillColor('#bdebe2');
$base->rectangle(20, 30, 120, 130);
$copy = $base->clone(); // Исторический API; современная запись: $copy = clone $base;
$copy->setFillColor('#f1c6b7');
$copy->circle(210, 80, 245, 80);
$image->drawImage($copy);
$base->clear();
$copy->clear();
unset($base, $copy);
$path = __DIR__ . '/copied-commands.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'copied-commands.png', "\n";
$image->clear();

Результат: copied-commands.png 280×180. Мятная карточка слева и персиковый круг справа. Rectangle пришёл в копию вместе с записанной очередью; круг добавлен после копирования. Исходную базу отдельно не применяем: иначе её команды могли бы повторно наложиться, что особенно заметно с opacity. Возможен E_DEPRECATED от исторического clone() в дополнение к имени файла. Последняя строка — copied-commands.png.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(280, 180, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setFillColor('#bdebe2');
$draw->rectangle(20, 30, 120, 130);
$ok = $draw->clear();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setFillColor('#f1c6b7');
$draw->circle(210, 80, 245, 80);
$image->drawImage($draw);
echo 'clear=', $ok ? 'true' : 'false', '; type=', get_debug_type($ok), "\n";
$draw->clear();
$path = __DIR__ . '/cancelled-draft.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'cancelled-draft.png', "\n";
$image->clear();

При успешном выполнении создаётся cancelled-draft.png 280×180. Остаётся только персиковый круг с центром (210,80), радиусом 35 и бирюзовым краем. Мятный rectangle был удалён из очереди до её применения. После clear цвет и толщина заданы заново: прежние настройки тоже сброшены. Перед именем файла консоль: clear=true; type=bool. Последняя строка — cancelled-draft.png.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(280, 180, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setFillColor('#bdebe2');
$draw->rectangle(20, 30, 120, 130);
$image->drawImage($draw);
$draw->clear();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setFillColor('#f1c6b7');
$draw->circle(210, 80, 245, 80);
$image->drawImage($draw);
$draw->clear();
unset($draw);
$path = __DIR__ . '/raster-survives-clear.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'raster-survives-clear.png', "\n";
$image->clear();

Результат: raster-survives-clear.png 280×180. На PNG остаются обе фигуры: мятный rectangle и персиковый круг. Первый уже стал пикселями $image до clear. При втором drawImage применяется только круг; clear не очищает растровый холст и не является undo. Последняя строка — raster-survives-clear.png.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(240, 180, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setFillColor('#bdebe2');
$draw->rectangle(30, 30, 210, 150);
$image->drawImage($draw);
$ok = $draw->destroy();
echo 'destroy=', $ok ? 'true' : 'false', '; type=', get_debug_type($ok), "\n";
unset($draw);
$path = __DIR__ . '/image-after-destroy.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'image-after-destroy.png', "\n";
$image->clear();

При успешном выполнении создаётся image-after-destroy.png 240×180. Сохранённая мятная карточка остаётся на $image после вызова destroy у Draw. В проверенной регистрации PHP binding destroy — alias clear, а не удаление $image и не оператор unset. После вызова программа отпускает имя $draw и больше с ним не работает. Перед именем файла консоль: destroy=true; type=bool. Последняя строка — image-after-destroy.png.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(280, 180, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setFillColor('#bdebe2');
$alias = $draw;
$draw->rectangle(20, 30, 120, 130);
$alias->destroy(); // В проверенном binding это alias clear.
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setFillColor('#f1c6b7');
$draw->circle(210, 80, 245, 80);
$image->drawImage($draw);
echo 'same-object=', $alias === $draw ? 'yes' : 'no', "\n";
$draw->clear();
unset($alias, $draw);
$path = __DIR__ . '/shared-reset.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'shared-reset.png', "\n";
$image->clear();

Результат: shared-reset.png 280×180. Только персиковый круг: pending rectangle удалён из общего Draw вызовом через $alias. Имя $draw осталось, но команды и настройки были сброшены; перед новым кругом стиль задан явно. Это пример проверенной привязки destroy→clear, а не универсальное обещание семантики произвольной старой версии или метода с таким именем в другом классе. Перед именем файла консоль: same-object=yes. Последняя строка — shared-reset.png.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(320, 180, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setFillColor('#bdebe2');
$draw->rectangle(20, 40, 100, 140);
$draw->push();
$draw->setFillColor('#c25732');
$draw->rectangle(120, 40, 200, 140);
$draw->pop();
$draw->rectangle(220, 40, 300, 140);
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/temporary-style.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'temporary-style.png', "\n";
$image->clear();

При успешном выполнении создаётся temporary-style.png 320×180. Три карточки: мятная, оранжевая, снова мятная. Push сохранил состояние перед временным цветом; pop вернул его. Все три rectangle остаются в общей очереди и применяются одним drawImage. Последняя строка — temporary-style.png.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 240, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setFillColor('#bdebe2');
$draw->push();
$draw->setFillColor('#f1c6b7');
$draw->rectangle(20, 20, 340, 160);
$draw->push();
$draw->setFillColor('#c5cee8');
$draw->circle(180, 90, 210, 90);
$draw->pop();
$draw->rectangle(30, 180, 150, 215);
$draw->pop();
$draw->rectangle(210, 180, 330, 215);
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/nested-themes.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'nested-themes.png', "\n";
$image->clear();

Результат: nested-themes.png 360×240. Сверху персиковая панель с сиреневым кругом. Снизу левый образец персиковый после первого pop, правый мятный после второго. Порядок — LIFO: последняя сохранённая тема возвращается первой. Два push сбалансированы двумя pop; обе ранее записанные фигуры сохранились. Последняя строка — nested-themes.png.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(320, 180, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setFillColor('#bdebe2');
$draw->rectangle(20, 40, 100, 140);
$draw->push();
$draw->setFillColor('#c25732');
$draw->rectangle(120, 40, 200, 140);
$draw->pop();
$draw->rectangle(220, 40, 300, 140);
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/restored-style.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'restored-style.png', "\n";
$image->clear();

При успешном выполнении создаётся restored-style.png 320×180. Три карточки: мятная, оранжевая, мятная. Pop восстановил настройки последующих фигур, не отменив оранжевую карточку. Он вернул bool успеха, а не новый объект и не предыдущий растровый кадр. Последняя строка — restored-style.png.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(320, 180, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setFillColor('#bdebe2');
$draw->rectangle(20, 40, 100, 140);
try {
    $draw->push();
    try {
        $draw->setFillColor('#c25732');
        $draw->rectangle(120, 40, 200, 140);
        throw new RuntimeException('demo: incomplete data');
    } finally {
        $draw->pop();
    }
} catch (RuntimeException $error) {
    echo 'handled=', $error->getMessage(), "\n";
}
$draw->rectangle(220, 40, 300, 140);
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/restored-after-failure.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'restored-after-failure.png', "\n";
$image->clear();

Результат: restored-after-failure.png 320×180. Три карточки всё ещё мятная/оранжевая/мятная: finally восстановил тему последней, но pop не откатил уже записанную среднюю. Для атомарного компонента готовьте его в отдельном Draw/копии и применяйте только после успеха; clear удалил бы всю очередь, включая удачную первую фигуру. Перед именем файла консоль: handled=demo: incomplete data. Последняя строка — restored-after-failure.png.