Download the PHP package mehr-it/levi-images without Composer
On this page you can find all versions of the php package mehr-it/levi-images. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package levi-images
Image processing and optimization toolkit for Laravel
This package provides image processing using Imagine and optimization using Spatie Image Optimizer. Libvips support for Imagine is available through Imagine-Vips and basic SVG manipulation is available through Imagine SVG.
Raster image processing can use different packages such as imagick, gmagick, vips and gd as backend.
Imagick is a good choice if you need the full feature set of Imagine. Vips is faster and uses less memory, but requires a separate PHP extension and is missing some more advanced features.
For optimization, additional libraries have to be installed at your system. See installation chapter.
Installation
You can install the package via composer:
Testing your installation
This library depends on various system requirements for all features to work. You can use following command to check the installed components:
Installing optimization tools
The optimizer uses various optimization tools as they are available at your system:
You can install them on Debian/Ubuntu using following commands:
For more details see Spatie Image Optimizer.
Installing libvips driver
Libvips is a fast, multi-threaded image processing library which needs far less memory than eg. Imagick.
Version 8.7 or higher of libvips is highly recommended. paste
and rotate
by angles other than multipliers of 90 are not supported with older versions of libvips.
Regardless of the libvips version, not all Imagine features are supported. See Imagine-Vips for details.
You also need the php-vips-ext extension version 1.0.8 or higher. You can install libvips driver requirements as follows:
-
Install the libvips library and headers. It's in the linux package managers, homebrew and MacPorts, and there are Windows binaries on the vips website. For example, on Debian:
-
Install the binary PHP extension. You'll need a PHP development environment for this, since it will download and build the sources for the extension. For example, on Debian:
Then to download and build the extension:
You may need to add
extension=vips.so
or equivalent tophp.ini
, see the output of pecl. - Install Imagine-Vips:
Usage
This package has three image processing sections.
-
Raster Provides an API to load or create raster images for manipulation or conversion to other formats.
-
Vector Provides an API to load vector images for some basic manipulation.
- Optimization provides an API to optimize images in their given format. Usually optimizers reduce the image file size and optimize the loading process, eg. interlaced loading.
You can access all APIs using the LeviImages
facade, eg.
LeviImages::raster()
.
Raster images
The raster image API can be accessed as follows:
It offers three different methods to open images:
All these methods return an instance of Imagine\Image\ImageInterface
for Imagine image manipulations.
Configuring the raster image driver
The concrete implementation depends on the backends available at your system and your driver selection. By default a driver is chosen automatically. Imagick is preferred, if multiple drivers are available. However, if you prefer another driver such as Vips you can set another default driver.
Use php ./artisan vendor:publish
to publish the package configuration and set the desired driver:
Creating new raster images
To create a new raster image from the scratch, simply call
create()
with the desired size and background color:
Importing (vector) images
Occasionally you might want to use Imagine
instances created by another library with your current driver or
import vector images to merge them with raster images. You can easily do so by calling import()
. The following example demonstrates how to merge a vector image with a raster image:
NOTE: The "gd"
driver does not support loading vector images.
This returns a new image instance which can be used with the current driver.
Internally the imported image is exported in a compatible format and loaded utilizing the current driver.
Vector images
The vector image API can be accessed as follows:
It offers the same methods to open images as the raster API.
All these methods return an instance of Contao\ImagineSvg\Image
. Event though Imagine SVG implements the
Imagine\Image\ImageInterface
, it only offers a limited set of manipulations and some behave a little different from raster images. However, some basic operations, such as resizing are available and very useful.
The vector image API does not offer methods for creating new images or importing from other instances.
Optimization
The optimization API can be accessed as follows:
The optimizer utilizes different optimization libraries which are installed at your system and applies them to the files which should be optimized. If no optimization library for a given file type is available, the file is silently kept as it is.
Optimizing image files
You can optimize image files using optimizeFile()
. If you do not want to modify the original file, a separate output path can be given as second parameter:
Optimizing resources
If image data is available as resource, optimizeResource()
processes the image and returns a new resource with optimized image data:
Passing image instances
If working with raster or vector image objects, you can directly pass the image object to optimizeImage()
. However, you have to specify the desired output format as second parameter. You will receive a resource with the optimized image data:
Note: The only supported output format for vector images is Optimizer::FORMAT_SVG
. If you want a raster image output, first import as raster image.
Customizing optimizers
If you want to use a custom set of optimizers or other than default optimization settings, you can set a resolver function which returns the optimizers to use:
Using setOptimizersResolver()
changes the global optimizer chain. If you only want to change optimizers for a single optimization, you can use useOptimizers()
to create a new instance with the given optimizers:
All given optimizers must implement the \Spatie\ImageOptimizer\Optimizer
interface. See Spatie Image Optimizer
for details.
Filters
This library also includes some filters for raster images:
Filter | Drivers | |
---|---|---|
AutoCrop | vips, imagick | crops background from edges |
Canvas | all | adds a background color and an optional margin to images |
GrayScaleAlpha | all | converts to grayscale but preserves the alpha channel |
GrayScaleMaxBlack | vips, imagick | converts to grayscale and stretches the histogram to make darkest color "black" |
Palette | all | converts to a color palette |
License
This package is released unter MIT license.
Imagine SVG is released under LGPL-3.0-or-later.
All versions of levi-images with dependencies
laravel/framework Version ^5.8|^6.0|^7.0|^8.0
spatie/image-optimizer Version ^1.5
imagine/imagine Version ^1.2
contao/imagine-svg Version ^1.0
ext-fileinfo Version *