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

<?php
declare(strict_types=1);
require __DIR__ . '/legacy-map-fixture.php';
lmRestore();
$source = new Imagick(__DIR__ . '/poster.png');
$palette = new Imagick(__DIR__ . '/palette.png');
$sticker = new Imagick(__DIR__ . '/sticker.png');
$sourceBefore = lmState($source);
$paletteBefore = lmState($palette);
$stickerBefore = lmState($sticker);
$sourceHash = hash_file('sha256', __DIR__ . '/poster.png');
$image = clone $source;
$ok = $image->remapImage($palette, Imagick::DITHERMETHOD_NO);
$saved = lmSave($image, 'poster-limited.png');
$read = new Imagick(__DIR__ . '/poster-limited.png');
$audit = lmAudit($read, $palette);
$views = [lmView($source),lmPaletteView($palette),lmView($read)];
$images = ['source'=>lmImage($views[0],'first-source8.png'),'palette'=>lmImage($views[1],'first-palette8.png'),'result'=>lmImage($views[2],'first-result8.png')];
$rects = lmCompare($views,'legacy-map-first.png');
lmDiagnostic('legacy-map-first',[
 'set_return'=>$ok,'mapped_state'=>lmState($image),'saved'=>$saved,'readback'=>lmState($read),'audit'=>$audit,'palette_view'=>['input_geometry'=>[4,1],'display_geometry'=>[400,320],'stripe_width'=>100,'order'=>['#182e43','#208494','#e2a040','#f6ecd6']],
 'images'=>$images,'panel_keys'=>['source','palette','result'],'panel_geometry'=>$rects,'source_before'=>$sourceBefore,'source_after'=>lmState($source),'source_sha256'=>$sourceHash,'source_unchanged'=>lmState($source)===$sourceBefore&&hash_file('sha256',__DIR__.'/poster.png')===$sourceHash,'palette_before'=>$paletteBefore,'palette_after'=>lmState($palette),
 'checks'=>['legacy_unavailable'=>!method_exists(Imagick::class,'mapImage'),'current_available'=>method_exists(Imagick::class,'remapImage'),'return_true'=>$ok===true,'only_reference_rgb'=>$audit['all_rgb_in_palette'],'four_colors'=>$audit['rgb_color_count']===4,'palette_unchanged'=>lmState($palette)===$paletteBefore,'geometry_preserved'=>$read->getImageGeometry()===['width'=>400,'height'=>320],'saved_pixels_equal'=>lmHash($image)===lmHash($read)]
]);
echo "legacy-map-first.png\nfirst-source8.png\nfirst-palette8.png\nfirst-result8.png\nposter-limited.png\nmetrics.json\nlegacy=unavailable current=remapImage return=true colors=4 palette-membership=passed\n";

Собственный постер сохранён как poster-limited.png размером 400×320. После повторного чтения все RGB принадлежат четырём цветам palette.png. Исходный постер и палитра не изменились. Выполнен remapImage; отсутствующий в этой сборке mapImage не вызывался. В архиве example.php, три файла .png.b64 и legacy-map-fixture.php. Распакуйте всё рядом и выполните php example.php: обычные poster.png, palette.png и sticker.png восстановятся автоматически. Полный helper приведён в конце главы. Проверено в PHP 8.5.11 / Imagick 3.8.1 / ImageMagick 7.1.1-46 Q16, Windows. Реально выполнен современный remapImage; исторический mapImage здесь недоступен и не запускался.

