PHPackages                             intervention/image-driver-vips - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image & Media](/categories/media)
4. /
5. intervention/image-driver-vips

ActiveLibrary[Image & Media](/categories/media)

intervention/image-driver-vips
==============================

libvips driver for Intervention Image

4.0.7(1mo ago)48177.4k—0%5[4 issues](https://github.com/Intervention/image-driver-vips/issues)[1 PRs](https://github.com/Intervention/image-driver-vips/pulls)6MITPHPPHP ^8.3CI passing

Since Jan 12Pushed 3w ago2 watchersCompare

[ Source](https://github.com/Intervention/image-driver-vips)[ Packagist](https://packagist.org/packages/intervention/image-driver-vips)[ Docs](https://image.intervention.io/)[ Fund](https://paypal.me/interventionio)[ GitHub Sponsors](https://github.com/Intervention)[ RSS](/packages/intervention-image-driver-vips/feed)WikiDiscussions develop Synced 3d ago

READMEChangelog (10)Dependencies (24)Versions (30)Used By (6)

libvips driver for Intervention Image
=====================================

[](#libvips-driver-for-intervention-image)

[![Latest Version](https://camo.githubusercontent.com/5bb6fefb0068f76c34f87004ef3b0d85680c44fc2cbc4582ea250c38cfe0b37b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f696e74657276656e74696f6e2f696d6167652d6472697665722d766970732e737667)](https://packagist.org/packages/intervention/image-driver-vips)[![Build Status](https://github.com/Intervention/image-driver-vips/actions/workflows/run-tests.yml/badge.svg)](https://github.com/Intervention/image-driver-vips/actions)[![Monthly Downloads](https://camo.githubusercontent.com/1dc2e601d4737c250cc32a10787bb7db0ff80afdefc7b053b93f04bddad5162c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f696e74657276656e74696f6e2f696d6167652d6472697665722d766970732e737667)](https://packagist.org/packages/intervention/image-driver-vips/stats)[![Support me on Ko-fi](https://raw.githubusercontent.com/Intervention/image-driver-vips/develop/.github/images/support.svg)](https://ko-fi.com/interventionphp)

[Intervention Image's](https://github.com/Intervention/image) official driver to use the library with [libvips](https://github.com/libvips/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
------------

[](#installation)

Install this library using [Composer](https://getcomposer.org). Simply request the package with the following command:

```
composer require intervention/image-driver-vips
```

Getting Started
---------------

[](#getting-started)

The public [API](https://image.intervention.io) of Intervention Image can be used unchanged. The only [configuration](https://image.intervention.io/v4/basics/configuration-drivers) 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
-------------

[](#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
------------

[](#requirements)

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

Caveats
-------

[](#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](https://github.com/libvips/php-vips/issues/256#issuecomment-2575872401)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
-------

[](#authors)

This library was developed by [Oliver Vogel](https://intervention.io) and Thomas Picquet.

License
-------

[](#license)

Intervention Image Driver Vips is licensed under the [MIT License](LICENSE).

###  Health Score

60

—

FairBetter than 98% of packages

Maintenance92

Actively maintained with recent releases

Popularity47

Moderate usage in the ecosystem

Community25

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 72.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~22 days

Recently: every ~7 days

Total

23

Last Release

38d ago

Major Versions

1.0.x-dev → 4.0.0-beta.12026-02-14

PHP version history (2 changes)1.0.0-beta.1PHP ^8.1

4.0.0-beta.1PHP ^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/7d172b42b2c5b53e71e56589fed3fb3467234a1c266d31b697b1d7b451f4cfe8?d=identicon)[olivervogel](/maintainers/olivervogel)

---

Top Contributors

[![olivervogel](https://avatars.githubusercontent.com/u/884642?v=4)](https://github.com/olivervogel "olivervogel (216 commits)")[![deluxetom](https://avatars.githubusercontent.com/u/6439307?v=4)](https://github.com/deluxetom "deluxetom (60 commits)")[![nlemoine](https://avatars.githubusercontent.com/u/2526939?v=4)](https://github.com/nlemoine "nlemoine (13 commits)")[![earthiverse](https://avatars.githubusercontent.com/u/602905?v=4)](https://github.com/earthiverse "earthiverse (9 commits)")[![bobab12](https://avatars.githubusercontent.com/u/3141657?v=4)](https://github.com/bobab12 "bobab12 (1 commits)")

---

Tags

imagelibvipsphpvipsimagelibvipsvips

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/intervention-image-driver-vips/health.svg)

```
[![Health](https://phpackages.com/badges/intervention-image-driver-vips/health.svg)](https://phpackages.com/packages/intervention-image-driver-vips)
```

###  Alternatives

[league/glide

Wonderfully easy on-demand image manipulation library with an HTTP based API.

2.6k53.3M146](/packages/league-glide)[intervention/image-laravel

Laravel Integration of Intervention Image

1588.9M183](/packages/intervention-image-laravel)[jcupitt/vips

A high-level interface to the libvips image processing library.

7061.9M49](/packages/jcupitt-vips)[bkwld/croppa

Image thumbnail creation through specially formatted URLs for Laravel

506516.3k28](/packages/bkwld-croppa)[laravel-at/laravel-image-sanitize

A small but handy package to prevent malicious code execution coming into your application through uploaded image files.

33866.8k](/packages/laravel-at-laravel-image-sanitize)[rokka/imagine-vips

libvips adapter for imagine

43638.4k7](/packages/rokka-imagine-vips)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)