Intervention Image

PHP Image Manipulation

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

You can install this package easily with Composer. Just require the package with the following command:

composer require intervention/image

Getting started

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

Code Examples

use Intervention\Image\ImageManager;

// 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

Security

If you discover any security related issues, please email oliver@intervention.io directly.

License

Intervention Image is licensed under the MIT License.

2.4 KiB Raw Blame History