intervention/image

# Intervention Image ## PHP Image Processing [](https://packagist.org/packages/intervention/image) [](https://github.com/Intervention/image/actions) [](https://packagist.org/packages/intervention/image/stats) [](https://ko-fi.com/interventionphp) 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. - 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](https://getcomposer.org). Add the package with the following command: ```bash composer require intervention/image ``` ## Getting Started Learn the [basics](https://image.intervention.io/v4/basics/instantiation/) on how to use Intervention Image and more with the [official documentation](https://image.intervention.io/v4/). ## Code Examples ```php 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.3 - 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](https://github.com/Intervention/image-driver-vips) ## Security If you discover any security related issues, please email oliver@intervention.io directly. ## Authors This library is developed and maintained by [Oliver Vogel](https://intervention.io) Thanks to the community of [contributors](https://github.com/Intervention/image/graphs/contributors) who have helped to improve this project. ## License Intervention Image is licensed under the [MIT License](LICENSE).