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

<?php
declare(strict_types=1);
require __DIR__.'/stegano-fixture.php';
sgRestore();
$carrier=new Imagick(__DIR__.'/carrier.png');
$mark=new Imagick(__DIR__.'/mark.png');
$beforeCarrier=sgState($carrier);$beforeMark=sgState($mark);
$encoded=$carrier->steganoImage($mark,17);
$saved=sgSavePNG($encoded,'first-data16.png',16);
$decoded=new Imagick();$decoded->setSizeOffset(40,32,17);
$decoded->readImage('STEGANO:'.__DIR__.'/first-data16.png');
$recovered=sgSavePNG($decoded,'first-recovered.png',8);
$view=sgMarkView($decoded);
$images=['carrier'=>sgImage($carrier,'first-carrier8.png'),'stegano'=>sgImage($encoded,'first-stegano8.png'),'recovered'=>sgImage($view,'first-recovered-view8.png')];
$rects=sgCompare([$carrier,$encoded,$view],'stegano-first.png');$difference=sgDifference($carrier,$encoded);
sgDiagnostic('stegano-first',['executed_api'=>'steganoImage','returned_type'=>get_debug_type($encoded),'distinct_object'=>$encoded!==$carrier&&$encoded!==$mark,
    'before_carrier'=>$beforeCarrier,'before_mark'=>$beforeMark,'after_carrier'=>sgState($carrier),'after_mark'=>sgState($mark),'encoded'=>sgState($encoded),'decoded'=>sgState($decoded),'difference'=>$difference,'saved'=>$saved,'recovered'=>$recovered,'offset'=>17,
    'images'=>$images,'panel_keys'=>['carrier','stegano','recovered'],'panel_geometry'=>$rects,'source_unchanged'=>sgState($carrier)===$beforeCarrier&&sgState($mark)===$beforeMark,
    'checks'=>['new_Imagick'=>$encoded instanceof Imagick&&$encoded!==$carrier&&$encoded!==$mark,'PNG16_RGB_exact'=>$saved['state']['RGB16_sha256']===sgHash($encoded),'mark_recovered_exact'=>sgHash($decoded)===sgHash($mark),'changed_lowbits'=>$difference['changed_channels']===9327&&$difference['max_quantum_delta']===1,'source_RGB_geometry_preserved'=>sgState($carrier)===$beforeCarrier&&sgState($mark)===$beforeMark]]);
echo "stegano-first.png\nfirst-carrier8.png\nfirst-stegano8.png\nfirst-recovered-view8.png\nfirst-data16.png\nfirst-recovered.png\nmetrics.json\nreturn=Imagick recovered-exact=1 changed-channels=9327 max-delta=1 source-RGB-unchanged=1\n";

Сохранён настоящий PNG16-носитель и извлечена исходная метка 40×32 без различий RGB. В носителе изменились 9327 значений каналов максимум на 1 из 65535. На странице показана PNG8-копия для просмотра; извлечение выполняется из другого файла first-data16.png. ZIP самодостаточен: example.php, carrier.png.b64, mark.png.b64 и stegano-fixture.php. Распакуйте всё рядом и выполните php example.php. Входы восстанавливаются с проверкой SHA. Вспомогательный PHP сохраняет настоящий PNG16 отдельно от PNG8-превью, читает RGB16 и создаёт поясняющие панели; sgMarkView увеличивает только копию 40×32 в 10 раз через sampleImage. Все изучаемые вызовы steganoImage и чтение STEGANO видны в основном коде. Полный вспомогательный PHP приведён в конце главы. Среда: PHP 8.5.11 / Imagick 3.8.1 / ImageMagick 7.1.1-46 Q16, Windows.

