Framework Integration
Use Intervention Image with Your Favorite Framework
2.6M Downloads / Month
Open Source MIT License
2.6M Downloads / Month
Open Source MIT License
Intervention Image can be easily integrated into a Laravel application with the official integration package. This package provides a Laravel service provider, facade and a publishable configuration file.
Although this integration is not mandatory, it has the advantage of integrating the configuration centrally in the application.
Instead of installing the Intervention Image directly, it is only necessary to integrate
the intervention/image-laravel
package. The corresponding base libraries are automatically
installed as well.
$ composer require intervention/image-laravel
Next, add the configuration files to your application using the vendor:publish
command:
php artisan vendor:publish --provider="Intervention\Image\Laravel\ServiceProvider"
This command will publish the configuration file image.php
to your app/config
directory. In this file you can set the desired driver for Intervention Image.
By default the library is configured to use GD library for image processing.
The integration is now complete and it is possible to access the ImageManager via Laravel's facade.
use Intervention\Image\Laravel\Facades\Image;
Route::get('/', function () {
$image = Image::read('images/example.jpg');
});
Intervention Image can also be integrated into the Symfony framework. A convenient way is to use the official integration bundle.
Although the use of this integration library is not absolutely mandatory, it offers a convenient way of central configuration in the Symfony framework.
Instead of installing the Intervention Image directly, it is only necessary to require the
bundle package intervention/image-symfony
. The corresponding dependencies
are automatically installed as well
$ composer require intervention/image-symfony
After the successful installation, you can activate the bundle in the file
config/bundes.php
of your Symfony application by inserting the following
line into the array.
return [
// ...
Intervention\Image\Symfony\InterventionImageBundle::class => ['all' => true],
];
Now you can configure the driver of Intervention Image. By default, the bundle
is using the GD library with Intervention Image. This can be easily configured
by creating a file config/packages/intervention_image.yaml
and setting the
driver class as follows.
intervention_image:
driver: Intervention\Image\Drivers\Imagick\Driver
You can choose between the two supplied drivers Intervention\Image\Drivers\Gd\Driver
and
Intervention\Image\Drivers\Imagick\Driver
for example.
The integration is now complete and it is possible to access the ImageManager via dependency injection. For example:
namespace App\Controller;
use Intervention\Image\ImageManager;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Annotation\Route;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
class ExampleController extends AbstractController
{
#[Route('/')]
public function example(ImageManager $manager): Response
{
$image = $manager->read('images/example.jpg');
}
}
Edit