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

<?php
declare(strict_types=1);
require __DIR__.'/white-point-fixture.php';
wpRestore();
$image=new Imagick(__DIR__.'/source.png');
$sourceState=wpState($image);
$point=$image->getImageWhitePoint();
$chart=wpChart(['D65'=>$point]);
$images=['source'=>wpImage($image,'source-preview8.png'),'chart'=>wpImage($chart,'first-chart8.png')];
$rects=wpCompare([$image,$chart],'white-point-first.png');
wpDiagnostic('white-point-first',['executed_api'=>'getImageWhitePoint','point'=>$point,'before'=>$sourceState,'images'=>$images,
    'chart_basis'=>['origin'=>[50,280],'scale'=>[375,300],'units'=>'dimensionless CIE xy'],
    'panel_keys'=>['source','chart'],'panel_geometry'=>$rects,'source_unchanged'=>wpState($image)===$sourceState,
    'checks'=>['known_D65_xy'=>wpClose($point['x'],.3127)&&wpClose($point['y'],.3290),
        'IM7_three_coordinates'=>array_keys($point)===['x','y','z'],'source_preserved'=>wpState($image)===$sourceState]]);
echo "white-point-first.png\nsource-preview8.png\nfirst-chart8.png\nmetrics.json\nD65 x=0.3127 y=0.3290 z=0.3583 RGB-unchanged=1\n";

Прочитано описание белой точки собственного PNG: x=.3127,y=.3290,z=.3583 в проверенной IM7-сборке. PHP построил график именно полученной пары xy. Рисунок товара и его белый фон не перекрашивались. ZIP самодостаточен: example.php, собственный PNG/CC0 ICC/Open Sans в base64, две лицензии и white-point-fixture.php. Распакуйте рядом и выполните php example.php. wpRestore проверяет SHA и восстанавливает входы. wpState отдельно читает white point, все RGB16, ICC и белый пиксель; wpChart рисует переданные из основного кода реальные координаты. wpImage/wpCompare сохраняют отдельные stripped RGB8-копии без масштабирования, а wpSaveRead — настоящий tagged PNG/MIFF и его readback. Все изучаемые вызовы видны в example.php; полный helper раскрыт в последнем разделе. Среда: PHP 8.5.11 / Imagick 3.8.1 / ImageMagick 7.1.1-46 Q16, Windows.

<?php
declare(strict_types=1);
require __DIR__.'/white-point-fixture.php';
wpRestore();
$image=new Imagick(__DIR__.'/source.png');
$sourceState=wpState($image);
$declared=clone $image;
$returned=$declared->setImageWhitePoint(0.3127,0.3290,0.3583);
$point=$declared->getImageWhitePoint();
$after=wpState($declared);
$images=['before'=>wpImage($image,'minimal-before8.png'),'after'=>wpImage($declared,'minimal-after8.png')];
$rects=wpCompare([$image,$declared],'white-point-minimal.png');
wpDiagnostic('white-point-minimal',['executed_apis'=>['setImageWhitePoint','getImageWhitePoint'],'returned'=>$returned,'point'=>$point,
    'before'=>$sourceState,'after'=>$after,'images'=>$images,'panel_keys'=>['before','after'],'panel_geometry'=>$rects,
    'source_unchanged'=>wpState($image)===$sourceState,
    'checks'=>['setter_true'=>$returned===true,'known_D65'=>wpClose($point['x'],.3127)&&wpClose($point['y'],.329)&&wpClose($point['z'],.3583),
        'RGB_not_converted'=>$after['RGB16_sha256']===$sourceState['RGB16_sha256'],'white_pixel_unchanged'=>$after['white_pixel']===$sourceState['white_pixel'],
        'ICC_not_created'=>$after['icc_sha256']===null,'source_preserved'=>wpState($image)===$sourceState]]);
echo "white-point-minimal.png\nminimal-before8.png\nminimal-after8.png\nmetrics.json\nsetter=true D65-readback=1 RGB-unchanged=1 white-pixel-unchanged=1\n";

Setter вернул true, getter прочитал D65. RGB16 и белый пиксель (0,0) сохранились; ICC не появился. Здесь декларируется известная характеристика собственного входа, а не исправляется оттенок фотографии. ZIP самодостаточен: example.php, собственный PNG/CC0 ICC/Open Sans в base64, две лицензии и white-point-fixture.php. Распакуйте рядом и выполните php example.php. wpRestore проверяет SHA и восстанавливает входы. wpState отдельно читает white point, все RGB16, ICC и белый пиксель; wpChart рисует переданные из основного кода реальные координаты. wpImage/wpCompare сохраняют отдельные stripped RGB8-копии без масштабирования, а wpSaveRead — настоящий tagged PNG/MIFF и его readback. Все изучаемые вызовы видны в example.php; полный helper раскрыт в последнем разделе. Среда: PHP 8.5.11 / Imagick 3.8.1 / ImageMagick 7.1.1-46 Q16, Windows.

