README

Gregwar\Image 类的目的是提供一个简单面向对象的图像处理和缓存 API。

安装

使用 composer

{
    ...
    "require": {
        "gregwar/image": "2.*"
    }
}

用法

基本处理

通过方法链，您可以在一行中打开、转换和保存文件

<?php use Gregwar\Image\Image;

Image::open('in.png')
     ->resize(100, 100)
     ->negate()
     ->save('out.jpg');

以下是调整大小方法

resize($width, $height, $background)：调整图像大小，将保持比例且不会放大（背景为红色以便理解发生的情况）

scaleResize($width, $height, $background)：调整图像大小，将保持比例，可以放大（背景为红色以便理解发生的情况）

forceResize($width, $height, $background)：调整图像大小，强制使其正好为 $width 乘以 $height

cropResize($width, $height, $background)：调整图像大小，保持比例（类似于 resize()）并裁剪空白区域

zoomCrop($width, $height, $background, $xPos, $yPos)：调整和裁剪图像以适应给定的尺寸

在 zoomCrop() 中，您可以使用 $xPos（中心、左或右）和 $yPos（中心、顶部或底部）更改调整大小图像的位置

其他可用方法包括

crop($x, $y, $w, $h)：将图像裁剪到坐标 $x,y 上的一个矩形框，其大小为 $w 乘以 $h
negate()：反转图像颜色
brighness($b)：在图像上应用亮度效果（从 -255 到 +255）
contrast($c)：在图像上应用对比度效果（从 -100 到 +100）
grayscale()：将图像转换为灰度
emboss()：浮雕图像
smooth($p)：平滑图像
sharp()：在图像上应用均值移除滤波器
edge()：在图像上应用边缘效果
colorize($red, $green, $blue)：着色图像（每个颜色从 -255 到 +255）
sepia()：应用棕褐色效果
merge($image, $x, $y, $width, $height)：合并两个图像
fill($color, $x, $y)：用给定的颜色填充图像
write($font, $text, $x, $y, $size, $angle, $color, $position)：在图像上写文本，$position 可以是 'left'、'right' 或 'center' 之一
rectangle($x1, $y1, $x2, $y2, $color, $filled=false)：绘制矩形
rotate($angle, $background = 0xffffff)：将图像旋转到给定的角度
roundedRectangle($x1, $y1, $x2, $y2, $radius, $color, $filled=false)：绘制圆角矩形（$radius 可以是任何值）
line($x1, $y1, $x2, $y2, $color)：绘制线条
ellipse($cx, $cy, $width, $height, $color, $filled=false)：绘制椭圆
circle($cx, $cy, $r, $color, $filled=false)：绘制圆形
fillBackground($bg=0xffffff)：将透明图像的背景填充为 'bg' 颜色
fixOrientation()：根据图像 EXIF 信息旋转和翻转图像
applyExifOrientation(int $exif_rotation_value)：根据 EXIF 旋转值旋转和翻转图像
html($title = '', $type = 'jpg')：返回包含缓存图像的 <img ... /> 标签
flip($flipVertical, $flipHorizontal)：在给定方向上翻转图像。两个参数都是布尔值，至少必须有一个为 true。
inline($type = 'jpg')：返回可内联的 base64 字符串（请参阅 demo/inline.php）

您还可以使用以下方法从头开始创建图像

<?php
    Image::create(200, 100);

其中 200 是宽度，100 是高度

保存图像

您可以使用save($file, $type = 'jpg', $quality = 80)将图像保存到显式文件中。

<?php
    // ...
    $image->save('output.jpg', 'jpg', 85);

您还可以使用get($type = 'jpg', $quality = 80)获取图像内容，这将返回图像的二进制内容。

使用缓存

上述每个操作实际上并不是直接应用于打开的图像，而是添加到一个操作数组中。这个操作数组，文件名、类型和修改时间使用sha1()进行哈希，然后使用哈希值来查找缓存文件。

一旦配置了缓存目录，您可以调用以下方法

jpeg($quality = 80)：即时查找或创建jpeg缓存文件
gif()：即时查找或创建gif缓存文件
png()：即时查找或创建png缓存文件
guess($quality = 80)：猜测类型（与输入相同）并即时查找或创建缓存文件
setPrettyName($prettyName, $prefix = true)：为文件设置一个“美观”的名称后缀，如果您想使其更具SEO友好性。例如，如果您将其称为“Fancy Image”，则缓存将类似于something/something-fancy-image.jpg。如果将$prefix传递给false（默认值为true），则美观的名称将不包含任何哈希前缀。如果您想使用非latin1美观的名称，必须安装behat/transliterator包。

例如

<?php use Gregwar\Image\Image;

echo Image::open('test.png')
          ->sepia()
          ->jpeg();

//Outputs: cache/images/1/8/6/9/c/86e4532dbd9c073075ef08e9751fc9bc0f4.jpg

如果原始文件和操作没有改变，哈希值将保持不变，缓存将不会再次生成。

您可以直接在HTML文档中使用它

<?php use Gregwar\Image\Image;

// ...
<img src="<?php echo Image::open('image.jpg')->resize(150, 150)->jpeg(); ?>" />
// ...

这很强大，因为如果您更改原始图像或代码中的任何内容，缓存的哈希值将更改，并且文件将被重新生成。

写入图像

您还可以使用绘图函数即时创建自己的图像

<?php 
    $img_src = Image::create(300, 300)
                    ->fill(0xffaaaa)    // Filling with a light red
                    ->rectangle(0xff3333, 0, 100, 300, 200, true) // Drawing a red rectangle
                      // Writing "Hello $username !" on the picture using a custom TTF font file
                    ->write('./fonts/CaviarDreams.ttf', 'Hello '.$username.'!', 150, 150, 20, 0, 'white', 'center')
                    ->jpeg();
?>
<img src="<?= $img_src  ?>" />

使用备用图像

如果图像文件不存在，您可以为类配置一个备用图像，该备用图像将被使用（请注意，这要求缓存目录可用）。

默认的“错误”图像位于images/error.jpg中，您可以使用以下方法进行更改

<?php
    $img->setFallback('/path/to/my/fallback.jpg');

垃圾回收

为了避免缓存无限增长，您可以使用提供的GarbageCollect类如下

<?php use Gregwar\Image\GarbageCollect;

// This could be a cron called each day @3:00AM for instance
// Removes all the files from ../cache that are more than 30 days
// old. A verbose output will explain which files are deleted
GarbageCollect::dropOldFiles(__DIR__.'/../cache', 30, true);

开发

Gregwar\Image使用PHP元编程范式，使其易于增强。

处理图像的每个函数都是在适配器中实现的，这是所有特定动作发生的地方。

通用适配器旨在包含常见的抽象动作，而特定适配器（如GD）旨在包含特定于底层层的动作。

您可以通过在相应的适配器中添加方法来添加自己的方法。

<?php
    // In the adapter
    private function myFilter()
    {
        $this->negate();
        $this->sepia();
    }

它可以在Image中使用

<?php
    $image->myFilter();

您还可以编写自己的适配器，它可以从该存储库扩展，并可以通过调用setAdapter()来使用它

<?php
    $image->setAdapter(new MyCustomAdapter);

许可证

Gregwar\Image在MIT许可证下，请阅读LICENSE文件以获取更多详细信息。不要犹豫，fork此存储库并对其进行自定义！

gregwar / image

维护者

详细信息