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 x $height

cropResize($width, $height, $background): 调整图像大小，保留比例（就像 resize()）并裁剪空白部分

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

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

其他可用方法包括

crop($x, $y, $w, $h): 将图像裁剪到坐标 $x,y 上的一个矩形框，其尺寸为 $w x $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): 绘制圆角矩形（半径可以是 0）
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 信息返回旋转和翻转的图像
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元编程范式，这使得它很容易增强。

处理图像的每个函数都是在Adapter中实现的，这就是所有特定操作发生的地方。

Common适配器旨在包含常见的抽象操作，而特定适配器（如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这个存储库并自定义它！

ahead4 / image

维护者

详细信息