README

Intervention Image's official driver to use the library with libvips. libvips is a fast, low-memory image processing library that outperforms the standard PHP image extensions GD and Imagick. This package makes it easy to utilize the power of libvips in your project while taking advantage of Intervention Image's user-friendly and easy-to-use API.

Installation

Install this library using Composer. Simply request the package with the following command:

composer require intervention/image-driver-vips

Getting Started

The public API of Intervention Image can be used unchanged. The only configuration that needs to be done is to ensure that Intervention\Image\Drivers\Vips\Driver by this library is used by Intervention\Image\ImageManager.

Code Examples

use Intervention\Image\ImageManager;
use Intervention\Image\Drivers\Vips\Driver as VipsDriver;
use Intervention\Image\Alignment;
use Intervention\Image\Format;

// create image manager instance using the desired driver
$manager = ImageManager::usingDriver(VipsDriver::class);

// read image data from path
$image = $manager->decodePath('images/example.webp');

// scale image by height
$image->scale(height: 300);

// insert a watermark
$image->insert('images/watermark.png', alignment: Alignment::BOTTOM_RIGHT);

// encode edited image
$encoded = $image->encodeUsingFormat(format: Format::JPEG, quality: 65);

// save encoded image
$encoded->save('images/example.jpg');

Requirements

• PHP >= 8.3
• Foreign Function Interface (FFI) Extension

Caveats

• Due to the technical characteristics of libvips, it is currently not possible to implement color quantization via ImageInterface::reduceColors() as intended. However, there is a pull request in libvips that enables this feature and it may be integrated here the future as well.

• With PHP on macOS, font files are not recognized in the ImageInterface::text() call by default because Quartz as a rendering engine does not allow font files to be loaded at runtime via the fontconfig API. However, setting the environment variable PANGOCAIRO_BACKEND to fontconfig helps here.

Authors

This library was developed by Oliver Vogel and Thomas Picquet.

License

Intervention Image Driver Vips is licensed under the MIT License.