Intervention Image Laravel: Installing and Using the GD Extension

kavita.laravel311

29 June 2026

Intervention Image Laravel is a powerful package for image manipulation in Laravel applications.

It lets you resize, crop, rotate, compress, optimize, and convert images using the PHP GD Extension.

Whether you’re building an eCommerce store or CMS, Intervention Image Laravel helps improve image quality and application performance.

It also reduces image sizes, speeds up page loading, and delivers a better user experience.

In this guide, you’ll learn how to install the GD Extension and configure Intervention Image Laravel step by step.

You’ll also discover how to process uploaded images, generate thumbnails, and optimize images with practical examples.

By the end of this tutorial, you’ll be able to use Intervention Image Laravel efficiently in your Laravel projects.

What is Intervention Image Laravel?

Intervention Image is a popular open-source PHP image handling and manipulation library.

It provides a simple and expressive API for working with images in Laravel and PHP applications.

With Intervention Image, you can:

Resize images
Crop images
Rotate images
Add watermarks
Convert image formats
Compress images
Generate thumbnails

The package supports two image processing drivers:

GD Library
Imagick

The GD driver is the most commonly used because it comes bundled with PHP and is easy to install.

What is the Laravel GD Extension?

GD is a graphics library used to create and manipulate image files.

It enables PHP applications to perform operations such as resizing, cropping, drawing text, and dynamically generating images.

Intervention Image relies on either GD or Imagick to process images. If neither extension is installed, image manipulation features will not work.

How to Check if the Laravel GD Extension is Installed

Before installing Intervention Image, verify whether GD is already enabled.

Run:

php -m | grep gd

1 2	php -m \| grep gd

Alternatively:

php -i | grep GD

1 2	php -i \| grep GD

If GD is installed, you’ll see output similar to:

gd 
GD Support => enabled

1 2	gd GD Support => enabled

How to Install the Laravel GD Extension

Ubuntu/Debian

Install GD using:

sudo apt update
sudo apt install php-gd

sudo apt update

sudo apt install php-gd

For a specific PHP version:

sudo apt install php8.2-gd

1 2	sudo apt install php8.2-gd

Restart your web server:

sudo systemctl restart apache2

1 2	sudo systemctl restart apache2

Or for Nginx:

sudo systemctl restart php8.2-fpm
sudo systemctl restart nginx

sudo systemctl restart php8.2-fpm

sudo systemctl restart nginx

CentOS/RHEL

Install the extension:

sudo yum install php-gd

1 2	sudo yum install php-gd

Restart Apache:

sudo systemctl restart httpd

1 2	sudo systemctl restart httpd

Windows

Open your php.ini file.
Locate:

;extension=gd

1 2	;extension=gd

Remove the semicolon:

extension=gd

1 2	extension=gd

Save the file.
Restart Apache or your local development server.

Verifying GD Installation

Run:

php -m

php -m

You should see:

gd

You can also create a PHP info file:

<?php phpinfo();

1	<?php phpinfo();

Open it in your browser and search for GD Support.

Installing Intervention Image Laravel

Install the package using Composer:

composer require intervention/image

1 2	composer require intervention/image

Verify installation:

composer show intervention/image

1 2	composer show intervention/image

Resize Images with Intervention Image

Import the Image Manager:

use Intervention\Image\ImageManager;
use Intervention\Image\Drivers\Gd\Driver;

use Intervention\Image\ImageManager;

use Intervention\Image\Drivers\Gd\Driver;

Create a manager instance:

$manager = new ImageManager(new Driver());

1 2	$manager = new ImageManager(new Driver());

Read an image:

$image = $manager->read(storage_path('app/public/sample.jpg'));

1	$image = $manager->read(storage_path('app/public/sample.jpg'));

Resize the image:

$image->resize(300, 300);

1	$image->resize(300, 300);

Save the image:

$image->save(storage_path('app/public/resized.jpg'));

1	$image->save(storage_path('app/public/resized.jpg'));

Upload and Resize Images in Laravel

Controller Example

use Illuminate\Http\Request;
use Intervention\Image\ImageManager;
use Intervention\Image\Drivers\Gd\Driver;

public function upload(Request $request)
{
    $request->validate([
        'image' => 'required|image'
    ]);

    $manager = new ImageManager(new Driver());

    $image = $manager->read($request->file('image'));

    $image->resize(800, 600);

    $filename = time().'.jpg';

    $image->save(public_path('uploads/'.$filename));

    return back()->with('success', 'Image uploaded successfully.');
}

use Illuminate\Http\Request;

use Intervention\Image\ImageManager;

use Intervention\Image\Drivers\Gd\Driver;

public function upload(Request $request)

{

$request->validate([

'image' => 'required|image'

]);

$manager = new ImageManager(new Driver());

$image = $manager->read($request->file('image'));

$image->resize(800, 600);

$filename = time().'.jpg';

$image->save(public_path('uploads/'.$filename));

return back()->with('success', 'Image uploaded successfully.');

}

Blade Form

<form action="{{ route('image.upload') }}"
      method="POST"
      enctype="multipart/form-data">
    @csrf

    <input type="file" name="image">

    <button type="submit">
        Upload
    </button>
</form>

<form action="{{ route('image.upload') }}"

method="POST"

enctype="multipart/form-data">

@csrf

Upload

</button>

</form>

Crop Images with Intervention Image

$image->crop(400, 400);

1	$image->crop(400, 400);

This crops the image to a fixed size of 400×400.

Rotate Images in Laravel

$image->rotate(90);

1	$image->rotate(90);

Rotate the image by 90 degrees.

Convert Image Formats with Intervention Image

Convert PNG to JPG:

$image->save('converted.jpg');

1	$image->save('converted.jpg');

Intervention automatically determines the format based on the file extension.

Common Intervention Image Errors

GD Driver Not Installed

Error:

GD Library extension not available

1 2	GD Library extension not available

Solution:

Install and enable the GD extension, then restart your web server.

Class Not Found Error

Class "Intervention\Image\ImageManager" not found

1 2	Class "Intervention\Image\ImageManager" not found

Solution:

composer install
composer dump-autoload

composer install

composer dump-autoload

Memory Limit Errors

Large image uploads may exceed PHP memory limits.

Increase memory:

memory_limit = 512M

1 2	memory_limit = 512M

Restart PHP afterward.

GD vs Imagick for Intervention Image

Feature	GD	Imagick
Installation	Easy	Moderate
Performance	Good	Excellent
Memory Usage	Low	Higher
Advanced Features	Basic	Advanced
Laravel Compatibility	Excellent	Excellent

For most Laravel projects, GD provides everything needed for image resizing and optimization.

Best Practices for Intervention Image

Validate uploaded files before processing.
Resize large images before storing them.
Generate thumbnails for faster page loading.
Store processed images in Laravel’s storage directory.
Use queues for handling bulk image processing.
Optimize image size to improve website performance.

Conclusion

Intervention Image is one of the best libraries for image manipulation in Laravel applications.

Before using it, ensure that the GD extension is properly installed and enabled on your server.

Once configured, you can easily resize, crop, rotate, and optimize images with minimal code.

By combining Laravel with Intervention Image and the GD extension,

developers can create powerful image-processing workflows while maintaining excellent application performance.

Also you can hire laravel developers to customize this feature for your business needs.
Kindly explore our extensions.