<?php
declare(strict_types=1);
require __DIR__.'/stegano-fixture.php';
sgRestore();
$carrier=new Imagick(__DIR__.'/carrier.png');
$mark=new Imagick(__DIR__.'/mark.png');
$beforeCarrier=sgState($carrier);$beforeMark=sgState($mark);
$encoded=$carrier->steganoImage($mark,17);
$saved=sgSavePNG($encoded,'minimal-data16.png',16);
$decoded=new Imagick();$decoded->setSizeOffset($mark->getImageWidth(),$mark->getImageHeight(),17);
$decoded->readImage('STEGANO:'.__DIR__.'/minimal-data16.png');
$recovered=sgSavePNG($decoded,'minimal-recovered.png',8);
$markView=sgMarkView($mark);$decodedView=sgMarkView($decoded);
$images=['watermark'=>sgImage($markView,'minimal-watermark-view8.png'),'recovered'=>sgImage($decodedView,'minimal-recovered-view8.png')];
$rects=sgCompare([$markView,$decodedView],'stegano-minimal.png');
$declared=(string)(new ReflectionMethod(Imagick::class,'steganoImage'))->getReturnType();
sgDiagnostic('stegano-minimal',['executed_api'=>'steganoImage','returned_type'=>get_debug_type($encoded),'declared_return'=>$declared,'offset'=>17,'watermark_geometry'=>[40,32],'display_scale'=>10,
    'mark'=>sgState($mark),'decoded'=>sgState($decoded),'encoded'=>sgState($encoded),'saved'=>$saved,'recovered'=>$recovered,'images'=>$images,'panel_keys'=>['watermark','recovered'],'panel_geometry'=>$rects,'source_unchanged'=>sgState($carrier)===$beforeCarrier&&sgState($mark)===$beforeMark,
    'checks'=>['actual_Imagick'=>$encoded instanceof Imagick,'declared_Imagick'=>$declared==='Imagick','right_geometry'=>$decoded->getImageGeometry()===['width'=>40,'height'=>32],'mark_recovered_exact'=>sgHash($decoded)===sgHash($mark),'new_object'=>$encoded!==$carrier&&$encoded!==$mark,'source_RGB_geometry_preserved'=>sgState($carrier)===$beforeCarrier&&sgState($mark)===$beforeMark]]);
echo "stegano-minimal.png\nminimal-watermark-view8.png\nminimal-recovered-view8.png\nminimal-data16.png\nminimal-recovered.png\nmetrics.json\noffset=17 mark=40x32 declared=Imagick actual=Imagick recovered-exact=1\n";

Исходная и извлечённая метки совпадают. Для чтения понадобились именно 40×32 и offset 17. Сигнатура и Reflection говорят Imagick; фактический результат тоже новый Imagick, а не true. ZIP самодостаточен: example.php, carrier.png.b64, mark.png.b64 и stegano-fixture.php. Распакуйте всё рядом и выполните php example.php. Входы восстанавливаются с проверкой SHA. Вспомогательный PHP сохраняет настоящий PNG16 отдельно от PNG8-превью, читает RGB16 и создаёт поясняющие панели; sgMarkView увеличивает только копию 40×32 в 10 раз через sampleImage. Все изучаемые вызовы steganoImage и чтение STEGANO видны в основном коде. Полный вспомогательный PHP приведён в конце главы. Среда: PHP 8.5.11 / Imagick 3.8.1 / ImageMagick 7.1.1-46 Q16, Windows.

