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->setStrokeOpacity(1);
$draw->setFillColor('#bdebe2');
$draw->setFillOpacity(1);
$draw->setFillColor('#bdebe2');
$draw->setFillOpacity(1);
$value = $draw->getFillColor();
$rgb = $value->getColor(0);
echo 'type=', get_debug_type($value), '; rgb=', $rgb['r'], ',', $rgb['g'], ',', $rgb['b'], "\n";
$value->clear();
$draw->rectangle(40, 35, 200, 145);
$image->drawImage($draw);
$path = __DIR__ . '/getfillcolor-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'getfillcolor-basic.png', "\n";
$draw->clear();
$image->clear();

При успешном выполнении создаётся getfillcolor-basic.png 240×180. Прямоугольник (40,35)—(200,145) с мятной заливкой #bdebe2 и отдельной бирюзовой обводкой #146c74 толщиной 4 на белом фоне. Перед именем файла консоль: type=ImagickPixel; rgb=189,235,226. Последняя строка — getfillcolor-basic.png. Getter читает состояние Draw; он не вычисляет эти свойства из сохранённого 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->setStrokeOpacity(1);
$draw->setFillColor('#bdebe2');
$draw->setFillOpacity(1);
$draw->setFillColor('#bdebe2');
$variant = $draw->getFillColor();
$variant->setColor('#c25732');
$draw->rectangle(30, 25, 290, 75);
$draw->setFillColor($variant);
$draw->rectangle(30, 100, 290, 150);
$rgb = $variant->getColor(0);
echo 'variant-rgb=', $rgb['r'], ',', $rgb['g'], ',', $rgb['b'], "\n";
$variant->clear();
$image->drawImage($draw);
$path = __DIR__ . '/theme-variant.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'theme-variant.png', "\n";
$draw->clear();
$image->clear();

Результат: theme-variant.png 320×180. Верхняя карточка мятная, нижняя оранжевая, обе с бирюзовым краем. Правка отдельного ImagickPixel не изменила Draw; цвет нижней применён явным setFillColor. Снимок освобождён после передачи, когда он больше не нужен. Перед именем файла консоль: variant-rgb=194,87,50. Последняя строка — theme-variant.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->setStrokeOpacity(1);
$draw->setFillColor('#bdebe2');
$draw->setFillOpacity(1);
$draw->setFillColor('#bdebe2');
$draw->setFillOpacity(1);
$draw->rectangle(40, 35, 200, 145);
$image->drawImage($draw);
$path = __DIR__ . '/setfillcolor-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'setfillcolor-basic.png', "\n";
$draw->clear();
$image->clear();

При успешном выполнении создаётся setfillcolor-basic.png 240×180. Прямоугольник (40,35)—(200,145) с мятной заливкой #bdebe2 и отдельной бирюзовой обводкой #146c74 толщиной 4 на белом фоне. Последняя строка — setfillcolor-basic.png. Getter читает состояние Draw; он не вычисляет эти свойства из сохранённого PNG.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(320, 200, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setStrokeOpacity(1);
$draw->setFillColor('#bdebe2');
$draw->setFillOpacity(1);
$palette = ['ready' => '#bdebe2', 'warning' => '#f1c6b7', 'offline' => '#c5cee8'];
foreach (['ready', 'warning', 'offline'] as $index => $state) {
    if (!isset($palette[$state])) {
        throw new InvalidArgumentException('Неизвестный статус');
    }
    $draw->setFillColor($palette[$state]);
    $draw->rectangle(30, 20 + $index * 55, 290, 60 + $index * 55);
}
$image->drawImage($draw);
$path = __DIR__ . '/status-cards.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'status-cards.png', "\n";
$draw->clear();
$image->clear();

Результат: status-cards.png 320×200. Три заполненные карточки сверху вниз: мятная ready, персиковая warning, сиреневая offline. Бирюзовая обводка одинакова. Для настоящего интерфейса рядом нужны подписи/символы: цвет не должен быть единственным обозначением состояния. Последняя строка — status-cards.png.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(240, 180, 'white');
$image->setImageFormat('png');
$background = new ImagickDraw();
$background->setStrokeColor('none');
$background->setFillColor('#dbe8e6');
$background->rectangle(120, 0, 239, 179);
$image->drawImage($background);
$background->clear();
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setStrokeOpacity(1);
$draw->setFillColor('#bdebe2');
$draw->setFillOpacity(1);
$draw->setFillColor('#c25732');
$draw->setFillOpacity(0.5);
$value = $draw->getFillOpacity();
echo 'opacity=', number_format($value, 2, '.', ''), '; type=', get_debug_type($value), "\n";
$draw->rectangle(30, 35, 210, 145);
$image->drawImage($draw);
$path = __DIR__ . '/getfillopacity-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'getfillopacity-basic.png', "\n";
$draw->clear();
$image->clear();

