folklore/image

基于Imagine并受Croppa启发的Laravel 5图像处理库,支持基于URL的简单图像操作

v0.3.25 2019-01-22 22:55 UTC

README

Laravel Image是Laravel 4和5的图像处理包,基于PHP Imagine库。它受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.json中通过Composer要求此包。

{
	"require": {
		"folklore/image": "0.3.*"
	}
}

2- 运行Composer以安装或更新新要求。

$ composer install

或者

$ composer update

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

'Folklore\Image\ImageServiceProvider',

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

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

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

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

6- 查看配置文件

app/config/image.php

文档

路线图

以下是我们希望在未来添加的一些功能。请随时合作并改进此库。

  • 更多内置过滤器,如亮度对比度
  • 在提供图像时提供更多配置
  • Artisan命令以操作图像
  • 支持对多个文件执行批量操作