feat: add support of libvips

composer.json

@@ -22,12 +22,14 @@
     "ext-fileinfo": "*",
     "ext-gd": "*",
     "ext-mbstring": "*",
+    "ext-ffi": "*",
     "benjaminhoegh/parsedown-toc": "^1.5",
     "cecil/resource-watcher": "^4.0",
     "cocur/slugify": "^4.6",
     "dflydev/dot-access-data": "^3.0",
     "erusev/parsedown-extra": "^0.8",
     "intervention/image": "^3.11",
+    "intervention/image-driver-vips": "^1.0",
     "james-heinrich/getid3": "^1.9",
     "laravel-zero/phar-updater": "^1.4",
     "matthiasmullie/minify": "^1.3",
@@ -79,7 +81,8 @@
       "ergebnis/composer-normalize": true
     },
     "platform": {
-      "php": "8.1.32"
+      "php": "8.1.32",
+      "ext-ffi": "3.4.5"
     },
     "sort-packages": true
   },

src/Asset/Image.php

@@ -17,6 +17,7 @@
 use Cecil\Exception\RuntimeException;
 use Intervention\Image\Drivers\Gd\Driver as GdDriver;
 use Intervention\Image\Drivers\Imagick\Driver as ImagickDriver;
+use Intervention\Image\Drivers\Vips\Driver as VipsDriver;
 use Intervention\Image\Encoders\AutoEncoder;
 use Intervention\Image\ImageManager;
 
@@ -27,24 +28,34 @@
  * and generating data URLs.
  *
  * This class uses the Intervention Image library to handle image processing.
- * It supports both GD and Imagick drivers, depending on the available PHP extensions.
+ * It supports GD, Imagick and Vips drivers, depending on the available PHP extensions.
  */
 class Image
 {
     /**
-     * Create new manager instance with available driver.
+     * Create new manager instance with available driver, faster first.
      */
     private static function manager(): ImageManager
     {
         $driver = null;
 
-        // ImageMagick is available? (for a future quality option)
-        if (\extension_loaded('imagick') && class_exists('Imagick')) {
-            $driver = ImagickDriver::class;
+        // use Imagick for better quality
+        /*if (\extension_loaded('imagick') && class_exists('Imagick')) {
+            $driver = new ImagickDriver();
+        }*/
+        // libvips is the fastest driver (if FFI is available)
+        if (\extension_loaded('ffi')) {
+            ini_set('ffi.enable', 'true');
+            $driver = new VipsDriver();
+            try {
+                $driver->checkHealth();
+            } catch (\Intervention\Image\Exceptions\DriverException) {
+                $driver = null;
+            }
         }
-        // Use GD, because it's the faster driver
-        if (\extension_loaded('gd') && \function_exists('gd_info')) {
-            $driver = GdDriver::class;
+        // GD by default
+        if ($driver === null && \extension_loaded('gd') && \function_exists('gd_info')) {
+            $driver = new GdDriver();
         }
 
         if ($driver) {
@@ -59,7 +70,7 @@ private static function manager(): ImageManager
             );
         }
 
-        throw new RuntimeException('PHP GD (or Imagick) extension is required.');
+        throw new RuntimeException('PHP GD extension is required.');
     }
 
     /**
@@ -213,8 +224,15 @@ public static function getDominantColor(Asset $asset): string
             $image = self::manager()->read(self::resize($asset, 100, 50));
 
             return $image->reduceColors(1)->pickColor(0, 0)->toString();
-        } catch (\Exception $e) {
-            throw new RuntimeException(\sprintf('Can\'t get dominant color of "%s": %s', $asset['path'], $e->getMessage()));
+        } catch (\Exception) {
+            // fallback to GD driver
+            try {
+                $image = ImageManager::withDriver(GdDriver::class)->read(self::resize($asset, 100, 50));
+
+                return $image->reduceColors(1)->pickColor(0, 0)->toString();
+            } catch (\Exception $e) {
+                throw new RuntimeException(\sprintf('Can\'t get dominant color of "%s": %s', $asset['path'], $e->getMessage()));
+            }
         }
     }