Installation

Requirements

• PHP >= 8.3
• Laravel 12.x
• GD or Imagick 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 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

The libvips driver is currently not supported.

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