<?php
declare(strict_types=1);
require __DIR__.'/white-point-fixture.php';
wpRestore();
$image=new Imagick(__DIR__.'/source.png');
$sourceState=wpState($image);
$declared=clone $image;
$returned=$declared->setImageWhitePoint(0.3127,0.3290,0.123);
$point=$declared->getImageWhitePoint();$inMemory=wpState($declared);
$saved['PNG']=wpSaveRead($declared,'white-point-data.png','png',true);
$saved['MIFF']=wpSaveRead($declared,'white-point-data.miff','miff');
$png=new Imagick(__DIR__.'/white-point-data.png');$miff=new Imagick(__DIR__.'/white-point-data.miff');
$images=['PNG'=>wpImage($png,'serialization-png8.png'),'MIFF'=>wpImage($miff,'serialization-miff8.png')];
$rects=wpCompare([$png,$miff],'white-point-serialization.png');
wpDiagnostic('white-point-serialization',['executed_apis'=>['setImageWhitePoint','getImageWhitePoint'],'returned'=>$returned,
    'point'=>$point,'in_memory'=>$inMemory,'saved'=>$saved,'images'=>$images,'panel_keys'=>['PNG','MIFF'],'panel_geometry'=>$rects,
    'source_unchanged'=>wpState($image)===$sourceState,
    'checks'=>['setter_accepts_non_normalized_z'=>$returned===true&&wpClose($point['z'],.123),
        'PNG_xy_preserved'=>wpClose($saved['PNG']['state']['white_point']['x'],.3127)&&wpClose($saved['PNG']['state']['white_point']['y'],.329),
        'MIFF_xy_preserved'=>wpClose($saved['MIFF']['state']['white_point']['x'],.3127)&&wpClose($saved['MIFF']['state']['white_point']['y'],.329),
        'observed_PNG_z_not_preserved'=>wpClose($saved['PNG']['state']['white_point']['z'],.3583),
        'observed_MIFF_z_not_preserved'=>wpClose($saved['MIFF']['state']['white_point']['z'],.3583),
        'RGB_preserved'=>$saved['PNG']['state']['RGB16_sha256']===$sourceState['RGB16_sha256']&&$saved['MIFF']['state']['RGB16_sha256']===$sourceState['RGB16_sha256'],
        'source_preserved'=>wpState($image)===$sourceState]]);
echo "white-point-serialization.png\nserialization-png8.png\nserialization-miff8.png\nwhite-point-data.png\nwhite-point-data.miff\nmetrics.json\nsaved-formats=2 actual-white-points-in-metrics=1 RGB-unchanged=1\n";

В RAM принято ненормированное z=.123. Реально открытые PNG и MIFF дали x=.3127,y=.3290,z=.3583, сохранив все RGB16. Значения каждого этапа записаны в metrics.json. Это наблюдение конкретных кодеров, а не допустимое описание рабочего sRGB-файла или обещание переносимости произвольного z. ZIP самодостаточен: example.php, собственный PNG/CC0 ICC/Open Sans в base64, две лицензии и white-point-fixture.php. Распакуйте рядом и выполните php example.php. wpRestore проверяет SHA и восстанавливает входы. wpState отдельно читает white point, все RGB16, ICC и белый пиксель; wpChart рисует переданные из основного кода реальные координаты. wpImage/wpCompare сохраняют отдельные stripped RGB8-копии без масштабирования, а wpSaveRead — настоящий tagged PNG/MIFF и его readback. Все изучаемые вызовы видны в example.php; полный helper раскрыт в последнем разделе. Среда: PHP 8.5.11 / Imagick 3.8.1 / ImageMagick 7.1.1-46 Q16, Windows.

