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

<?php
declare(strict_types=1);
require __DIR__ . '/gm-fixture.php';
gmRestore();
$bytes = file_get_contents(__DIR__.'/product.ppm');
if ($bytes===false) { throw new RuntimeException('Cannot read own input'); }
$image = new Gmagick();
$result = $image->readImageBlob($bytes,'product.ppm');
$errors = ['not_image'=>gmTry(fn()=>(new Gmagick())->readImageBlob('not image bytes'))];
$image->setImageFormat('PNG');
$image->setImageDepth(8);
$image->writeImage(__DIR__.'/from-blob.png');

gmReport('gmagick-read-blob',["__construct", "readimageblob", "getimagewidth", "getimageheight", "setimageformat", "writeimage", "setimagedepth"],["from-blob.png"],
    ['same_object'=>$result===$image,'size'=>$image->getImageWidth()===320&&$image->getImageHeight()===200,'bad_blob_caught'=>$errors['not_image']['class']==='GmagickException'],
    $errors ?? [], []);
echo "from-blob.png 320x200 invalid-blob=GmagickException\n";

from-blob.png 320x200 invalid-blob=GmagickException

Распакуйте example.php, gm-fixture.php и два файла .ppm.b64 рядом; php example.php восстановит собственные входы. Проверено: PHP 8.3.6 / Gmagick 2.0.6RC1 / GraphicsMagick 1.3.42 Q16. PNG показывают настоящий результат; metrics.json содержит версии, размеры, хеши, проверки и ошибки.

<?php
declare(strict_types=1);
require __DIR__ . '/gm-fixture.php';
gmRestore();
$stream = fopen(__DIR__.'/portrait.ppm','rb');
if ($stream===false) { throw new RuntimeException('Cannot open own input'); }
try {
    $image = new Gmagick();
    $result = $image->readImageFile($stream,'portrait.ppm');
    $stillOpen = is_resource($stream);
} finally {
    fclose($stream);
}
$errors = ['wrong_type'=>gmTry(fn()=>(new Gmagick())->readImageFile('portrait.ppm'))];
$image->setImageFormat('PNG');
$image->setImageDepth(8);
$image->writeImage(__DIR__.'/from-stream.png');

gmReport('gmagick-read-stream',["__construct", "readimagefile", "setimageformat", "writeimage", "setimagedepth"],["from-stream.png"],
    ['same_object'=>$result===$image,'stream_remained_open'=>$stillOpen===true,'owner_closed'=>!is_resource($stream),'wrong_type_caught'=>$errors['wrong_type']['class']==='TypeError'],
    $errors ?? [], []);
echo "from-stream.png 200x320 stream-closed=yes string=TypeError\n";

from-stream.png 200x320 stream-closed=yes string=TypeError

Распакуйте example.php, gm-fixture.php и два файла .ppm.b64 рядом; php example.php восстановит собственные входы. Проверено: PHP 8.3.6 / Gmagick 2.0.6RC1 / GraphicsMagick 1.3.42 Q16. PNG показывают настоящий результат; metrics.json содержит версии, размеры, хеши, проверки и ошибки.

<?php
declare(strict_types=1);
require __DIR__ . '/gm-fixture.php';
gmRestore();
$image = new Gmagick(__DIR__.'/product.ppm');
$image->setImageFormat('PNG');
$image->setImageDepth(8);
$image->writeImage(__DIR__.'/export-png.png');
$image->setImageFormat('JPEG');
$image->writeImage(__DIR__.'/export-photo.jpg');
$writerFormat = $image->getImageFormat();
$readback = new Gmagick(__DIR__.'/export-photo.jpg');
$readFormat = $readback->getImageFormat();
$readback->setImageFormat('PNG');
$readback->setImageDepth(8);
$readback->writeImage(__DIR__.'/jpeg-view.png');
$files = ['png'=>gmInspect('export-png.png'),'jpeg'=>gmInspect('export-photo.jpg')];

gmReport('gmagick-export-formats',["__construct", "setimageformat", "writeimage", "getimageformat", "setimagedepth"],["export-png.png", "jpeg-view.png"],
    ['jpeg_readback'=>strtoupper($readFormat)==='JPEG','same_geometry'=>$files['png']['width']===$files['jpeg']['width']&&$files['png']['height']===$files['jpeg']['height'],'real_bytes'=>$files['png']['bytes']>0&&$files['jpeg']['bytes']>0],
    $errors ?? [], ['writer_format'=>$writerFormat,'readback_format'=>$readFormat,'files'=>$files]);
echo "export-png.png export-photo.jpg jpeg-view.png geometry=320x200 readback=JPEG\n";

