Installation

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
  • Image Processing Extension
• Installation

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
• Imagick
• libvips

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.

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

Installation

Install Intervention Image with Composer by running the following command.

composer require intervention/image

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.

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 and read or create image instances.