<?php
declare(strict_types=1);
require __DIR__ . '/legacy-map-fixture.php';
lmRestore();
$source = new Imagick(__DIR__ . '/poster.png');
$palette = new Imagick(__DIR__ . '/palette.png');
$sticker = new Imagick(__DIR__ . '/sticker.png');
$sourceBefore = lmState($source);
$paletteBefore = lmState($palette);
$stickerBefore = lmState($sticker);
$sourceHash = hash_file('sha256', __DIR__ . '/poster.png');
function applyPalette(Imagick $source, Imagick $palette, bool $enableDither): Imagick
{
    $result = clone $source;
    $method = $enableDither
        ? Imagick::DITHERMETHOD_FLOYDSTEINBERG
        : Imagick::DITHERMETHOD_NO;
    $result->remapImage($palette, $method);
    return $result;
}
$none = applyPalette($source, $palette, false);
$floyd = applyPalette($source, $palette, true);
$reversePalette = clone $palette;
$reversePalette->flopImage();
$reverseResult = applyPalette($source, $reversePalette, false);
$errors = [
 'empty_source'=>lmTry(fn()=>(new Imagick())->remapImage($palette,Imagick::DITHERMETHOD_NO)),
 'empty_palette'=>lmTry(fn()=>$source->remapImage(new Imagick(),Imagick::DITHERMETHOD_NO)),
 'array_palette'=>lmTry(fn()=>$source->remapImage([],Imagick::DITHERMETHOD_NO)),
 'bool_dither'=>lmTry(fn()=>$source->remapImage($palette,true)),
];
$audits = ['none'=>lmAudit($none,$palette),'floyd'=>lmAudit($floyd,$palette)];
$views = [lmView($none),lmView($floyd)];
$images = ['none'=>lmImage($views[0],'migration-none8.png'),'floyd'=>lmImage($views[1],'migration-floyd8.png')];
$rects = lmCompare($views,'legacy-map-migration.png');
lmDiagnostic('legacy-map-migration',[
 'policy'=>['false'=>'DITHERMETHOD_NO','true'=>'DITHERMETHOD_FLOYDSTEINBERG','historical_pixel_equivalence_claimed'=>false],'states'=>['none'=>lmState($none),'floyd'=>lmState($floyd)],'audits'=>$audits,'reverse_palette'=>['state'=>lmState($reversePalette),'result'=>lmState($reverseResult),'same_for_this_fixture'=>lmHash($none)===lmHash($reverseResult)],'errors'=>$errors,'strict_types'=>true,
 'images'=>$images,'panel_keys'=>['none','floyd'],'panel_geometry'=>$rects,'source_before'=>$sourceBefore,'source_after'=>lmState($source),'source_sha256'=>$sourceHash,'source_unchanged'=>lmState($source)===$sourceBefore&&hash_file('sha256',__DIR__.'/poster.png')===$sourceHash,'palette_before'=>$paletteBefore,'palette_after'=>lmState($palette),
 'checks'=>['results_differ'=>lmHash($none)!==lmHash($floyd),'none_reference_rgb'=>$audits['none']['all_rgb_in_palette'],'floyd_reference_rgb'=>$audits['floyd']['all_rgb_in_palette'],'palette_unchanged'=>lmState($palette)===$paletteBefore,'reference_order_control'=>lmHash($none)===lmHash($reverseResult),'empty_source_caught'=>($errors['empty_source']['error']['class']??null)==='ImagickException','empty_palette_caught'=>($errors['empty_palette']['error']['class']??null)==='ImagickException','array_palette_caught'=>($errors['array_palette']['error']['class']??null)==='TypeError','strict_bool_caught'=>($errors['bool_dither']['error']['class']??null)==='TypeError']
]);
echo "legacy-map-migration.png\nmigration-none8.png\nmigration-floyd8.png\nmetrics.json\nfalse=NO true=FLOYDSTEINBERG different=yes both-in-palette=yes strict-errors=4\n";

Один вызов функции даёт крупные однородные области, другой — узор Floyd–Steinberg. Обе версии используют только четыре разрешённых RGB. Это новая явно выбранная политика, а не обещание повторить все исторические результаты mapImage. Четыре ошибки текущего remapImage перехвачены. В архиве example.php, три файла .png.b64 и legacy-map-fixture.php. Распакуйте всё рядом и выполните php example.php: обычные poster.png, palette.png и sticker.png восстановятся автоматически. Полный helper приведён в конце главы. Проверено в PHP 8.5.11 / Imagick 3.8.1 / ImageMagick 7.1.1-46 Q16, Windows. Реально выполнен современный remapImage; исторический mapImage здесь недоступен и не запускался.

