README

此库是对 https://github.com/gumlet/php-image-resize 的增强型分支，为AJUR Media创建。

ajur-media/php-image-resize

用于调整、缩放和裁剪图片的PHP库。

此库是对 https://github.com/gumlet/php-image-resize 的增强型分支，为AJUR Media创建。

设置

此软件包通过Packagist提供，供应商和包标识符与该存储库相同。

使用 Composer: composer require ajur-media/php-image-resize

由于此类使用命名空间，在实例化对象时，您必须使用完全限定命名空间

$image = new \Gumlet\ImageResize();

或为其别名

use \Gumlet\ImageResize;

$image = new ImageResize();

注意：此库使用GD类，不支持调整动画GIF文件的大小

调整大小

要缩放图片，例如将其大小减半（缩放基于百分比）

$image = new ImageResize('image.jpg');
$image->scale(50);
$image->save('image2.jpg');

根据一个维度调整图片大小（保持宽高比）

$image = new ImageResize('image.jpg');
$image->resizeToHeight(500);
$image->save('image2.jpg');

$image = new ImageResize('image.jpg');
$image->resizeToWidth(300);
$image->save('image2.jpg');

根据给定的测量值调整图片大小（无论其方向如何，都保持宽高比）

$image = new ImageResize('image.jpg');
$image->resizeToLongSide(500);
$image->save('image2.jpg');

$image = new ImageResize('image.jpg');
$image->resizeToShortSide(300);
$image->save('image2.jpg');

将图片调整到最适合给定尺寸（保持宽高比）

$image = new ImageResize('image.jpg');
$image->resizeToBestFit(500, 300);
$image->save('image2.jpg');

所有调整大小函数都有 $allow_enlarge 选项，默认设置为false。您可以通过传递 true 到任何调整大小函数来启用它

$image = new ImageResize('image.jpg');
$image->resize(500, 300, $allow_enlarge = True);
$image->save('image2.jpg');

如果您愿意自己处理宽高比，可以直接调整大小

$image = new ImageResize('image.jpg');
$image->resize(800, 600);
$image->save('image2.jpg');

如果您不使用与源图像相同的宽度/高度比，这将导致您的图像变形。

裁剪

要裁剪图片

$image = new ImageResize('image.jpg');
$image->crop(200, 200);
$image->save('image2.jpg');

这将使图片尽可能接近传递的尺寸，然后裁剪并居中剩余部分。

在上面的示例中，一个400px × 600px的图片将被调整大小为200px × 300px，然后从顶部和底部裁剪掉50px，留下200px × 200px。

裁剪模式

由于您需要在调整大小图片后处理最终超过的宽度和高度，所以提供了少数裁剪模式选项。默认使用的裁剪模式是 CROPCENTER。因此，以下代码是等效的

$image = new ImageResize('image.jpg');
$image->crop(200, 200);
$image->save('image2.jpg');

$image = new ImageResize('image.jpg');
$image->crop(200, 200, true, ImageResize::CROPCENTER);
$image->save('image2.jpg');

在您有一个400px × 600px的图片并且您想将其裁剪为200px × 200px的情况下，图片将被调整大小为200px × 300px，然后您可以指定如何处理这100px的超出，通过传递您想使用的裁剪模式值。

例如，传递裁剪模式 CROPTOP 将导致底部裁剪掉100px，留下200px × 200px。

$image = new ImageResize('image.jpg');
$image->crop(200, 200, true, ImageResize::CROPTOP);
$image->save('image2.jpg');

相反，传递裁剪模式 CROPBOTTOM 将导致顶部裁剪掉100px，留下200px × 200px。

$image = new ImageResize('image.jpg');
$image->crop(200, 200, true, ImageResize::CROPBOTTOM);
$image->save('image2.jpg');

自由裁剪

还可以定义自定义裁剪位置。您可以在 freecrop 方法中定义 $x 和 $y

$image = new ImageResize('image.jpg');
$image->freecrop(200, 200, $x =  20, $y = 20);
$image->save('image2.jpg');

从字符串加载和保存图片

要从字符串加载图片

$image = ImageResize::createFromString(base64_decode('R0lGODlhAQABAIAAAAQCBP///yH5BAEAAAEALAAAAAABAAEAAAICRAEAOw=='));
$image->scale(50);
$image->save('image.jpg');

您还可以将结果作为字符串返回

$image = ImageResize::createFromString(base64_decode('R0lGODlhAQABAIAAAAQCBP///yH5BAEAAAEALAAAAAABAAEAAAICRAEAOw=='));
$image->scale(50);
echo $image->getImageAsString();

