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

<?php
declare(strict_types=1);
require __DIR__.'/background-fixture.php';
bgRestore();
$svg=(string)file_get_contents(__DIR__.'/logo.svg');
$sourceHash=hash('sha256',$svg);
$transparent = new Imagick();
$returned = $transparent->setBackgroundColor('transparent');
$transparent->readImageBlob($svg);
$white = bgRender('white', $svg);
$color = bgRender('#ffe8c2', $svg);
$pixelColor = bgRender(new ImagickPixel('#ffe8c2'), $svg);
$default = new Imagick();
$default->readImageBlob($svg);
$saved = [
    'transparent'=>bgSave($transparent,'first-transparent.png'),
    'white'=>bgSave($white,'first-white.png'),
    'color'=>bgSave($color,'first-color.png'),
];
$t = new Imagick(__DIR__.'/first-transparent.png');
$w = new Imagick(__DIR__.'/first-white.png');
$c = new Imagick(__DIR__.'/first-color.png');
$views = [bgView($t), bgView($w), bgView($c)];
$images = ['transparent'=>bgImage($views[0],'first-transparent-view8.png'),'white'=>bgImage($views[1],'first-white-view8.png'),'color'=>bgImage($views[2],'first-color-view8.png')];
$rects = bgCompare($views,'read-background-first.png');
bgDiagnostic('read-background-first',[
 'executed_api'=>['setBackgroundColor'],'returned'=>$returned,'returned_type'=>get_debug_type($returned),'declared_return'=>(string)(new ReflectionMethod(Imagick::class,'setBackgroundColor'))->getReturnType(),
 'native'=>['transparent'=>bgState($transparent),'white'=>bgState($white),'color'=>bgState($color),'pixel_color'=>bgState($pixelColor),'default'=>bgState($default)],'saved'=>$saved,
 'images'=>$images,'panel_keys'=>['transparent','white','color'],'panel_geometry'=>$rects,'source_sha256'=>$sourceHash,'source_unchanged'=>hash_file('sha256',__DIR__.'/logo.svg')===$sourceHash,
 'checks'=>['returned_true'=>$returned===true,'transparent_corner'=>$saved['transparent']['state']['corner'][3]===0,'white_corner'=>$saved['white']['state']['corner']===[65535,65535,65535,65535],'color_corner'=>$saved['color']['state']['corner']===[65535,59624,49858,65535],'partial_alpha'=>$saved['transparent']['state']['half'][3]>0&&$saved['transparent']['state']['half'][3]<65535,'white_shape_preserved'=>$saved['transparent']['state']['white_shape']===[65535,65535,65535,65535],'pixel_argument_equal'=>bgHash($pixelColor)===bgHash($color),'observed_default_white'=>bgHash($default)===bgHash($white),'geometry'=>$t->getImageGeometry()===['width'=>400,'height'=>320]]
]);
echo "read-background-first.png\nfirst-transparent-view8.png\nfirst-white-view8.png\nfirst-color-view8.png\nfirst-transparent.png\nfirst-white.png\nfirst-color.png\nmetrics.json\nreturned=true corner-alpha=0,65535,65535 white-shape=opaque\n";

Созданы три файла 400×320: прозрачный, с белым фоном и с кремовым #ffe8c2. Белый треугольник остаётся белым во всех вариантах. Полупрозрачный круг смешивается с выбранным фоном. Метод вернул true; строка цвета и ImagickPixel дали одинаковый результат до сохранения. Архив содержит example.php, logo.svg.b64 и background-fixture.php. Распакуйте их рядом и выполните php example.php: SVG восстановится автоматически. Методы изучаемой библиотеки вызываются в основном файле; helper сохраняет результаты, строит просмотры и записывает измерения. Полный helper приведён в конце главы. Проверено в PHP 8.5.11 / Imagick 3.8.1 / ImageMagick 7.1.1-46 Q16, Windows.