<?php
declare(strict_types=1);
require __DIR__ . '/legacy-map-fixture.php';
lmRestore();
$source = new Imagick(__DIR__ . '/poster.png');
$palette = new Imagick(__DIR__ . '/palette.png');
$sticker = new Imagick(__DIR__ . '/sticker.png');
$sourceBefore = lmState($source);
$paletteBefore = lmState($palette);
$stickerBefore = lmState($sticker);
$sourceHash = hash_file('sha256', __DIR__ . '/poster.png');
$mapped = clone $sticker;
$mapped->remapImage($palette, Imagick::DITHERMETHOD_NO);
$mappedState = lmState($mapped);
$restored = clone $mapped;
$restored->setImageAlphaChannel(Imagick::ALPHACHANNEL_SET);
$restored->compositeImage($sticker, Imagick::COMPOSITE_COPYALPHA, 0, 0);
$saved = lmSave($restored, 'sticker-restored.png', 6);
$read = new Imagick(__DIR__ . '/sticker-restored.png');
$audit = lmAudit($read,$palette);
$views = [lmView($sticker),lmView($mapped),lmView($read)];
$images = ['source'=>lmImage($views[0],'alpha-source8.png'),'mapped'=>lmImage($views[1],'alpha-mapped8.png'),'restored'=>lmImage($views[2],'alpha-restored8.png')];
$rects = lmCompare($views,'legacy-map-alpha.png');
lmDiagnostic('legacy-map-alpha',[
 'sticker_before'=>$stickerBefore,'sticker_after'=>lmState($sticker),'mapped_state'=>$mappedState,'restored_state'=>lmState($restored),'saved'=>$saved,'readback'=>lmState($read),'audit'=>$audit,'display'=>['checkerboard_cell'=>20,'checkerboard_is_output_alpha'=>false],
 'images'=>$images,'panel_keys'=>['source','mapped','restored'],'panel_geometry'=>$rects,'source_before'=>$sourceBefore,'source_after'=>lmState($source),'source_sha256'=>$sourceHash,'source_unchanged'=>lmState($source)===$sourceBefore&&hash_file('sha256',__DIR__.'/poster.png')===$sourceHash,'palette_before'=>$paletteBefore,'palette_after'=>lmState($palette),
 'checks'=>['input_has_transparency'=>$stickerBefore['alpha_range'][0]===0,'mapped_alpha_flag_true'=>$mappedState['alpha_enabled']===true,'mapped_values_opaque'=>$mappedState['alpha_range']===[65535,65535],'source_alpha_restored'=>lmHash($restored,'A')===lmHash($sticker,'A'),'saved_alpha_restored'=>lmHash($read,'A')===lmHash($sticker,'A'),'RGB_unchanged_by_alpha_copy'=>lmHash($restored,'RGB')===lmHash($mapped,'RGB'),'saved_reference_rgb'=>$audit['all_rgb_in_palette'],'sticker_unchanged'=>lmState($sticker)===$stickerBefore,'palette_unchanged'=>lmState($palette)===$paletteBefore]
]);
echo "legacy-map-alpha.png\nalpha-source8.png\nalpha-mapped8.png\nalpha-restored8.png\nsticker-restored.png\nmetrics.json\nalpha-flag=true mapped=opaque restored-alpha=exact saved-alpha=exact RGB-in-palette=yes\n";

На этом входе remapImage с непрозрачной палитрой сделал все значения alpha непрозрачными, хотя флаг канала остался true. COPYALPHA вернул исходные значения; они совпали и после записи sticker-restored.png. RGB остались выбранными цветами палитры. Клетки видны только в иллюстрациях, в PNG их нет. В архиве example.php, три файла .png.b64 и legacy-map-fixture.php. Распакуйте всё рядом и выполните php example.php: обычные poster.png, palette.png и sticker.png восстановятся автоматически. Полный helper приведён в конце главы. Проверено в PHP 8.5.11 / Imagick 3.8.1 / ImageMagick 7.1.1-46 Q16, Windows. Реально выполнен современный remapImage; исторический mapImage здесь недоступен и не запускался.

