daaner/convertimage

适用于 Laravel 7+ 的 ConvertImage

0.11 2022-05-30 07:13 UTC

This package is auto-updated.

Last update: 2024-08-29 05:56:20 UTC


README

Scrutinizer Code Quality Laravel Support PHP Support

Latest Stable Version Total Downloads License

一个方便的 Laravel 7+ 图像转换包,用于将图像转换为指定文件夹

安装

composer require daaner/convertimage

在头文件中添加 use Daaner\ConvertImage\ConvertImage;

执行命令发布配置

php artisan vendor:publish --provider="Daaner\ConvertImage\ConvertImageServiceProvider"

说明

传递图像 - 返回转换图像的路径。为了方便,提供了一些 API 方法

$serv = new ConvertImage;
$output = $serv->convert('/images/foobar.jpg?12345');
dd($output);

setFolder (string | callback)

设置保存文件夹的路径,相对于配置中的值。如果没有文件夹,则会创建它

$serv = new ConvertImage;
$serv->setFolder('222');
$serv->convert('/images/foobar.jpg?12345');

// config - 'dir' => '/images',
// output /image/222/foobar.jpg

deleteAfter (bool)

在某些情况下允许忽略配置。对于外部来源的图像(以 http 开始) - 原始图像不会被删除。

$serv = new ConvertImage;
$serv->deleteAfter(true);
$serv->convert('/images/foobar.jpg?12345');

// config - 'delete_after_convert' => false,
// output оригинал будет удален

setName (string | callback)

设置未来文件的名称

$serv = new ConvertImage;
$serv->setName('foo baz bar 1');
$serv->convert('/images/foobar.jpg?12345');

// foo-baz-bar-1.jpg

resize (int $width, int $height)

更改与默认值不同的图像大小

$serv = new ConvertImage;
$serv->resize(600, 800);
$serv->convert('/images/foobar.jpg?12345');

// config - 'width' => 1200
// config - 'height' => 800
// output 'width' => 600
// output 'height' => 800

setQuality (int $quality)

更改与默认值不同的图像质量

$serv = new ConvertImage;
$serv->setQuality(50);
$serv->convert('/images/foobar.jpg?12345');

// config - 'quality' => 80
// output 'quality' => 50

createWebP (bool $create)

强制创建 webP,不考虑配置值。!!! 如果文件是外部的且未指定 convert_external_url 选项,则不会创建

$serv = new ConvertImage;
$serv->createWebP(true);
$serv->convert('/images/foobar.jpg?12345');

// config - 'create_webp' => false
// output 'create_webp' => true

setFormat (string)

更改与默认值不同的图像格式。支持的格式 在这里

$serv = new ConvertImage;
$serv->setFormat('gif');
$serv->convert('/images/foobar.jpg?12345');

// config - 'format' => 'jpg'
// output file *.gif

forceOverwrite (bool)

如果有文件,则覆盖文件。如果未启用 - 当有文件时,创建一个新的文件并添加时间戳到名称。不适用于 webP。webP 图像始终具有与处理后的文件相同的名称

$serv = new ConvertImage;
$serv->forceOverwrite(true);
$serv->convert('/images/foobar.jpg?12345');

// config - 'overwrite' => false
// output overwrite converted file if isset

$serv = new ConvertImage;
$serv->forceOverwrite(false);
$serv->setName('isset-foo-bar');
$serv->convert('/images/foobar.jpg?12345');

// config - 'overwrite' => false
// isset file isset-foo-bar.jpg
// output file isset-foo-bar-1234567.jpg

变更日志

有关最近更改的更多信息,请参阅CHANGELOG

贡献

有关详细信息,请参阅CONTRIBUTING

鸣谢

许可证

MIT 许可证 (MIT)。请参阅许可证文件以获取更多信息。