Intervention Image is a image handling and manipulation library written in PHP providing an easy and expressive way to create, edit, and compose images. GD library or Imagick can be selected as the base layer for all operations.

Simple interface for common image manipulation tasks
Interchangable driver architecture
Support for animated images
Framework-agnostic
PSR-12 compliant

Installation

composer require intervention/image

Getting started

Learn the basics on how to use Intervention Image and more with the official documentation.

Code Examples

// create image manager with desired driver
$manager = new ImageManager(
    new Intervention\Image\Drivers\Gd\Driver()
);

// open an image file
$image = $manager->read('images/example.gif');

// resize image instance
$image->resize(height: 300);

// insert a watermark
$image->place('images/watermark.png');

// encode edited image
$encoded = $image->toJpg();

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

Requirements

PHP >= 8.1

Supported Image Libraries

GD Library
Imagick PHP extension

Development & Testing

With this package comes a Docker image to build a test suite and analysis container. To build this container you have to have Docker installed on your system. You can run all tests with this command.

docker-compose run --rm --build tests

Run the static analyzer on the code base.

docker-compose run --rm --build analysis

License

Intervention Image is licensed under the MIT License.