<?php
declare(strict_types=1);
require __DIR__.'/white-point-fixture.php';
wpRestore();
$image=new Imagick(__DIR__.'/source.png');
$sourceState=wpState($image);
$profiled=clone $image;
$profiled->profileImage('icc',(string)file_get_contents(__DIR__.'/target-srgb.icc'));
$before=wpState($profiled);$beforeView=clone $profiled;
$returned=$profiled->setImageWhitePoint(0.4,0.3,0.3);
$point=$profiled->getImageWhitePoint();$after=wpState($profiled);
$saved=wpSaveRead($profiled,'profiled-data.png','png');
$chart=wpChart(['before'=>$before['white_point'],'after'=>$point]);
$images=['before'=>wpImage($beforeView,'workflow-before8.png'),'after'=>wpImage($profiled,'workflow-after8.png'),'chart'=>wpImage($chart,'workflow-chart8.png')];
$rects=wpCompare([$beforeView,$profiled,$chart],'white-point-workflow.png');
$unchecked=clone $image;$uncheckedReturn=$unchecked->setImageWhitePoint(-.2,1.4,9.0);$uncheckedState=wpState($unchecked);
$policyError=wpTry(fn()=>wpValidate(['x'=>-.2,'y'=>1.4,'z'=>9.0]));
$errors['missing_z']=wpTry(fn()=>(clone $image)->setImageWhitePoint(.3127,.329));
$errors['bad_type']=wpTry(fn()=>(clone $image)->setImageWhitePoint('not-a-coordinate',.329,.3583));
$errors['empty_get']=wpTry(fn()=>(new Imagick())->getImageWhitePoint());
$errors['empty_set']=wpTry(fn()=>(new Imagick())->setImageWhitePoint(.3127,.329,.3583));
$checks=['setter_true'=>$returned===true,'RAM_point'=>wpClose($point['x'],.4)&&wpClose($point['y'],.3)&&wpClose($point['z'],.3),
    'RGB_not_converted'=>$before['RGB16_sha256']===$after['RGB16_sha256'],'white_pixel_unchanged'=>$before['white_pixel']===$after['white_pixel'],
    'ICC_unchanged'=>$before['icc_sha256']===$after['icc_sha256']&&$after['icc_sha256']!==null,
    'PNG_RGB_ICC_preserved'=>$saved['state']['RGB16_sha256']===$after['RGB16_sha256']&&$saved['state']['icc_sha256']===$after['icc_sha256'],
    'observed_PNG_white_point'=>wpClose($saved['state']['white_point']['x'],.4)&&wpClose($saved['state']['white_point']['y'],.3)&&wpClose($saved['state']['white_point']['z'],.3583),
    'API_accepts_invalid'=>$uncheckedReturn===true&&wpClose($uncheckedState['white_point']['x'],-.2),
    'policy_rejects_invalid'=>($policyError['error']['class']??null)==='InvalidArgumentException','source_preserved'=>wpState($image)===$sourceState];
foreach($errors as $name=>$record){$checks['caught_'.$name]=isset($record['error']);}
wpDiagnostic('white-point-workflow',['executed_apis'=>['setImageWhitePoint','getImageWhitePoint'],'returned'=>$returned,'point'=>$point,
    'before'=>$before,'after'=>$after,'saved'=>$saved,'images'=>$images,'unchecked'=>['returned'=>$uncheckedReturn,'state'=>$uncheckedState],
    'policy_error'=>$policyError,'errors'=>$errors,'panel_keys'=>['before','after','chart'],'panel_geometry'=>$rects,
    'source_unchanged'=>wpState($image)===$sourceState,'checks'=>$checks]);
echo "white-point-workflow.png\nworkflow-before8.png\nworkflow-after8.png\nworkflow-chart8.png\nprofiled-data.png\nmetrics.json\nRGB-unchanged=1 ICC-unchanged=1 white-pixel-unchanged=1 errors=4 policy-rejection=1\n";

На экспериментальной профилированной копии white point стал (.4,.3,.3) в RAM; настоящий PNG прочитан как (.4,.3,.3583). RGB, белый пиксель и байты ICC остались прежними. Две точки на графике показывают изменённое описание. Native принял неверные координаты; наша прикладная политика отвергла их. Четыре ошибки сохранены по классу/сообщению. ZIP самодостаточен: example.php, собственный PNG/CC0 ICC/Open Sans в base64, две лицензии и white-point-fixture.php. Распакуйте рядом и выполните php example.php. wpRestore проверяет SHA и восстанавливает входы. wpState отдельно читает white point, все RGB16, ICC и белый пиксель; wpChart рисует переданные из основного кода реальные координаты. wpImage/wpCompare сохраняют отдельные stripped RGB8-копии без масштабирования, а wpSaveRead — настоящий tagged PNG/MIFF и его readback. Все изучаемые вызовы видны в example.php; полный helper раскрыт в последнем разделе. Среда: PHP 8.5.11 / Imagick 3.8.1 / ImageMagick 7.1.1-46 Q16, Windows.