breadcrumb-the-shire/core/Service/Branding/BrandingLogoService.php

<?php

namespace MintyPHP\Service\Branding;

use MintyPHP\Service\Image\ImageUploadTrait;

class BrandingLogoService
{
    use ImageUploadTrait;

    private const MAX_SIZE = 5242880; // 5 MB
    private const SIZES = [64, 128, 256];
    private const DEFAULT_SIZE = 128;

    public function storageBase(): string
    {
        return self::imageStorageBase();
    }

    public function brandingDir(): string
    {
        return $this->storageBase() . '/branding/logo';
    }

    public function findLogoPath(?int $size = null): ?string
    {
        $dir = $this->brandingDir();
        if (!is_dir($dir)) {
            return null;
        }
        if ($size) {
            $size = $this->normalizeSize($size);
            $variant = $this->findVariantPath($dir, $size);
            if ($variant) {
                return $variant;
            }
        }
        $defaultVariant = $this->findVariantPath($dir, self::DEFAULT_SIZE);
        if ($defaultVariant) {
            return $defaultVariant;
        }
        $original = self::imageFindOriginalPath($dir);
        return $original ?: null;
    }

    public function hasLogo(): bool
    {
        $path = $this->findLogoPath();
        return $path ? is_file($path) : false;
    }

    public function delete(): bool
    {
        $dir = $this->brandingDir();
        if (!is_dir($dir)) {
            return true;
        }
        $matches = array_merge(
            glob($dir . '/logo-*.*') ?: [],
            glob($dir . '/logo.*') ?: [],
            glob($dir . '/original.*') ?: []
        );
        foreach ($matches as $file) {
            if (is_file($file)) {
                @unlink($file);
            }
        }
        return true;
    }

    public function saveUpload(array $file): array
    {
        if (empty($file) || !isset($file['tmp_name'])) {
            return ['ok' => false, 'error' => t('No file uploaded')];
        }
        if (($file['error'] ?? UPLOAD_ERR_NO_FILE) !== UPLOAD_ERR_OK) {
            return ['ok' => false, 'error' => t('Upload failed')];
        }
        if (($file['size'] ?? 0) > self::MAX_SIZE) {
            return ['ok' => false, 'error' => t('File is too large')];
        }

        $tmpPath = $file['tmp_name'];
        $mime = $this->detectMime($tmpPath);
        $isSvg = self::imageIsSvgUpload($mime, $tmpPath);
        $ext = self::imageExtensionForMime($mime, $isSvg);
        if (!$ext) {
            return ['ok' => false, 'error' => t('Invalid image file')];
        }
        if ($isSvg && !self::imageIsSafeSvg($tmpPath)) {
            return ['ok' => false, 'error' => t('Invalid image file')];
        }

        $dir = $this->brandingDir();
        if (!is_dir($dir) && !mkdir($dir, 0755, true) && !is_dir($dir)) {
            return ['ok' => false, 'error' => t('Upload failed')];
        }

        $this->delete();
        $originalPath = $dir . '/original.' . $ext;
        if (!move_uploaded_file($tmpPath, $originalPath)) {
            return ['ok' => false, 'error' => t('Upload failed')];
        }
        @chmod($originalPath, 0644);

        // SVGs are served as-is (no rasterization); raster images get WebP variants if GD supports it.
        $variantExt = function_exists('imagewebp') ? 'webp' : 'jpg';
        if (!$isSvg && self::imageCanResize()) {
            foreach (self::SIZES as $size) {
                $target = $dir . '/logo-' . $size . '.' . $variantExt;
                self::imageResizeAndFit($originalPath, $target, $size, $size, $variantExt);
            }
        }

        return ['ok' => true, 'path' => $originalPath, 'mime' => $mime];
    }

    public function detectMime(string $path): string
    {
        return self::imageDetectMime($path);
    }

    private function normalizeSize(int $size): int
    {
        if (in_array($size, self::SIZES, true)) {
            return $size;
        }
        return self::DEFAULT_SIZE;
    }

    // Multiple extensions may exist (e.g. after format change) — pick the most recently modified one.
    private function findVariantPath(string $dir, int $size): ?string
    {
        $matches = glob($dir . '/logo-' . $size . '.*');
        if (!$matches) {
            return null;
        }
        usort($matches, static function ($a, $b) {
            return filemtime($b) <=> filemtime($a);
        });
        return $matches[0];
    }
}