<?php
declare(strict_types=1);
require __DIR__.'/background-fixture.php';
bgRestore();
$svg=(string)file_get_contents(__DIR__.'/logo.svg');
$sourceHash=hash('sha256',$svg);
$white = bgRender('white', $svg);
$beforeLate = bgState($white);
$white->setBackgroundColor('transparent');
$afterLate = bgState($white);
$transparent = bgRender('transparent', $svg);
$beforeImageSetting = bgState($transparent);
$transparent->setImageBackgroundColor('white');
$afterImageSetting = bgState($transparent);
$flattened = $transparent->mergeImageLayers(Imagick::LAYERMETHOD_FLATTEN);
$saved = ['before'=>bgSave($transparent,'minimal-before.png'),'flattened'=>bgSave($flattened,'minimal-flatten.png')];
$readBefore = new Imagick(__DIR__.'/minimal-before.png');
$readFlat = new Imagick(__DIR__.'/minimal-flatten.png');
$views = [bgView($readBefore), bgView($readFlat)];
$images = ['before'=>bgImage($views[0],'minimal-before-view8.png'),'flattened'=>bgImage($views[1],'minimal-flatten-view8.png')];
$rects = bgCompare($views,'read-background-minimal.png');
bgDiagnostic('read-background-minimal',[
 'executed_api'=>['setBackgroundColor'],'late'=>['before'=>$beforeLate,'after'=>$afterLate],'image_setting'=>['before'=>$beforeImageSetting,'after'=>$afterImageSetting],'flattened'=>bgState($flattened),'saved'=>$saved,
 'images'=>$images,'panel_keys'=>['before','flattened'],'panel_geometry'=>$rects,'source_sha256'=>$sourceHash,'source_unchanged'=>hash_file('sha256',__DIR__.'/logo.svg')===$sourceHash,
 'checks'=>['late_pixels_unchanged'=>$beforeLate['RGBA16_sha256']===$afterLate['RGBA16_sha256'],'image_setting_pixels_unchanged'=>$beforeImageSetting['RGBA16_sha256']===$afterImageSetting['RGBA16_sha256'],'flatten_changes_pixels'=>bgHash($flattened)!==bgHash($transparent),'flatten_new_object'=>$flattened!==$transparent,'before_transparent'=>$saved['before']['state']['corner'][3]===0,'flatten_white'=>$saved['flattened']['state']['corner']===[65535,65535,65535,65535],'white_shape_preserved'=>$saved['before']['state']['white_shape']===$saved['flattened']['state']['white_shape']]
]);
echo "read-background-minimal.png\nminimal-before-view8.png\nminimal-flatten-view8.png\nminimal-before.png\nminimal-flatten.png\nmetrics.json\nlate-set=unchanged image-setting=unchanged flatten-alpha=65535\n";

Поздний setBackgroundColor не изменил ранее полученные пиксели. setImageBackgroundColor на прозрачном изображении тоже только задал свойство. Реальное объединение с белым фоном выполнено mergeImageLayers; сохранённый minimal-flatten.png стал непрозрачным. Архив содержит example.php, logo.svg.b64 и background-fixture.php. Распакуйте их рядом и выполните php example.php: SVG восстановится автоматически. Методы изучаемой библиотеки вызываются в основном файле; helper сохраняет результаты, строит просмотры и записывает измерения. Полный helper приведён в конце главы. Проверено в PHP 8.5.11 / Imagick 3.8.1 / ImageMagick 7.1.1-46 Q16, Windows.