<?php
declare(strict_types=1);
require __DIR__.'/stegano-fixture.php';
sgRestore();
$carrier=new Imagick(__DIR__.'/carrier.png');
$mark=new Imagick(__DIR__.'/mark.png');
$beforeCarrier=sgState($carrier);$beforeMark=sgState($mark);
$encoded=$carrier->steganoImage($mark,17);
$data16=sgSavePNG($encoded,'controls-data16.png',16);
$data8=sgSavePNG($encoded,'controls-data8.png',8);
$jpeg=clone $encoded;$jpeg->setImageFormat('jpeg');$jpeg->setImageCompressionQuality(90);$jpeg->writeImage(__DIR__.'/controls-lossy.jpg');
$correct=sgDecode('controls-data16.png',17);
$wrong=sgDecode('controls-data16.png',18);
$from8=sgDecode('controls-data8.png',17);
$fromJpeg=sgDecode('controls-lossy.jpg',17);
$recoveries=['wrong_offset'=>sgState($wrong),'png8'=>sgState($from8),'jpeg'=>sgState($fromJpeg),'correct_png16'=>sgState($correct)];
$raw=['wrong_offset'=>sgSavePNG($wrong,'controls-wrong-recovered.png',8),'png8'=>sgSavePNG($from8,'controls-png8-recovered.png',8),'jpeg'=>sgSavePNG($fromJpeg,'controls-jpeg-recovered.png',8)];
$views=[sgMarkView($wrong),sgMarkView($from8),sgMarkView($fromJpeg)];
$images=['wrong_offset'=>sgImage($views[0],'controls-wrong-offset-view8.png'),'png8'=>sgImage($views[1],'controls-png8-view8.png'),'jpeg'=>sgImage($views[2],'controls-jpeg-view8.png')];
$rects=sgCompare($views,'stegano-controls.png');
sgDiagnostic('stegano-controls',['executed_api'=>'steganoImage','mark'=>sgState($mark),'encoded'=>sgState($encoded),'saved_png16'=>$data16,'saved_png8'=>$data8,'jpeg_quality'=>90,'correct_offset'=>17,'wrong_offset'=>18,'recoveries'=>$recoveries,'raw_recovered'=>$raw,
    'images'=>$images,'panel_keys'=>['wrong_offset','png8','jpeg'],'panel_geometry'=>$rects,'source_unchanged'=>sgState($carrier)===$beforeCarrier&&sgState($mark)===$beforeMark,
    'checks'=>['PNG16_recovery_exact'=>sgHash($correct)===sgHash($mark),'wrong_offset_not_exact'=>sgHash($wrong)!==sgHash($mark),'PNG8_not_exact'=>sgHash($from8)!==sgHash($mark),'JPEG_not_exact'=>sgHash($fromJpeg)!==sgHash($mark),'PNG8_carrier_quantized'=>$data8['state']['RGB16_sha256']!==sgHash($encoded),'source_RGB_geometry_preserved'=>sgState($carrier)===$beforeCarrier&&sgState($mark)===$beforeMark]]);
echo "stegano-controls.png\ncontrols-wrong-offset-view8.png\ncontrols-png8-view8.png\ncontrols-jpeg-view8.png\ncontrols-data16.png\ncontrols-data8.png\ncontrols-lossy.jpg\ncontrols-wrong-recovered.png\ncontrols-png8-recovered.png\ncontrols-jpeg-recovered.png\nmetrics.json\nPNG16=exact offset18=not-exact PNG8=not-exact JPEG90=not-exact\n";

Верное чтение PNG16 совпало с исходной меткой. Offset 18, уменьшение глубины до 8 бит и JPEG качества 90 дали другие данные; реальная картинка каждого извлечения показана рядом. Это три разные причины, а не одна общая ошибка сжатия. ZIP самодостаточен: example.php, carrier.png.b64, mark.png.b64 и stegano-fixture.php. Распакуйте всё рядом и выполните php example.php. Входы восстанавливаются с проверкой SHA. Вспомогательный PHP сохраняет настоящий PNG16 отдельно от PNG8-превью, читает RGB16 и создаёт поясняющие панели; sgMarkView увеличивает только копию 40×32 в 10 раз через sampleImage. Все изучаемые вызовы steganoImage и чтение STEGANO видны в основном коде. Полный вспомогательный PHP приведён в конце главы. Среда: PHP 8.5.11 / Imagick 3.8.1 / ImageMagick 7.1.1-46 Q16, Windows.

