sequelone/imgso

Библиотека преображения изображений Imgso для Laravel 5, основанная на библиотеке Imagine и вдохновленная Croppa для простой манипуляции с URL-адресами

dev-master 2017-04-26 20:05 UTC

This package is auto-updated.

Last update: 2024-03-24 23:27:55 UTC


README

Laravel Imgso пакет обработки изображений для Laravel 4 и 5 на основе библиотеки PHP Imagine. Был вдохновлён разработкой Croppa, поскольку он может использовать специально отформатированные URL-адреса для выполнения манипуляций. Он поддерживает базовые манипуляции с изображениями, такие как изменение размера, обрезка, поворот и флип. Он также поддерживает такие эффекты, как негатив, оттенки серого, гамма, расцветка и размытие. Вы также можете определить пользовательские фильтры для большей гибкости.

Latest Stable Version Build Status Total Downloads

Основное отличие этого пакета от других библиотек манипуляций с изображениями заключается в том, что вы можете использовать параметры непосредственно в URL-адресе для управления изображением. Управляемая версия изображения сохраняется в том же пути, что и исходное изображение, ** создавая статическую версию файла и обходя PHP для всех будущих запросов **.

Например, если у вас есть изображение по этому URL-адресу:

/uploads/photo.jpg

Чтобы создать версию 300x300 этого изображения в черно-белом режиме, вы используете URL-адрес:

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

Чтобы помочь вам сгенерировать URL-адрес изображения, вы можете использовать метод Imgso :: url ()

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

или

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

Альтернативно, вы можете программно манипулировать изображениями с помощью метода Imgso :: make (). Он поддерживает все те же опции, что и метод Imgso :: url ().

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

Или использовать библиотеку Imagine напрямую

$thumbnail = Imgso::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 и поддерживает множество функций (http://imagine.readthedocs.org/en/latest/).

Этот пакет также содержит некоторые общие фильтры, готовые к использованию (подробнее об этом):

  • Ресайз изображений
  • Обрезка (с положением)
  • Вращение
  • Черное и белое
  • Инвертирование
  • Гамма
  • Размытие
  • Раскрашивание
  • Чересстрочная развертка

Совместимость версий

Laravel Imgso
4.2.x dev-master
5.0.x dev-master
5.1.x dev-master
5.2.x dev-master
5.3.x dev-master
5.4.x dev-master

Установка

Зависимости:

Требования к серверу:

  • gd или Imagick или Gmagick
  • exif - Требуется для получения формата изображения.

Установка:

1- Добавьте в директорию require вашего файла composer.json.

{
	"require": {
		"sequelone/imgso": "dev-master"
	}
}

или

composer require sequelone/imgso dev-master

2- Запустите Composer, чтобы установить или обновить новый пакет.

$ composer install

или

$ composer update

3- Добавьте поставщика услуг в файл config/app.php

'Sequelone\Imgso\ImgsoServiceProvider',

4- Добавьте фасад config/app.php

'Imgso' => 'Sequelone\Imgso\Facades\Imgso',

5- Публикация файла конфигурации и общих файлов

$ php artisan vendor:publish --provider="Sequelone\Imgso\ImgsoServiceProvider"

6- Просмотрите файл конфигурации

config/imgso.php

Документация

Планы на будущее

Вот некоторые функции, которые мы хотели бы добавить в будущем. Не стесняйтесь сотрудничать и улучшать эту библиотеку.

  • Более встроенные фильтры, такие как Яркость и Контраст
  • Больше настроек при показе изображений
  • Artisan для управления изображениями
  • Поддержка пакетных операций над несколькими файлами