README

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

托管解决方案

如果您不想在服务器上裁剪、调整大小和存储图片，Salamzadeh.net 是一个 免费 的服务，可以实时处理图片并通过 CDN 为全球提供服务。

设置

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

如果您使用 Composer，在您的 composer.json 文件中添加

{
    "require": {
        "salamzadeh/php-image-resize": "1.8.*"
    }
}

如果您仍在使用 PHP 5.3，请安装此库的 1.7.0 版本或更低版本。

否则

include '/path/to/ImageResize.php';

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

$image = new \Salamzadeh\ImageResize();

或者别名它

use \Salamzadeh\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, 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, ImageResize::CROPTOP);
$image->save('image2.jpg');

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

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

Freecrop

还有定义自定义裁剪位置的方法。您可以在 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);

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

API 文档

尽快吧 ;-)

维护者

此库由 Salamzadeh.net 维护