支持魔法 __toString()

$image = ImageResize::createFromString(base64_decode('R0lGODlhAQABAIAAAAQCBP///yH5BAEAAAEALAAAAAABAAEAAAICRAEAOw=='));
$image->resize(10, 10);
echo (string)$image;

显示

如上所示，您可以调用 $image->save('image.jpg');

要直接将图片渲染到浏览器，您可以调用 $image->output();

图片类型

在保存到磁盘或输出到浏览器时，脚本假定输出类型与输入类型相同。

如果您想以不同的图像类型保存/输出，您需要传递一个（支持的）PHP IMAGETYPE_* 常量

• IMAGETYPE_GIF
• IMAGETYPE_JPEG
• IMAGETYPE_PNG

这允许您以不同的类型保存到源文件

$image = new ImageResize('image.jpg');
$image->resize(800, 600);
$image->save('image.png', IMAGETYPE_PNG);

质量

属性 $quality_jpg 和 $quality_png 可供您配置

$image = new ImageResize('image.jpg');
$image->quality_jpg = 100;
$image->resize(800, 600);
$image->save('image2.jpg');

默认情况下，它们分别设置为 85 和 6。有关更多信息，请参阅 imagejpeg() 和 imagepng() 的手册条目。

您也可以直接将质量传递给 save()、output() 和 getImageAsString() 方法

$image = new ImageResize('image.jpg');
$image->crop(200, 200);
$image->save('image2.jpg', null, 100);

$image = new ImageResize('image.jpg');
$image->resizeToWidth(300);
$image->output(IMAGETYPE_PNG, 4);

$image = new ImageResize('image.jpg');
$image->scale(50);
$result = $image->getImageAsString(IMAGETYPE_PNG, 4);

在上面的示例中，我们传递了 null 作为图像类型以跳过它并提供质量。在这种情况下，假设图像类型与输入相同。

交错式

默认情况下，图像交错 已启用。可以通过将 $interlace 设置为 0 来禁用它

$image = new ImageResize('image.jpg');
$image->scale(50);
$image->interlace = 0;
$image->save('image2.jpg');

链式调用

在执行操作时，原始图像会被保留，这样您可以在不造成过度破坏的情况下链式调用操作。

这用于创建多个尺寸非常有用

$image = new ImageResize('image.jpg');
$image
    ->scale(50)
    ->save('image2.jpg')

    ->resizeToWidth(300)
    ->save('image3.jpg')

    ->crop(100, 100)
    ->save('image4.jpg')
;

异常

ImageResize 在其自己的错误中抛出 ImageResizeException。您可以捕获它或捕获它扩展的通用 \Exception。

这不是预期的，但如果在中间发生严重错误，则可能会显示来自 PHP GD 和 Image 函数（https://php.ac.cn/manual/en/ref.image.php）的警告或错误。

try{
    $image = new ImageResize(null);
    echo "This line will not be printed";
} catch (ImageResizeException $e) {
    echo "Something went wrong" . $e->getMessage();
}

过滤器

您可以为新的图像应用特殊效果，如模糊或添加横幅。

$image = new ImageResize('image.jpg');

// Add blure
$image->addFilter(function ($imageDesc) {
    imagefilter($imageDesc, IMG_FILTER_GAUSSIAN_BLUR);
});

// Add banner on bottom left corner
$image18Plus = 'banner.png';
$image->addFilter(function ($imageDesc) use ($image18Plus) {
    $logo = imagecreatefrompng($image18Plus);
    $logo_width = imagesx($logo);
    $logo_height = imagesy($logo);
    $image_width = imagesx($imageDesc);
    $image_height = imagesy($imageDesc);
    $image_x = $image_width - $logo_width - 10;
    $image_y = $image_height - $logo_height - 10;
    imagecopy($imageDesc, $logo, $image_x, $image_y, 0, 0, $logo_width, $logo_height);
});

翻转

使用给定模式翻转图像，此方法仅适用于 PHP 版本 5.4。

$flip = new ImageResize('image.png');
$image = imagecreatetruecolor(200, 100);

$flip->imageFlip($image, 0);

两个函数将按照它们被添加的顺序使用。

伽玛颜色校正

您可以启用默认禁用的伽玛颜色校正。

$image = new ImageResize('image.png');
$image->gamma(true);

API 文档

https://gumlet.github.io/php-image-resize/index.html

维护者

此库由 Gumlet.com 维护

此分支由 Karel Wintersky 维护 karel.wintersky@gmail.com