README

PHP Image Processing

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 two most popular PHP image manipulation extensions. You can choose between the GD library or Imagick as the base layer for all operations.

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

Installation

You can easily install this library using Composer. Simply request 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

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

PHP >= 8.1
Mbstring PHP Extension
Image Processing PHP Extension

Supported Image Libraries

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

GD Library
Imagick PHP extension
libvips

Security

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

Authors

This library is developed and maintained by Oliver Vogel

Thanks to the community of contributors who have helped to improve this project.

License

Intervention Image is licensed under the MIT License.

intervention / image

Maintainers

Details