PHP binding for libvips
php-vips is a binding for libvips 8.7 and later that runs on PHP 7.4 and later.
libvips is fast and needs little memory. The vips-php-bench repository tests php-vips against imagick and gd. On that test, and on my laptop, php-vips is around four times faster than imagick and needs 10 times less memory.
Programs that use libvips don't manipulate images directly, instead they create pipelines of image processing operations starting from a source image. When the pipe is connected to a destination, the whole pipeline executes at once and in parallel, streaming the image from source to destination in a set of small fragments.
Install
You need to install the libvips library. It's in the linux package managers, homebrew and MacPorts, and there are Windows binaries on the vips website. For example, on Debian:
sudo apt-get install libvips-dev
Or macOS:
brew install vips
You'll need to enable FFI in your PHP, then add vips to your composer.json:
"require": {
"jcupitt/vips" : "2.0.0"
}
Example
#!/usr/bin/env php
require __DIR__ . '/vendor/autoload.php';
use Jcupitt\Vips;
// fast thumbnail generator
$image = Vips\Image::thumbnail('somefile.jpg', 128);
$image->writeToFile('tiny.jpg');
// load an image, get fields, process, save
$image = Vips\Image::newFromFile($argv[1]);
echo "width = $image->width\n";
$image = $image->invert();
$image->writeToFile($argv[2]);
Run with:
$ composer install
$ ./try1.php ~/pics/k2.jpg x.tif
See examples/. We have a complete set of formatted API docs.
How it works
php-vips uses php-ffi to call directly into the libvips binary. It introspects the library binary and presents the methods it finds as members of the Image class.
This means that the API you see depends on the version of libvips that php-vips finds at runtime, and not on php-vips. php-vips documentation assumes you are using the latest stable version of the libvips library.
The previous php-vips version that relied on a binary extension and not on php-ffi is still available and supported in the 1.x branch.
Introduction to the API
Almost all methods return a new image as the result, so you can chain them. For example:
$new_image = $image->more(12)->ifthenelse(255, $image);
will make a mask of pixels greater than 12, then use the mask to set pixels to either 255 or the original image.
Note that libvips operators always make new images, they don't modify existing images, so after the line above, $image is unchanged.
You use long, double, array and image as parameters. For example:
$image = $image->add(2);
to add two to every band element, or:
$image = $image->add([1, 2, 3]);
to add 1 to the first band, 2 to the second and 3 to the third. Or:
$image = $image->add($image2);
to add two images. Or:
$image = $image->add([[1, 2, 3], [4, 5, 6]]);
To make a 2 x 3 image from the array, then add that image to the original.
Almost all methods can take an extra final argument: an array of options. For example:
$image->writeToFile("fred.jpg", ["Q" => 90]);
php-vips comes with full API docs. To regenerate these from your sources, type:
$ vendor/bin/phpdoc
And look in docs/.
There are around 300 operations in the library, see the vips docs for an introduction:
https://libvips.org/API/current
Test and install
$ composer install
$ composer test
$ vendor/bin/phpdoc
Regenerate auto docs
$ cd src
$ ../examples/generate_phpdoc.py
With IMagick:
![[question] How to use True Streaming in PHP?](https://avatars.githubusercontent.com/u/308009?v=4)
389 Nov 24, 2022
29 Dec 22, 2022
1 Jan 24, 2022
10 Jun 13, 2023
2 Oct 7, 2022
10 Nov 4, 2022
1 Jan 19, 2022
2 Jun 3, 2022
7 Aug 28, 2022
2 Nov 20, 2021
1 Dec 1, 2021
6 Oct 6, 2022
112 Nov 24, 2022
12 Jan 4, 2023
7 Nov 29, 2022
1.1k Dec 11, 2022
532 Dec 25, 2022
2 Sep 9, 2022
2.1k Dec 22, 2022