<?php
declare(strict_types=1);
require __DIR__.'/stegano-fixture.php';
sgRestore();
$carrier=new Imagick(__DIR__.'/carrier.png');
$mark=new Imagick(__DIR__.'/mark.png');
$beforeCarrier=sgState($carrier);$beforeMark=sgState($mark);
function saveMarkedCopy(Imagick $carrier,Imagick $mark,int $offset):array {
    sgValidate($carrier,$mark,$offset);
    $encoded=$carrier->steganoImage($mark,$offset);
    $saved=sgSavePNG($encoded,'delivery-data16.png',16);
    return ['filename'=>$saved['filename'],'width'=>$mark->getImageWidth(),'height'=>$mark->getImageHeight(),'offset'=>$offset,'quantum_bits'=>16,'carrier_sha256'=>$saved['sha256'],'watermark_RGB16_sha256'=>sgHash($mark)];
}
$descriptor=saveMarkedCopy($carrier,$mark,17);
file_put_contents(__DIR__.'/delivery-descriptor.json',json_encode($descriptor,JSON_PRETTY_PRINT|JSON_THROW_ON_ERROR)."\n");
$loaded=json_decode((string)file_get_contents(__DIR__.'/delivery-descriptor.json'),true,512,JSON_THROW_ON_ERROR);
$decoded=new Imagick();$decoded->setSizeOffset($loaded['width'],$loaded['height'],$loaded['offset']);
$decoded->readImage('STEGANO:'.__DIR__.'/'.$loaded['filename']);
$recovered=sgSavePNG($decoded,'delivery-recovered.png',8);
$stored=new Imagick(__DIR__.'/'.$loaded['filename']);$view=sgMarkView($decoded);
$images=['carrier'=>sgImage($stored,'workflow-carrier8.png'),'recovered'=>sgImage($view,'workflow-recovered-view8.png')];
$rects=sgCompare([$stored,$view],'stegano-workflow.png');
$errors['missing_size']=sgTry(fn()=>(new Imagick())->readImage('STEGANO:'.__DIR__.'/delivery-data16.png'));
$errors['empty_receiver']=sgTry(fn()=>(new Imagick())->steganoImage($mark,17));
$errors['empty_mark']=sgTry(fn()=>$carrier->steganoImage(new Imagick(),17));
$errors['wrong_type']=sgTry(fn()=>$carrier->steganoImage('mark.png',17));
$policy=sgTry(fn()=>sgValidate($carrier,$mark,-1));
$checks=['descriptor_loaded'=>$loaded===$descriptor,'file_sha_matches'=>hash_file('sha256',__DIR__.'/'.$loaded['filename'])===$loaded['carrier_sha256'],'mark_recovered_exact'=>sgHash($decoded)===$loaded['watermark_RGB16_sha256'],'policy_rejects_negative'=>($policy['error']['class']??null)==='InvalidArgumentException','source_RGB_geometry_preserved'=>sgState($carrier)===$beforeCarrier&&sgState($mark)===$beforeMark];
foreach($errors as$name=>$entry){$checks['caught_'.$name]=isset($entry['error']);}
sgDiagnostic('stegano-workflow',['executed_api'=>'steganoImage','descriptor'=>$descriptor,'stored'=>sgState($stored),'decoded'=>sgState($decoded),'mark'=>sgState($mark),'recovered'=>$recovered,'errors'=>$errors,'policy_error'=>$policy,'images'=>$images,'panel_keys'=>['carrier','recovered'],'panel_geometry'=>$rects,'source_unchanged'=>sgState($carrier)===$beforeCarrier&&sgState($mark)===$beforeMark,'checks'=>$checks]);
echo "stegano-workflow.png\nworkflow-carrier8.png\nworkflow-recovered-view8.png\ndelivery-data16.png\ndelivery-recovered.png\ndelivery-descriptor.json\nmetrics.json\ndescriptor-loaded=1 recovered-exact=1 errors=4 policy-rejection=1 source-RGB-unchanged=1\n";

Функция создаёт PNG16 и отдельное описание параметров. Описание действительно открывается заново, декодер восстанавливает метку, SHA подтверждает точность файла в опыте. Четыре технические ошибки и отдельный отказ нашей политики сохранены. Открытый JSON с SHA не является цифровой подписью. ZIP самодостаточен: example.php, carrier.png.b64, mark.png.b64 и stegano-fixture.php. Распакуйте всё рядом и выполните php example.php. Входы восстанавливаются с проверкой SHA. Вспомогательный PHP сохраняет настоящий PNG16 отдельно от PNG8-превью, читает RGB16 и создаёт поясняющие панели; sgMarkView увеличивает только копию 40×32 в 10 раз через sampleImage. Все изучаемые вызовы steganoImage и чтение STEGANO видны в основном коде. Полный вспомогательный PHP приведён в конце главы. Среда: PHP 8.5.11 / Imagick 3.8.1 / ImageMagick 7.1.1-46 Q16, Windows.