2021-12-07 11:00:06 +00:00
# Intervention Image
## PHP Image Manipulation
[![Latest Version ](https://img.shields.io/packagist/v/intervention/image.svg )](https://packagist.org/packages/intervention/image)
2022-07-05 19:54:11 +02:00
[![Build Status ](https://github.com/Intervention/image/actions/workflows/run-tests.yml/badge.svg )](https://github.com/Intervention/image/actions)
2021-12-07 11:00:06 +00:00
[![Monthly Downloads ](https://img.shields.io/packagist/dm/intervention/image.svg )](https://packagist.org/packages/intervention/image/stats)
2022-07-09 17:58:26 +02:00
Intervention Image is a **image handling and manipulation library written in PHP** providing an easier and expressive way to create, edit, and compose images. GD library or Imagick can be selected as the base layer for all operations.
2021-12-07 11:00:06 +00:00
2022-07-09 17:58:26 +02:00
- Simple interface for common tasks
- Interchangable driver architecture
2021-12-07 11:00:06 +00:00
- Support for animated images
2022-07-09 17:58:26 +02:00
- Framework-agnostic
2021-12-07 11:00:06 +00:00
- PSR-12 compliant
## Code Examples
```php
// create image manager with desired driver
$manager = new ImageManager('gd')
// open an image file
2022-07-09 17:58:26 +02:00
$image = $manager->make('images/example.gif');
2021-12-07 11:00:06 +00:00
// resize image instance
$image->resize(320, 240);
// 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.0
## Supported Image Libraries
- GD Library
- Imagick PHP extension
## Installation
```bash
composer require intervention/image
```
## Getting started
2022-07-09 17:58:26 +02:00
Learn the [basics ](https://image.intervention.io/v3/basics/instantiation/ ) on how to use Intervention Image and more with the [official documentation ](https://image.intervention.io/v3/ ).
2021-12-07 11:00:06 +00:00
## License
Intervention Image is licensed under the [MIT License ](http://opensource.org/licenses/MIT ).
2022-07-09 17:58:26 +02:00
Copyright 2022 Oliver Vogel