export-png.png export-photo.jpg jpeg-view.png geometry=320x200 readback=JPEG

Распакуйте example.php, gm-fixture.php и два файла .ppm.b64 рядом; php example.php восстановит собственные входы. Проверено: PHP 8.3.6 / Gmagick 2.0.6RC1 / GraphicsMagick 1.3.42 Q16. PNG показывают настоящий результат; metrics.json содержит версии, размеры, хеши, проверки и ошибки.

<?php
declare(strict_types=1);
require __DIR__ . '/gm-fixture.php';
gmRestore();
$image = new Gmagick();
$image->newImage(160,100,'#e5a74a','png');
$image->setImageDepth(8);
$direct = $image->writeImage(__DIR__.'/write-direct.png',false);
$alias = $image->write(__DIR__.'/write-alias.png',false);
$errors = [
    'null_filename'=>gmTry(fn()=>$image->writeImage(null)),
    'bad_directory'=>gmTry(fn()=>$image->writeImage(__DIR__.'/missing-dir/output.png')),
];

gmReport('gmagick-write-alias',["__construct", "newimage", "writeimage", "write", "setimagedepth"],["write-direct.png", "write-alias.png"],
    ['direct_same_object'=>$direct===$image,'alias_same_object'=>$alias===$image,'null_rejected'=>$errors['null_filename']['class']==='TypeError','bad_directory_caught'=>$errors['bad_directory']['class']==='GmagickException'],
    $errors ?? [], []);
echo "write-direct.png write-alias.png 160x100 rejected=null,directory\n";

write-direct.png write-alias.png 160x100 rejected=null,directory

Распакуйте example.php, gm-fixture.php и два файла .ppm.b64 рядом; php example.php восстановит собственные входы. Проверено: PHP 8.3.6 / Gmagick 2.0.6RC1 / GraphicsMagick 1.3.42 Q16. PNG показывают настоящий результат; metrics.json содержит версии, размеры, хеши, проверки и ошибки.

<?php
declare(strict_types=1);
require __DIR__ . '/gm-fixture.php';
gmRestore();
$landscape = new Gmagick();
$landscape->readImageBlob((string)file_get_contents(__DIR__.'/product.ppm'),'product.ppm');
$stream = fopen(__DIR__.'/portrait.ppm','rb');
if ($stream===false) { throw new RuntimeException('Cannot open own input'); }
try {
    $portrait = new Gmagick();
    $portrait->readImageFile($stream,'portrait.ppm');
} finally {
    fclose($stream);
}
$manifest = [];
foreach (['landscape'=>$landscape,'portrait'=>$portrait] as $key=>$source) {
    $fit = clone $source;
    $fit->thumbnailImage(160,160,true);
    $fit->setImageFormat('PNG');
$fit->setImageDepth(8);
    $fitName = $key.'-fit.png';
    $fit->writeImage(__DIR__.'/'.$fitName);
    $square = clone $source;
    $square->cropThumbnailImage(120,120);
    $square->setImageFormat('PNG');
$square->setImageDepth(8);
    $squareName = $key.'-square.png';
    $square->write(__DIR__.'/'.$squareName);
    $manifest[$key] = ['fit'=>gmInspect($fitName),'square'=>gmInspect($squareName)];
}
file_put_contents(__DIR__.'/catalog.json',json_encode($manifest,JSON_PRETTY_PRINT|JSON_THROW_ON_ERROR)."\n");

gmReport('gmagick-catalog-export',["__construct", "readimageblob", "readimagefile", "thumbnailimage", "cropthumbnailimage", "setimageformat", "writeimage", "write", "getimagewidth", "getimageheight", "setimagedepth"],["landscape-fit.png", "portrait-fit.png", "landscape-square.png", "portrait-square.png"],
    ['two_inputs'=>count($manifest)===2,'fit_geometry'=>$manifest['landscape']['fit']['width']===160&&$manifest['portrait']['fit']['height']===160,'squares'=>$manifest['landscape']['square']['width']===120&&$manifest['portrait']['square']['height']===120,'original_geometry'=>$landscape->getImageWidth()===320&&$portrait->getImageHeight()===320],
    $errors ?? [], $manifest);
echo "catalog.json outputs=4 fit=160x100,100x160 square=120x120\n";

catalog.json outputs=4 fit=160x100,100x160 square=120x120

Распакуйте example.php, gm-fixture.php и два файла .ppm.b64 рядом; php example.php восстановит собственные входы. Проверено: PHP 8.3.6 / Gmagick 2.0.6RC1 / GraphicsMagick 1.3.42 Q16. PNG показывают настоящий результат; metrics.json содержит версии, размеры, хеши, проверки и ошибки.