Added new Utilities

Author: le0daniel

src/Utility/Directories.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace le0daniel\Laravel\ImageEngine\Utility;
+
+final class Directories
+{
+
+    public static function makeRecursive(string $directory): void
+    {
+        if (file_exists($directory)) {
+            return;
+        }
+
+        if (!mkdir($directory, 0777, true) && !is_dir($directory)) {
+            throw new \RuntimeException(sprintf('Directory "%s" was not created', $directory));
+        }
+    }
+
+}

src/Utility/Images.php

@@ -0,0 +1,69 @@
+<?php
+
+namespace le0daniel\Laravel\ImageEngine\Utility;
+
+use Illuminate\Contracts\Filesystem\Filesystem;
+use Illuminate\Support\Facades\Storage;
+use le0daniel\Laravel\ImageEngine\Image\ImageException;
+use le0daniel\Laravel\ImageEngine\Image\ImageRepresentation;
+use League\Flysystem\Adapter\Local;
+
+final class Images
+{
+    public const ORIGINAL_SIZE = 'original';
+
+    static protected $imageExtensions = [
+        'png',
+        'jpg',
+        'jpeg',
+    ];
+
+    public static function verifyImageExtension(string $requestedFormat)
+    {
+        if (!in_array($requestedFormat, self::$imageExtensions, true)) {
+            throw ImageException::withHint(
+                'Invalid image extension given.',
+                "Available extensions: " . implode(', ', self::$imageExtensions)
+            );
+        }
+    }
+
+    public static function isOriginalSize(string $size): bool
+    {
+        return self::ORIGINAL_SIZE === $size;
+    }
+
+    private static function isLocalDisk(Filesystem $disk): bool
+    {
+        return $disk->getDriver()->getAdapter() instanceof Local;
+    }
+
+    public static function realPath(ImageRepresentation $imageRepresentation): string
+    {
+        $disk = $imageRepresentation->disk();
+
+        // Return path from local disk
+        if (self::isLocalDisk($disk)) {
+            $localPathPrefix = rtrim($disk->getDriver()->getAdapter()->getPathPrefix(), '/');
+            return realpath("{$localPathPrefix}/{$imageRepresentation->filePath}");
+        }
+
+        $baseCachePath = config('image-engine.original_cache_dir');
+        [$folder, $name] = Strings::splitAtIndex(md5($imageRepresentation->filePath), 6);
+        $cacheFilePath = "{$baseCachePath}/{$folder}/{$name}.{$imageRepresentation->extension}";
+
+        Directories::makeRecursive(dirname($cacheFilePath));
+
+        // Download and cache the file
+        if (!file_exists($cacheFilePath)) {
+            Resources::auto(
+                fn($resource) => $disk->writeStream($imageRepresentation->filePath, $resource),
+                'w+',
+                $cacheFilePath
+            );
+        }
+
+        return realpath($cacheFilePath);
+    }
+
+}

src/Utility/Resources.php

@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace le0daniel\Laravel\ImageEngine\Utility;
+
+final class Resources
+{
+
+    /**
+     * @param string $path
+     * @param string $mode
+     * @return resource
+     */
+    public static function open(string $path, string $mode)
+    {
+        $resource = fopen($path, $mode);
+        if (!is_resource($resource)) {
+            throw new \RuntimeException("Could not open resource {$path} in mode: {$mode}");
+        }
+
+        return $resource;
+    }
+
+    public static function close(...$resources): void
+    {
+        foreach ($resources as $resource) {
+            if (is_resource($resource)) {
+                fclose($resource);
+            }
+        }
+    }
+
+    public static function auto(\Closure $closure, string $mode, string ...$paths)
+    {
+        $resources = array_map(fn(string $path) => self::open($path, $mode), $paths);
+        $closure(...$resources);
+        self::close(...$resources);
+    }
+
+}

src/Utility/Strings.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace le0daniel\Laravel\ImageEngine\Utility;
+
+final class Strings
+{
+
+    /**
+     * @param string $string
+     * @param int $index
+     * @return string[]
+     */
+    public static function splitAtIndex(string $string, int $index): array
+    {
+        return [
+            substr($string, 0, $index),
+            $part2 = substr($string, $index),
+        ];
+    }
+
+}