02 - Installation et Configuration Complète

J’ai pris soin de configurer le package pour qu’il soit parfaitement intégré à l’écosystème Laravel 12.

1. Dépendance Composer

Voici l’extrait de votre composer.json que j’ai mis à jour :

"require": {
    "php": "^8.4",
    "intervention/image-laravel": "^4.0",
    "laravel/framework": "^12.0"
}

Pour l’installer, j’ai exécuté :

composer require intervention/image-laravel

2. Configuration d’Intervention (v4)

Après avoir publié la configuration via php artisan vendor:publish, j’ai modifié le fichier config/image.php pour utiliser Imagick.

Pourquoi j’ai forcé Imagick ?

J’ai remarqué que le driver par défaut (GD) produisait des artéfacts sur les textes en rotation et gérait moins bien la transparence des logos PNG. Avec Imagick, le rendu du texte à 45° est parfaitement lisse.

Fichier config/image.php final :

<?php

declare(strict_types=1);

return [

    /*
    |--------------------------------------------------------------------------
    | Image Driver
    |--------------------------------------------------------------------------
    |
    | Intervention Image supports “GD Library” and “Imagick” to process images
    | internally. Depending on your PHP setup, you can choose one of them.
    |
    */

    'driver' => env('IMAGE_DRIVER', \Intervention\Image\Drivers\Imagick\Driver::class),

    /*
    |--------------------------------------------------------------------------
    | Configuration Options
    |--------------------------------------------------------------------------
    */
    'options' => [
        'autoOrientation' => true,
        'decodeUpscale' => false,
    ]
];

3. Extension Système

J’ai vérifié que votre environnement possède bien les outils nécessaires :

php -m | grep imagick # Retourne 'imagick'

Si vous déployez sur un nouveau serveur, n’oubliez pas d’installer php-imagick et imagemagick.