---
application: "Intervention Image"
version: "Version 2"
status: "eol"
---

# Upgrade Guide

## Upgrade from Intervention Image 1.x to 2.x




Although I tried to keep the update to Version 2.x of Intervention Image as compatible as possible, some things have changed. Some methods became redundant, other things have been simplified and therefore had to change. 

## New Features

- Additional support of PHP's Imagick extension
- Sharpening Images
- Auto Orientating
- Image Filter architecture

In order to keep your application compatible, you need to keep in mind the following changes, when upgrading.

### New Methods

- [width()](https://image.intervention.io/v2/api/width.md) retrieves current width of image.
- [height()](https://image.intervention.io/v2/api/height.md) retrieves current height of image.
- [sharpen()](https://image.intervention.io/v2/api/sharpen.md) applies sharpen filter to image.
- [orientate()](https://image.intervention.io/v2/api/orientate.md) auto-adjusts image orientation.
- [filter()](https://image.intervention.io/v2/api/filter.md) applies filter to an image.
- [getCore()](https://image.intervention.io/v2/api/get-core.md) get resource of image driver (Imagick object or GD resource).

## API changes

### Changed Method names

- [fit()](https://image.intervention.io/v2/api/fit.md) replaces the old ```grab()``` method.

### Changed Arguments on methods

- Method [gamma()](https://image.intervention.io/v2/api/gamma.md) now only accepts one argument for gamma correction. 
- Changed arguments for [resize()](https://image.intervention.io/v2/api/resize.md) method. Now uses callback to define further options. 
- Changed arguments for [circle()](https://image.intervention.io/v2/api/circle.md) method. Now uses callback to define further options.
- Changed arguments for [ellipse()](https://image.intervention.io/v2/api/ellipse.md) method. Now uses callback to define further options.
- Changed arguments for [line()](https://image.intervention.io/v2/api/line.md) method. Now uses callback to define further options.
- Changed arguments for [rectangle()](https://image.intervention.io/v2/api/rectangle.md) method. Now uses callback to define further options.

### Removed methods

- ```open()``` no longer exists, use [make()](https://image.intervention.io/v2/api/make.md) instead.
- ```raw()``` no longer exists, use [make()](https://image.intervention.io/v2/api/make.md) instead.
- ```grayscale()``` no longer exists, use [greyscale()](https://image.intervention.io/v2/api/greyscale.md) instead.

### Removed properties

- ```width``` property has been removed, use [width()](https://image.intervention.io/v2/api/width.md) instead.
- ```height``` property has been removed, use [height()](https://image.intervention.io/v2/api/height.md) instead.

### Other

- To keep naming consistent the filename of the configuration file for *intervention/imagecache* was renamed from `config/imagecache.php` to `config/config.php`.
- For standalone use instantiate objects from `Intervention\Image\ImageManagerStatic` instead of `Intervention\Image\Image`. ([See example](https://image.intervention.io/v2/getting-started/installation.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)