---
application: "Intervention Image"
version: "Version 3"
status: "stable"
---

# Installation

## Installing Intervention Image

Learn how to install Intervention Image for PHP with Composer and discover what are requirements to run the library with your server environment seamlessly.


## Server 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

Although it is not a requirement, it is **highly recommended to have the Exif
PHP extension installed** as well. This is used, among other things, to correctly
display the orientation of images.

### Image Processing Extension

Your server environment must have at least one PHP image processing extension
installed. Intervention Image currently supports the three most popular.

- [GD Image](https://www.php.net/manual/en/book.image.php)
- [Imagick](https://www.php.net/manual/en/book.imagick.php)
- [libvips](https://www.libvips.org)

GD is part of most PHP installations. However I recommend using Imagick because
I think it is faster and more efficient especially for larger images. Support
for libvips is available via a driver that can be installed as an [add-on
package](https://github.com/Intervention/image-driver-vips).

Based on your environment, the appropriate driver must be configured later.

## Installation

Install Intervention Image with [Composer](https://getcomposer.org/) by running
the following command.

```bash
composer require intervention/image:^3
```

This will install Intervention Image with the most recent version, your
`composer.json` is automatically updated and you will be able use the package's
classes via the autoloader. To do this you will need to require the just
created `vendor/autoload.php` file to PSR-4 autoload all your installed
composer packages.

```php
require './vendor/autoload.php';
 
use Intervention\Image\ImageManager;
use Intervention\Image\Drivers\Imagick\Driver;

// create new manager instance with desired driver
$manager = new ImageManager(new Driver());
```

After installation you are ready to [configure the image manager](https://image.intervention.io/v3/basics/configuration-drivers.md) and [read or create image instances](https://image.intervention.io/v3/basics/instantiation.md).

---

## Become a Sponsor

### Intervention Image needs your help to keep the project going

Intervention Image is non-commercial, open source licensed and completely free to use. The considerable
effort required to maintain and develop the software is only possible with the financial support
of sponsors. There are two ways in which you can support this project.

- Support via [GitHub Sponsors](https://github.com/sponsors/Intervention)
- Support via [Ko-Fi](https://ko-fi.com/interventionphp)