<?php
declare(strict_types=1);
require __DIR__.'/background-fixture.php';
bgRestore();
$svg=(string)file_get_contents(__DIR__.'/logo.svg');
$sourceHash=hash('sha256',$svg);
$reused = new Imagick();
$reused->setBackgroundColor('#ffe8c2');
$reused->readImageBlob($svg);
$reused->setIteratorIndex(0);
$firstState = bgState($reused);
$reused->readImageBlob($svg);
$reused->setIteratorIndex(1);
$secondState = bgState($reused);
$savedReused = bgSave($reused,'controls-reused.png');
$reused->setBackgroundColor('transparent');
$reused->readImageBlob($svg);
$reused->setIteratorIndex(2);
$thirdState = bgState($reused);
$fresh = bgRender('transparent', $svg);
$paintedSvg = str_replace('<rect x="60"','<rect width="400" height="320" fill="white"/><rect x="60"',$svg);
$painted = bgRender('transparent', $paintedSvg);
$saved = ['reused'=>$savedReused,'fresh'=>bgSave($fresh,'controls-fresh.png'),'painted'=>bgSave($painted,'controls-painted.png')];
$views = [bgView(new Imagick(__DIR__.'/controls-reused.png')),bgView(new Imagick(__DIR__.'/controls-fresh.png')),bgView(new Imagick(__DIR__.'/controls-painted.png'))];
$images = ['reused'=>bgImage($views[0],'controls-reused-view8.png'),'fresh'=>bgImage($views[1],'controls-fresh-view8.png'),'painted'=>bgImage($views[2],'controls-painted-view8.png')];
$rects = bgCompare($views,'read-background-controls.png');
$errors = [
 'invalid_color'=>bgTry(fn()=>(new Imagick())->setBackgroundColor('not-a-real-color-xyz')),
 'array'=>bgTry(fn()=>(new Imagick())->setBackgroundColor([])),
 'image_background_empty'=>bgTry(fn()=>(new Imagick())->setImageBackgroundColor('white')),
];
bgDiagnostic('read-background-controls',[
 'executed_api'=>['setBackgroundColor'],'reuse'=>['count'=>$reused->getNumberImages(),'first'=>$firstState,'second'=>$secondState,'third'=>$thirdState],'fresh'=>bgState($fresh),'painted'=>bgState($painted),'painted_svg_sha256'=>hash('sha256',$paintedSvg),'saved'=>$saved,'errors'=>$errors,
 'images'=>$images,'panel_keys'=>['reused','fresh','painted'],'panel_geometry'=>$rects,'source_sha256'=>$sourceHash,'source_unchanged'=>hash_file('sha256',__DIR__.'/logo.svg')===$sourceHash,
 'checks'=>['three_images'=>$reused->getNumberImages()===3,'setting_reused'=>$firstState['RGBA16_sha256']===$secondState['RGBA16_sha256'],'explicit_change_applies_next'=>$thirdState['RGBA16_sha256']===bgHash($fresh),'paint_is_not_removed'=>$saved['painted']['state']['corner']===[65535,65535,65535,65535],'fresh_alpha'=>$saved['fresh']['state']['corner'][3]===0,'invalid_color_caught'=>($errors['invalid_color']['error']['class']??null)==='ImagickException','array_caught'=>($errors['array']['error']['class']??null)==='ImagickException','wrong_method_empty_caught'=>($errors['image_background_empty']['error']['class']??null)==='ImagickException']
]);
echo "read-background-controls.png\ncontrols-reused-view8.png\ncontrols-fresh-view8.png\ncontrols-painted-view8.png\ncontrols-reused.png\ncontrols-fresh.png\ncontrols-painted.png\nmetrics.json\nimages=3 reused=cream third=transparent painted=white errors=3\n";

Второе чтение тем же объектом использовало прежний кремовый фон. После явной настройки transparent третий кадр стал прозрачным. Новый объект настроен независимо. Сплошная белая фигура внутри другого SVG осталась видна, несмотря на transparent. Три ошибочных вызова перехвачены. Архив содержит example.php, logo.svg.b64 и background-fixture.php. Распакуйте их рядом и выполните php example.php: SVG восстановится автоматически. Методы изучаемой библиотеки вызываются в основном файле; helper сохраняет результаты, строит просмотры и записывает измерения. Полный helper приведён в конце главы. Проверено в PHP 8.5.11 / Imagick 3.8.1 / ImageMagick 7.1.1-46 Q16, Windows.