При успешном выполнении создаётся getfillopacity-basic.png 240×180. Оранжевый прямоугольник с opacity 0.5: его левая половина лежит на белом, правая — на #dbe8e6. Внутренние оттенки различаются, а бирюзовый край остаётся непрозрачным. Перед именем файла консоль: opacity=0.50; type=float. Последняя строка — getfillopacity-basic.png. Getter читает состояние Draw; он не вычисляет эти свойства из сохранённого PNG.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(320, 195, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setStrokeOpacity(1);
$draw->setFillColor('#bdebe2');
$draw->setFillOpacity(1);
$draw->setFillColor('#c25732');
$draw->setFillOpacity(0.35);
$draw->rectangle(20, 20, 300, 110);
$opacity = $draw->getFillOpacity();
$legend = new ImagickDraw();
$legend->setStrokeColor('#146c74');
$legend->setStrokeWidth(4);
$legend->setFillColor('#c25732');
$legend->setFillOpacity($opacity);
$legend->rectangle(20, 135, 80, 170);
$image->drawImage($legend);
$legend->clear();
echo 'legend-opacity=', number_format($opacity, 2, '.', ''), "\n";
$image->drawImage($draw);
$path = __DIR__ . '/consistent-legend.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'consistent-legend.png', "\n";
$draw->clear();
$image->clear();

Результат: consistent-legend.png 320×195. Большая область сверху и небольшой образец слева снизу имеют один оттенок оранжевой заливки на белом фоне и непрозрачный бирюзовый край. Измените 0.35 на 0.65 в первом Draw — легенда получит новое значение через getter автоматически. Перед именем файла консоль: legend-opacity=0.35. Последняя строка — consistent-legend.png.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(240, 180, 'white');
$image->setImageFormat('png');
$background = new ImagickDraw();
$background->setStrokeColor('none');
$background->setFillColor('#dbe8e6');
$background->rectangle(120, 0, 239, 179);
$image->drawImage($background);
$background->clear();
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setStrokeOpacity(1);
$draw->setFillColor('#bdebe2');
$draw->setFillOpacity(1);
$draw->setFillColor('#c25732');
$draw->setFillOpacity(0.5);
$draw->rectangle(30, 35, 210, 145);
$image->drawImage($draw);
$path = __DIR__ . '/setfillopacity-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'setfillopacity-basic.png', "\n";
$draw->clear();
$image->clear();

При успешном выполнении создаётся setfillopacity-basic.png 240×180. Оранжевый прямоугольник с opacity 0.5: его левая половина лежит на белом, правая — на #dbe8e6. Внутренние оттенки различаются, а бирюзовый край остаётся непрозрачным. Последняя строка — setfillopacity-basic.png. Getter читает состояние Draw; он не вычисляет эти свойства из сохранённого PNG.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(320, 200, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setStrokeOpacity(1);
$draw->setFillColor('#bdebe2');
$draw->setFillOpacity(1);
$grid = new ImagickDraw();
$grid->setStrokeColor('#d6e1df');
$grid->setStrokeWidth(1);
foreach ([40, 80, 120, 160] as $y) {
    $grid->line(15, $y, 305, $y);
}
$image->drawImage($grid);
$grid->clear();
$opacity = 0.35;
if (!is_finite($opacity) || $opacity < 0 || $opacity > 1) {
    throw new InvalidArgumentException('Opacity должна быть от 0 до 1');
}
$draw->setFillColor('#c25732');
$draw->setFillOpacity($opacity);
$draw->rectangle(40, 30, 280, 170);
$image->drawImage($draw);
$path = __DIR__ . '/range-highlight.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'range-highlight.png', "\n";
$draw->clear();
$image->clear();

Результат: range-highlight.png 320×200. Оранжевая полупрозрачная область (40,30)—(280,170) лежит поверх четырёх горизонталей. Сетка видна внутри, бирюзовый край не стал прозрачным. Это смешивание нового слоя, а не изменение старых пикселей сетки или прозрачности всего PNG. Последняя строка — range-highlight.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(3);
$draw->setStrokeOpacity(1);
$draw->setFillColor('#bdebe2');
$draw->setFillOpacity(1);
$draw->setFillRule(Imagick::FILLRULE_EVENODD);
$value = $draw->getFillRule();
echo 'rule=', $value === Imagick::FILLRULE_EVENODD ? 'evenodd' : 'other', '; type=', get_debug_type($value), "\n";
$draw->pathStart();
$draw->pathMoveToAbsolute(40, 20);
$draw->pathLineToAbsolute(200, 20);
$draw->pathLineToAbsolute(200, 160);
$draw->pathLineToAbsolute(40, 160);
$draw->pathClose();
$draw->pathMoveToAbsolute(80, 60);
$draw->pathLineToAbsolute(160, 60);
$draw->pathLineToAbsolute(160, 120);
$draw->pathLineToAbsolute(80, 120);
$draw->pathClose();
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/getfillrule-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'getfillrule-basic.png', "\n";
$draw->clear();
$image->clear();