<?php
declare(strict_types=1);
require __DIR__ . '/legacy-map-fixture.php';
lmRestore();
$source = new Imagick(__DIR__ . '/poster.png');
$palette = new Imagick(__DIR__ . '/palette.png');
$sticker = new Imagick(__DIR__ . '/sticker.png');
$sourceBefore = lmState($source);
$paletteBefore = lmState($palette);
$stickerBefore = lmState($sticker);
$sourceHash = hash_file('sha256', __DIR__ . '/poster.png');
function exportPalettePNG(
    Imagick $source,
    Imagick $palette,
    int $ditherMethod,
    bool $preserveAlpha,
    string $filename
): array {
    $result = clone $source;
    $result->remapImage($palette, $ditherMethod);
    if ($preserveAlpha) {
        $result->setImageAlphaChannel(Imagick::ALPHACHANNEL_SET);
        $result->compositeImage($source, Imagick::COMPOSITE_COPYALPHA, 0, 0);
    }
    $saved = lmSave($result, $filename, $preserveAlpha ? 6 : 2);
    $read = new Imagick(__DIR__ . '/' . $filename);
    $audit = lmAudit($read, $palette);
    if (!$audit['all_rgb_in_palette']) {
        throw new RuntimeException('Saved RGB is outside the approved palette');
    }
    if ($preserveAlpha && lmHash($read, 'A') !== lmHash($source, 'A')) {
        throw new RuntimeException('Saved transparency differs from the source');
    }
    return ['saved'=>$saved,'audit'=>$audit,'preserve_alpha'=>$preserveAlpha,
        'alpha_equal'=>lmHash($read,'A')===lmHash($source,'A')];
}
$exports = [
    'poster'=>exportPalettePNG($source,$palette,Imagick::DITHERMETHOD_FLOYDSTEINBERG,false,'poster-web.png'),
    'sticker'=>exportPalettePNG($sticker,$palette,Imagick::DITHERMETHOD_NO,true,'sticker-web.png'),
];
$manifest = [
    'palette_file'=>'palette.png',
    'palette_sha256'=>hash_file('sha256',__DIR__.'/palette.png'),
    'approved_rgb'=>lmRGBSet($palette),
    'exports'=>$exports,
    'note'=>'RGB membership does not promise indexed palette order or only four displayed colors after alpha compositing',
];
file_put_contents(__DIR__ . '/palette-export.json', json_encode(
    $manifest, JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR
) . "\n");
$readManifest = json_decode((string)file_get_contents(__DIR__.'/palette-export.json'),true,512,JSON_THROW_ON_ERROR);
$posterRead = new Imagick(__DIR__.'/poster-web.png');
$stickerRead = new Imagick(__DIR__.'/sticker-web.png');
$views = [lmView($posterRead),lmView($stickerRead)];
$images = ['poster'=>lmImage($views[0],'workflow-poster8.png'),'sticker'=>lmImage($views[1],'workflow-sticker8.png')];
$rects = lmCompare($views,'legacy-map-workflow.png');
lmDiagnostic('legacy-map-workflow',[
 'exports'=>$exports,'manifest'=>$readManifest,'manifest_sha256'=>hash_file('sha256',__DIR__.'/palette-export.json'),'sticker_before'=>$stickerBefore,'sticker_after'=>lmState($sticker),'readback'=>['poster'=>lmState($posterRead),'sticker'=>lmState($stickerRead)],
 'images'=>$images,'panel_keys'=>['poster','sticker'],'panel_geometry'=>$rects,'source_before'=>$sourceBefore,'source_after'=>lmState($source),'source_sha256'=>$sourceHash,'source_unchanged'=>lmState($source)===$sourceBefore&&hash_file('sha256',__DIR__.'/poster.png')===$sourceHash,'palette_before'=>$paletteBefore,'palette_after'=>lmState($palette),
 'checks'=>['poster_reference_rgb'=>$exports['poster']['audit']['all_rgb_in_palette'],'sticker_reference_rgb'=>$exports['sticker']['audit']['all_rgb_in_palette'],'sticker_alpha_preserved'=>$exports['sticker']['alpha_equal'],'manifest_bound'=>$readManifest['palette_sha256']===hash_file('sha256',__DIR__.'/palette.png'),'manifest_file_hashes'=>$readManifest['exports']['poster']['saved']['sha256']===hash_file('sha256',__DIR__.'/poster-web.png')&&$readManifest['exports']['sticker']['saved']['sha256']===hash_file('sha256',__DIR__.'/sticker-web.png'),'sticker_unchanged'=>lmState($sticker)===$stickerBefore,'palette_unchanged'=>lmState($palette)===$paletteBefore]
]);
echo "legacy-map-workflow.png\nworkflow-poster8.png\nworkflow-sticker8.png\nposter-web.png\nsticker-web.png\npalette-export.json\nmetrics.json\nexports=2 approved-RGB=yes sticker-alpha=preserved manifest=read-back\n";

Готовы poster-web.png, прозрачный sticker-web.png и palette-export.json. Функция прочитала оба записанных файла, проверила принадлежность RGB палитре и сохранность alpha наклейки. JSON связывает палитру и выходные файлы по SHA256; он не является подписью автора. В архиве example.php, три файла .png.b64 и legacy-map-fixture.php. Распакуйте всё рядом и выполните php example.php: обычные poster.png, palette.png и sticker.png восстановятся автоматически. Полный helper приведён в конце главы. Проверено в PHP 8.5.11 / Imagick 3.8.1 / ImageMagick 7.1.1-46 Q16, Windows. Реально выполнен современный remapImage; исторический mapImage здесь недоступен и не запускался.