PHP image manipulation

Installs: 121 660 216

Dependents: 2 331

Suggesters: 146

Security: 0

Stars: 13 647

Watchers: 278

Forks: 1 486

Open Issues: 40

3.5.0 2024-03-13 16:26 UTC

README

PHP Image Processing

Latest Version Build Status Monthly Downloads

Intervention Image is a PHP image processing library that provides a simple and expressive way to create, edit, and compose images. It features a unified API for the two most popular 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
  • Interchangable driver architecture
  • Support for animated images
  • Framework-agnostic
  • PSR-12 compliant

Installation

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

  • PHP >= 8.1

Supported Image Libraries

  • GD Library
  • Imagick PHP extension

Development & Testing

This package contains a Docker image for building a test suite and an analysis container. You must have Docker installed on your system to run all tests using the following 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.

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.