<?php
declare(strict_types=1);
require __DIR__.'/background-fixture.php';
bgRestore();
$svg=(string)file_get_contents(__DIR__.'/logo.svg');
$sourceHash=hash('sha256',$svg);
function exportLogo(string $svg, string $background, string $filename): array
{
    $image = new Imagick();
    $image->setBackgroundColor($background);
    $image->readImageBlob($svg);
    $beforeSave = bgState($image);
    $saved = bgSave($image, $filename);
    $read = new Imagick(__DIR__ . '/' . $filename);
    return [
        'background' => $background,
        'before_save' => $beforeSave,
        'saved' => $saved,
        'readback' => bgState($read),
    ];
}

$web = exportLogo($svg, 'transparent', 'logo-web.png');
$header = exportLogo($svg, '#203e4a', 'logo-header.png');
$report = ['web' => $web, 'header' => $header];
file_put_contents(__DIR__ . '/export-report.json', json_encode(
    $report, JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR
) . "\n");
$readReport = json_decode(
    (string) file_get_contents(__DIR__ . '/export-report.json'),
    true, 512, JSON_THROW_ON_ERROR
);
$webRead = new Imagick(__DIR__ . '/logo-web.png');
$headerRead = new Imagick(__DIR__ . '/logo-header.png');
$lateHeader = clone $webRead;
$lateHeader->setBackgroundColor('#203e4a');
$views = [bgView($webRead), bgView($headerRead)];
$images = ['web'=>bgImage($views[0],'workflow-web-view8.png'),'header'=>bgImage($views[1],'workflow-header-view8.png')];
$rects = bgCompare($views,'read-background-workflow.png');
bgDiagnostic('read-background-workflow',[
 'executed_api'=>['setBackgroundColor'],'report'=>$report,'read_report'=>$readReport,'late_PNG_setting'=>['before'=>bgState($webRead),'after'=>bgState($lateHeader)],
 'images'=>$images,'panel_keys'=>['web','header'],'panel_geometry'=>$rects,'source_sha256'=>$sourceHash,'source_unchanged'=>hash_file('sha256',__DIR__.'/logo.svg')===$sourceHash,
 'checks'=>['web_alpha'=>$web['readback']['corner'][3]===0,'header_opaque'=>$header['readback']['corner']===[8224,15934,19018,65535],'report_readback'=>$report===$readReport,'actual_file_readback'=>$web['saved']['state']===$web['readback']&&$header['saved']['state']===$header['readback'],'white_shape_preserved'=>$web['readback']['white_shape']===[65535,65535,65535,65535],'same_geometry'=>$web['readback']['geometry']===$header['readback']['geometry'],'late_PNG_unchanged'=>bgHash($webRead)===bgHash($lateHeader)]
]);
echo "read-background-workflow.png\nworkflow-web-view8.png\nworkflow-header-view8.png\nlogo-web.png\nlogo-header.png\nexport-report.json\nmetrics.json\nweb-alpha=0 header-alpha=65535 report=read-back late-PNG=unchanged\n";

Функция создаёт отдельный объект для каждого результата: logo-web.png содержит настоящую прозрачность, logo-header.png — тёмный фон #203e4a. Оба файла и JSON-отчёт действительно прочитаны заново. Настройка фона на уже открытом PNG не перекрасила его. Архив содержит example.php, logo.svg.b64 и background-fixture.php. Распакуйте их рядом и выполните php example.php: SVG восстановится автоматически. Методы изучаемой библиотеки вызываются в основном файле; helper сохраняет результаты, строит просмотры и записывает измерения. Полный helper приведён в конце главы. Проверено в PHP 8.5.11 / Imagick 3.8.1 / ImageMagick 7.1.1-46 Q16, Windows.