Installation

Requirements

• PHP 8.3+
• Laravel 12+
• GD, Imagick or Vips (libvips) PHP extension installed and enabled

TIP

If you want to use the file caching feature (highly recommended), a configured Storage disk and a Cache driver are required. More info in the Image Caching section.

Installation

Install the package via composer:

composer require ace-of-aces/laravel-image-transform-url

Publish the config file with:

php artisan vendor:publish --tag="image-transform-url-config"

Driver Configuration

To use Imagick or Vips instead of the default GD library for image processing (recommended for performance), you must change the default image driver for the underlying Intervention Image package.

INFO

For the Vips driver option, make sure you have the necessary Vips driver package for Intervention Image installed and configured as default.

PHP Settings

Depending on your environment, you may need to adjust some php.ini settings.

1. If you are using the default GD driver, be aware that it can use alot more RAM than regular web requests. It's highly recommended to set your memory limit to at least 256 MB.

memory_limit=512M

2. If you have the Swoole extension installed, ensure you have the following setting to avoid conflicts with Laravel's defer helper, which this package uses.

swoole.use_shortname=off