tatter/缩略图

模块化缩略图生成,适用于CodeIgniter 4

v2.0.0-beta.3 2022-01-28 16:36 UTC

README

模块化缩略图生成,适用于CodeIgniter 4

Coverage Status

快速开始

  1. 使用Composer安装:> composer require tatter/thumbnails
  2. 加载服务:$thumbnails = service('thumbnails');
  3. 创建第一个缩略图:$thumbnails->create('bigfile.jpg', 'thumbnail.jpg');

特性

缩略图使用CodeIgniter4的内置Image类进行快速高效的处理。它还会检查模块化支持文件,以便它可以扩展以覆盖您可能想要缩略图的所有内容:视频、3D资源、文本文件。

安装

通过Composer轻松安装以利用CodeIgniter 4的自动加载功能,并始终保持最新状态

composer require tatter/thumbnails

或者,通过下载源文件并将目录添加到app/Config/Autoload.php中来手动安装。

配置(可选)

可以通过扩展其配置文件来更改库的默认行为。将examples/Thumbnails.php复制到app/Config/,并遵循注释中的说明。如果在app/Config中找不到配置文件,库将使用其自身的。

用法

  • 加载服务:$thumbnails = service('thumbnails');
  • 使用配置文件来定义参数,或在运行时更改它们
$thumbnails->setImageType(IMAGETYPE_PNG);
$thumbnails->setWidth(120);
  • 使用create()方法将缩略图写入方便的位置:$thumbnails->create('bigfile.jpg', 'thumbnail.png');

扩展

库将在所有命名空间中查找Thumbnailers/目录,并加载它找到的任何受支持的类。每个类都定义它支持的扩展以及自己的process()方法来生成图像。从其他模块添加额外的扩展支持,或编写自己的。文件将通过将扩展名与每个处理器的受支持扩展列表匹配来处理。您还可以使用setHandler(string $id)方法指定要使用的特定处理器(请参阅Tatter\Handlers)。

贡献

此库将定期更新以支持新的扩展,但请随时提交包含额外处理器(或错误修复)的拉取请求。