PHPackages                             intervention/image - 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

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

intervention/image
==================

PHP Image Processing

3.11.7(2mo ago)14.3k194.3M—3.5%1.5k[15 issues](https://github.com/Intervention/image/issues)[1 PRs](https://github.com/Intervention/image/pulls)20MITPHPPHP ^8.1CI passing

Since Feb 4Pushed 3d ago269 watchersCompare

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

READMEChangelog (10)Dependencies (6)Versions (181)Used By (20)

Intervention Image
==================

[](#intervention-image)

PHP Image Processing
--------------------

[](#php-image-processing)

[![Latest Version](https://camo.githubusercontent.com/5986dd2d861fefcc46597ce3771199524ac5a061db7ee02ab72a683cac098e2b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f696e74657276656e74696f6e2f696d6167652e737667)](https://packagist.org/packages/intervention/image)[![Build Status](https://github.com/Intervention/image/actions/workflows/run-tests.yml/badge.svg)](https://github.com/Intervention/image/actions)[![Monthly Downloads](https://camo.githubusercontent.com/9fa464dceb2f8836d3c5b6fd0f6bae035b91228fad476e8fa58173040f9ebb5f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f696e74657276656e74696f6e2f696d6167652e737667)](https://packagist.org/packages/intervention/image/stats)[![Support me on Ko-fi](https://raw.githubusercontent.com/Intervention/image/develop/.github/images/support.svg)](https://ko-fi.com/interventionphp)

Intervention Image is a **PHP image processing library** that provides a simple and expressive way to create, edit, and compose images. It comes with a universal interface for the popular PHP image manipulation extensions. You can choose between the GD library, Imagick or libvips as the base layer for all operations.

- Fluent interface for common image editing tasks
- Interchangeable driver architecture with support for **GD, Imagick and libvips**
- Support for animated images with all drivers
- Framework-agnostic

Installation
------------

[](#installation)

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

```
composer require intervention/image
```

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

[](#getting-started)

Learn the [basics](https://image.intervention.io/v4/basics/instantiation/) on how to use Intervention Image and more with the [official documentation](https://image.intervention.io/v4/).

Code Examples
-------------

[](#code-examples)

```
use Intervention\Image\ImageManager;
use Intervention\Image\Drivers\Gd\Driver as GdDriver;
use Intervention\Image\Alignment;
use Intervention\Image\Color;
use Intervention\Image\Format;

// create image manager instance using the preferred driver
$manager = ImageManager::usingDriver(GdDriver::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::JPEG, quality: 65);

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

Requirements
------------

[](#requirements)

Before you begin with the installation make sure that your server environment supports the following requirements.

- PHP >= 8.3
- Mbstring PHP Extension
- Image Processing PHP Extension (GD, Imagick or libvips)

Supported Image Libraries
-------------------------

[](#supported-image-libraries)

Depending on your environment Intervention Image lets you choose between different image processing extensions.

- GD Library
- Imagick PHP extension
- [libvips](https://github.com/Intervention/image-driver-vips)

Security
--------

[](#security)

If you discover any security related issues, please email  directly.

Authors
-------

[](#authors)

This library is developed and maintained by [Oliver Vogel](https://intervention.io)

Thanks to the community of [contributors](https://github.com/Intervention/image/graphs/contributors) who have helped to improve this project.

License
-------

[](#license)

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

###  Health Score

87

—

ExcellentBetter than 100% of packages

Maintenance92

Actively maintained with recent releases

Popularity89

Widely adopted with strong download metrics

Community68

Healthy contributor diversity

Maturity91

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 93% 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 ~27 days

Recently: every ~8 days

Total

178

Last Release

73d ago

Major Versions

1.6.8 → 2.3.132017-04-23

2.7.1 → 3.0.0-alpha.12021-12-20

2.7.x-dev → 3.0.0-alpha.42022-07-05

3.11.6 → 4.0.0-alpha.12026-01-01

3.11.7 → 4.0.0-beta.42026-03-01

PHP version history (5 changes)1.0.0PHP >=5.3.0

2.3.0PHP >=5.4.0

3.0.0-alpha.1PHP ^8

3.0.0-alpha.6PHP ^8.1

4.0.0-alpha.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 (2058 commits)")[![kudashevs](https://avatars.githubusercontent.com/u/15892462?v=4)](https://github.com/kudashevs "kudashevs (36 commits)")[![vlakoff](https://avatars.githubusercontent.com/u/544424?v=4)](https://github.com/vlakoff "vlakoff (9 commits)")[![freshleafmedia](https://avatars.githubusercontent.com/u/10062339?v=4)](https://github.com/freshleafmedia "freshleafmedia (8 commits)")[![VincentLanglet](https://avatars.githubusercontent.com/u/9052536?v=4)](https://github.com/VincentLanglet "VincentLanglet (8 commits)")[![it-can](https://avatars.githubusercontent.com/u/644288?v=4)](https://github.com/it-can "it-can (7 commits)")[![frederikbosch](https://avatars.githubusercontent.com/u/1552577?v=4)](https://github.com/frederikbosch "frederikbosch (7 commits)")[![GwendolenLynch](https://avatars.githubusercontent.com/u/1427081?v=4)](https://github.com/GwendolenLynch "GwendolenLynch (7 commits)")[![wolfy-j](https://avatars.githubusercontent.com/u/796136?v=4)](https://github.com/wolfy-j "wolfy-j (6 commits)")[![localheinz](https://avatars.githubusercontent.com/u/605483?v=4)](https://github.com/localheinz "localheinz (5 commits)")[![dhensby](https://avatars.githubusercontent.com/u/563596?v=4)](https://github.com/dhensby "dhensby (5 commits)")[![jwpage](https://avatars.githubusercontent.com/u/52687?v=4)](https://github.com/jwpage "jwpage (5 commits)")[![seebeen](https://avatars.githubusercontent.com/u/6689756?v=4)](https://github.com/seebeen "seebeen (4 commits)")[![Gummibeer](https://avatars.githubusercontent.com/u/6187884?v=4)](https://github.com/Gummibeer "Gummibeer (4 commits)")[![MathiasReker](https://avatars.githubusercontent.com/u/26626066?v=4)](https://github.com/MathiasReker "MathiasReker (4 commits)")[![sagikazarmark](https://avatars.githubusercontent.com/u/1226384?v=4)](https://github.com/sagikazarmark "sagikazarmark (4 commits)")[![hkan](https://avatars.githubusercontent.com/u/2135597?v=4)](https://github.com/hkan "hkan (3 commits)")[![kalatabe](https://avatars.githubusercontent.com/u/3329412?v=4)](https://github.com/kalatabe "kalatabe (3 commits)")[![katzefudder](https://avatars.githubusercontent.com/u/195709?v=4)](https://github.com/katzefudder "katzefudder (3 commits)")[![guiwoda](https://avatars.githubusercontent.com/u/1625545?v=4)](https://github.com/guiwoda "guiwoda (3 commits)")

---

Tags

gdimageimagickinterventionphpthumbnailimagegdimagickresizewatermark

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[intervention/image-laravel

Laravel Integration of Intervention Image

1536.5M102](/packages/intervention-image-laravel)[sybio/image-workshop

Powerful PHP class using GD library to work easily with images including layer notion (like Photoshop or GIMP)

860918.1k11](/packages/sybio-image-workshop)[folklore/image

Image manipulation library for Laravel 5 based on Imagine and inspired by Croppa for easy url based manipulation

270248.2k5](/packages/folklore-image)[jbzoo/image

A PHP class that simplifies working with images

171126.9k3](/packages/jbzoo-image)[intervention/image-symfony

Symfony Integration of Intervention Image

1066.8k](/packages/intervention-image-symfony)[coldume/imagecraft

A reliable and extensible PHP image manipulation library

10133.7k2](/packages/coldume-imagecraft)

PHPackages © 2026

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