coatesap/laravel-image

基于 folklore/image 分支的 Laravel 8 图像处理库

v3.0.0 2021-04-08 07:44 UTC

README

此操作将使包与最新的依赖项和现代 PHPUnit 测试保持最新。

Laravel Image

Laravel Image 是一个基于 PHP Imagine 库的 Laravel 图像处理包。它受到 Croppa 的启发,可以使用特殊格式的 URL 进行图像处理。它支持基本的图像处理,如缩放、裁剪、旋转和翻转。它还支持负片、灰度、伽玛、着色和模糊等效果。您还可以定义自定义过滤器以获得更大的灵活性。

Latest Stable Version Build Status Total Downloads

与其他图像处理库相比,此包的主要区别在于您可以直接在 URL 中使用参数来处理图像。然后,处理后的图像版本将保存在与原始图像相同的路径中,创建一个静态文件版本,绕过 PHP 以处理所有未来的请求

例如,如果您有一个图像在此 URL

/uploads/photo.jpg

要创建一个 300x300 的黑白版本,您可以使用以下 URL

/uploads/photo-image(300x300-crop-grayscale).jpg

要帮助您生成图像的 URL,您可以使用 Image::url() 方法

\Image::url('/uploads/photo.jpg',300,300,array('crop','grayscale'));

或者

<img src="<?=Image::url('/uploads/photo.jpg',300,300,array('crop','grayscale'))?>" />

或者,您可以使用 Image::make() 方法以编程方式处理图像。它支持与 Image::url() 方法相同的所有选项。

\Image::make('/uploads/photo.jpg',array(
	'width' => 300,
	'height' => 300,
	'grayscale' => true
))->save('/path/to/the/thumbnail.jpg');

或者直接使用 Imagine 库

$thumbnail = \Image::open('/uploads/photo.jpg')
			->thumbnail(new Imagine\Image\Box(300,300));

$thumbnail->effects()->grayscale();
	
$thumbnail->save('/path/to/the/thumbnail.jpg');

功能

此包使用 Imagine 进行图像处理。Imagine 与 GD2、Imagick、Gmagick 兼容,并支持许多 功能

此包还提供了一些可立即使用的常见过滤器(更多关于此内容

  • 缩放
  • 裁剪(带位置)
  • 旋转
  • 黑白
  • 反转
  • 伽玛
  • 模糊
  • 着色
  • 交错

版本兼容性

安装

服务器要求

安装

1- 通过 Composer 安装包。

composer require coatesap/laravel-image

2- 将服务提供程序添加到您的 app/config/app.php 文件中

'Folklore\Image\ImageServiceProvider',

3- 将外观添加到您的 app/config/app.php 文件中

'Image' => 'Folklore\Image\Facades\Image',

4- 发布配置文件和公共文件

$ php artisan vendor:publish --provider="Folklore\Image\ImageServiceProvider"

5- 查看配置文件

app/config/image.php

文档

路线图

以下是我们在未来想要添加的一些功能。欢迎合作改进此库。

  • 更多内置过滤器,如亮度和对比度
  • 在服务图像时提供更多配置
  • Artisan 命令用于处理图像
  • 支持对多个文件进行批处理操作