При успешном выполнении создаётся getfillrule-basic.png 240×180. Мятная прямоугольная рамка: наружный контур (40,20)—(200,160), внутренний (80,60)—(160,120). Центр остаётся белым фоном, поскольку evenodd исключает область внутри двух вложенных контуров одного пути. Перед именем файла консоль: rule=evenodd; type=int. Последняя строка — getfillrule-basic.png. Getter читает состояние Draw; он не вычисляет эти свойства из сохранённого 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(3);
$draw->setStrokeOpacity(1);
$draw->setFillColor('#bdebe2');
$draw->setFillOpacity(1);
$draw->setFillRule(Imagick::FILLRULE_NONZERO);
$before = $draw->getFillRule();
if ($before !== Imagick::FILLRULE_EVENODD) {
    $draw->setFillRule(Imagick::FILLRULE_EVENODD);
}
echo 'before=', $before === Imagick::FILLRULE_NONZERO ? 'nonzero' : 'other', '; after=',
    $draw->getFillRule() === Imagick::FILLRULE_EVENODD ? 'evenodd' : 'other', "\n";
$draw->pathStart();
$draw->pathMoveToAbsolute(40, 20);
$draw->pathLineToAbsolute(200, 20);
$draw->pathLineToAbsolute(200, 160);
$draw->pathLineToAbsolute(40, 160);
$draw->pathClose();
$draw->pathMoveToAbsolute(80, 60);
$draw->pathLineToAbsolute(160, 60);
$draw->pathLineToAbsolute(160, 120);
$draw->pathLineToAbsolute(80, 120);
$draw->pathClose();
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/checked-window.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'checked-window.png', "\n";
$draw->clear();
$image->clear();

Результат: checked-window.png 240×180. Рамка с мятным телом и непрокрашенным центральным окном. Решение принято по прочитанной настройке, а не по магическому номеру константы. Если компонент уже получил evenodd, условие не назначит его повторно; это политика этого компонента, не универсальное исправление любых импортированных SVG. Перед именем файла консоль: before=nonzero; after=evenodd. Последняя строка — checked-window.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(3);
$draw->setStrokeOpacity(1);
$draw->setFillColor('#bdebe2');
$draw->setFillOpacity(1);
$draw->setFillRule(Imagick::FILLRULE_EVENODD);
$draw->pathStart();
$draw->pathMoveToAbsolute(40, 20);
$draw->pathLineToAbsolute(200, 20);
$draw->pathLineToAbsolute(200, 160);
$draw->pathLineToAbsolute(40, 160);
$draw->pathClose();
$draw->pathMoveToAbsolute(80, 60);
$draw->pathLineToAbsolute(160, 60);
$draw->pathLineToAbsolute(160, 120);
$draw->pathLineToAbsolute(80, 120);
$draw->pathClose();
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/setfillrule-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'setfillrule-basic.png', "\n";
$draw->clear();
$image->clear();

При успешном выполнении создаётся setfillrule-basic.png 240×180. Мятная прямоугольная рамка: наружный контур (40,20)—(200,160), внутренний (80,60)—(160,120). Центр остаётся белым фоном, поскольку evenodd исключает область внутри двух вложенных контуров одного пути. Последняя строка — setfillrule-basic.png. Getter читает состояние Draw; он не вычисляет эти свойства из сохранённого 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(3);
$draw->setStrokeOpacity(1);
$draw->setFillColor('#bdebe2');
$draw->setFillOpacity(1);
$draw->setFillRule(Imagick::FILLRULE_NONZERO);
$outer = [[40, 20], [200, 20], [200, 160], [40, 160]];
$inner = [[80, 60], [160, 60], [160, 120], [80, 120]];
$contours = [$outer, array_reverse($inner)];
$draw->pathStart();
foreach ($contours as $points) {
    $first = array_shift($points);
    $draw->pathMoveToAbsolute($first[0], $first[1]);
    foreach ($points as [$x, $y]) {
        $draw->pathLineToAbsolute($x, $y);
    }
    $draw->pathClose();
}
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/nonzero-window.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'nonzero-window.png', "\n";
$draw->clear();
$image->clear();

Результат: nonzero-window.png 240×180. Та же мятная рамка с окном, теперь NONZERO. array_reverse разворачивает внутренний обход; внешний остаётся прежним. Если убрать разворот, центр закрасится. Это решение для двух простых вложенных контуров: произвольные самопересечения и булевы операции фигур требуют отдельного геометрического разбора. Последняя строка — nonzero-window.png.