Intervention Image

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

This repository contains the openregion/image fork maintained for PHP 8.1+ compatibility.

• 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

Install this library using Composer. Add the package with the following command:

composer require openregion/image

Getting Started

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

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

Ensure that your server environment meets the following requirements before installation:

• PHP >= 8.1
• Mbstring PHP Extension
• Image Processing PHP Extension (GD, Imagick or libvips)

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

This fork is co-maintained by CIT Open Region.

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

License

Intervention Image is licensed under the MIT License.