crachecode/tajine

图片缩略图生成器

v1.0.1 2017-11-07 06:33 UTC

This package is not auto-updated.

Last update: 2024-09-28 03:08:27 UTC


README

Tajine 是一个适用于任何 Web 项目的图像和缩略图生成器。它基于 Intervention Image 库。

功能

Tajine 允许您以灵活的方式在任何尺寸调整图像,并缓存生成的图像。这些图像可以通过在 URL 中传递参数直接通过 HTTP 调用特定大小的图像。此 URL 可以在 HTML 文件中用作 img 标签的 src 参数(或 CSS 规则集)。

要求

Tajine 需要 PHP 5.6 或更高版本。其缓存功能可以利用 Apache mod_rewrite,它还允许更简单的图像 URL,但 Apache 不是必需的。尽管如此,Tajine 也尚未与其他 HTTP 服务器进行测试。

安装

  1. 使用 Git 克隆仓库
    git clone https://github.com/crachecode/tajine.git

  2. 进入新目录
    cd tajine

  3. 使用 Composer 安装依赖项
    composer update

  4. 允许写入缓存目录
    chmod 777 public/img/cache

  5. tajinetajine/public 目录定义为您的虚拟主机根目录。

使用 Tajine

原始图像应放置在 tajine/public/img/originals 目录中。

然后可以通过以下 URL 语法通过 HTTP 访问任何尺寸的图像

{name}.{width}x{height}.{method}.{quality}.{upsize}.{extension}

例如

  • image.1280x1024.basic.90.false.jpg(宽度 = 1280px,高度 = 1024px,基本方法,jpg 质量 90,不放大)
  • image.1280x.false.jpg(宽度 = 1280px,未指定高度,不放大)
  • image.x1024.jpg(高度 = 1024px,未指定宽度)

参数

方法 可以设置为

  • basic:图像将调整到精确尺寸,不保持宽高比。
  • fit:图像将调整以适应指定的宽度/高度,保持宽高比。
    如果只指定了一个尺寸,则未指定的尺寸(宽度或高度)将根据另一个尺寸进行调整。
    如果两个都指定了,则必要时将裁剪图像。
  • max:图像将调整以适应指定的宽度/高度,保持宽高比,不裁剪。

无需 mod_rewrite

即使没有 mod_rewrite 或使用 Apache 以外的 HTTP 服务器,您仍然可以使用 Tajine。但是,调用图像的 URL 会有所不同(并且不太美观)

index.php?filename={name}.{extension}&width={width}&height={height}&method={method}&quality={quality}&upsize={upsize}

例如

  • index.php?filename=image.jpg&width=1280&height=1024&method=basic&quality=90&upsize=false
  • index.php?filename=image.jpg&height=1024

注意事项

生成的缩略图作为图像文件保存在 tajine/public/img/cache 目录中。
当使用 mod_rewrite 时,这些文件名与为图像生成提供的 URL 提供的字符串相同。因此,Apache 甚至不需要处理 PHP 来显示缓存的版本。
它们可以安全地删除以再次处理生成。