Skip to content

Open-source event management and ticket selling platform — perfect for concerts, conferences, and everything in between 🎟️ If you find this project helpful, please consider giving us a star ⭐️

Feature: Extract image metadata on upload (LQIP, width, height and avg colour) (#947)

Dave Earley2ad5454eba9d
diff --git a/backend/Dockerfile b/backend/Dockerfile
index b626f541c..609a307da 100644
--- a/backend/Dockerfile
+++ b/backend/Dockerfile
@@ -9,7 +9,7 @@ RUN echo "" >> /usr/local/etc/php-fpm.d/docker-php-serversideup-pool.conf && \
echo "user = www-data" >> /usr/local/etc/php-fpm.d/docker-php-serversideup-pool.conf && \
echo "group = www-data" >> /usr/local/etc/php-fpm.d/docker-php-serversideup-pool.conf
-RUN install-php-extensions intl
+RUN install-php-extensions intl imagick
COPY --chown=www-data:www-data . .
diff --git a/backend/Dockerfile.dev b/backend/Dockerfile.dev
index 9aed46137..e4f9153f5 100644
--- a/backend/Dockerfile.dev
+++ b/backend/Dockerfile.dev
@@ -12,7 +12,7 @@ COPY --chown=www-data:www-data . /var/www/html
# Switch to root user to install PHP extensions
USER root
-RUN install-php-extensions intl
+RUN install-php-extensions intl imagick
USER www-data
RUN chmod -R 755 /var/www/html/storage \
diff --git a/backend/app/Console/Commands/BackfillImageMetadataCommand.php b/backend/app/Console/Commands/BackfillImageMetadataCommand.php
new file mode 100644
index 000000000..a15a0842a
--- /dev/null
+++ b/backend/app/Console/Commands/BackfillImageMetadataCommand.php
@@ -0,0 +1,252 @@
+<?php
+
+namespace HiEvents\Console\Commands;
+
+use HiEvents\DomainObjects\Generated\ImageDomainObjectAbstract;
+use HiEvents\Models\Image;
+use HiEvents\Services\Infrastructure\Image\DTO\ImageMetadataDTO;
+use Illuminate\Console\Command;
+use Illuminate\Filesystem\FilesystemManager;
+use Imagick;
+use Psr\Log\LoggerInterface;
+use Throwable;
+
+class BackfillImageMetadataCommand extends Command
+{
+ protected $signature = 'images:backfill-metadata
+ {--limit=100 : Maximum number of images to process per batch}
+ {--batch-size=50 : Number of images to process before clearing memory}
+ {--dry-run : Show what would be done without actually doing it}
+ {--force : Re-process images that already have metadata}';
+
+ protected $description = 'Backfill image metadata (dimensions, average colour, LQIP) for existing images';
+
+ private const LQIP_MAX_DIMENSION = 16;
+ private const LQIP_QUALITY = 60;
+
+ public function __construct(
+ private readonly FilesystemManager $filesystemManager,
+ private readonly LoggerInterface $logger,
+ ) {
+ parent::__construct();
+ }
+
+ public function handle(): int
+ {
+ if (!$this->isImagickAvailable()) {
+ $this->error('Imagick extension is not available. Please install it first.');
+ return self::FAILURE;
+ }
+
+ $this->info('Starting image metadata backfill...');
+
+ $limit = (int)$this->option('limit');
+ $batchSize = (int)$this->option('batch-size');
+ $dryRun = $this->option('dry-run');
+ $force = $this->option('force');
+
+ if ($dryRun) {
+ $this->warn('DRY RUN MODE - No changes will be made');
+ }
+
+ $query = Image::query()
+ ->whereNull('deleted_at');
+
+ if (!$force) {
+ $query->where(function ($q) {
+ $q->whereNull(ImageDomainObjectAbstract::WIDTH)
+ ->orWhereNull(ImageDomainObjectAbstract::HEIGHT)
+ ->orWhereNull(ImageDomainObjectAbstract::AVG_COLOUR)
+ ->orWhereNull(ImageDomainObjectAbstract::LQIP_BASE64);
+ });
+ }
+
+ $totalCount = $query->count();
+
+ if ($totalCount === 0) {
+ $this->info('No images found that need metadata backfill.');
+ return self::SUCCESS;
+ }
+
+ $toProcess = min($totalCount, $limit);
+ $this->info("Found {$totalCount} images without complete metadata. Processing {$toProcess}...");
+
+ $progressBar = $this->output->createProgressBar($toProcess);
+ $progressBar->start();
+
+ $successCount = 0;
+ $errorCount = 0;
+ $skippedCount = 0;
+ $processedInBatch = 0;
+
+ $query->take($limit)
+ ->orderBy('id')
+ ->chunk($batchSize, function ($images) use (
+ &$successCount,
+ &$errorCount,
+ &$skippedCount,
+ &$processedInBatch,
+ $progressBar,
+ $dryRun,
+ $batchSize,
+ ) {
+ foreach ($images as $image) {
+ try {
+ $result = $this->processImage($image, $dryRun);
+
+ if ($result === 'success') {
+ $successCount++;
+ } elseif ($result === 'skipped') {
+ $skippedCount++;
+ } else {
+ $errorCount++;
+ }
+ } catch (Throwable $e) {
+ $this->newLine();
+ $this->error("Failed to process image #{$image->id}: {$e->getMessage()}");
+ $errorCount++;
+ }
+
+ $progressBar->advance();
+ $processedInBatch++;
+
+ if ($processedInBatch >= $batchSize) {
+ gc_collect_cycles();
+ $processedInBatch = 0;
+ }
+ }
+ });
+
+ $progressBar->finish();
+ $this->newLine(2);
+
+ $this->info('Backfill complete!');
+ $this->table(
+ ['Status', 'Count'],
+ [
+ ['Success', $successCount],
+ ['Errors', $errorCount],
+ ['Skipped', $skippedCount],
+ ['Total Processed', $successCount + $errorCount + $skippedCount],
+ ]
+ );
+
+ return $errorCount > 0 ? self::FAILURE : self::SUCCESS;
+ }
+
+ private function processImage(Image $image, bool $dryRun): string
+ {
+ $disk = $image->disk;
+ $path = $image->path;
+
+ if (!$disk || !$path) {
+ $this->logger->warning("Image #{$image->id} has no disk or path");
+ return 'skipped';
+ }
+
+ $filesystem = $this->filesystemManager->disk($disk);
+
+ if (!$filesystem->exists($path)) {
+ $this->logger->warning("Image file not found for image #{$image->id}: {$path}");
+ return 'skipped';
+ }
+
+ if ($dryRun) {
+ $this->newLine();
+ $this->line("Would process: Image #{$image->id}, Path: {$path}");
+ return 'success';
+ }
+
+ $tempFile = null;
+ $imagick = null;
+
+ try {
+ $tempFile = tempnam(sys_get_temp_dir(), 'img_backfill_');
+ file_put_contents($tempFile, $filesystem->get($path));
+
+ $imagick = new Imagick($tempFile);
+
+ $metadata = $this->extractMetadata($imagick);
+
+ $image->update([
+ ImageDomainObjectAbstract::WIDTH => $metadata->width,
+ ImageDomainObjectAbstract::HEIGHT => $metadata->height,
+ ImageDomainObjectAbstract::AVG_COLOUR => $metadata->avg_colour,
+ ImageDomainObjectAbstract::LQIP_BASE64 => $metadata->lqip_base64,
+ ]);
+
+ return 'success';
+ } finally {
+ if ($imagick !== null) {
+ $imagick->clear();
+ $imagick->destroy();
+ }
+
+ if ($tempFile !== null && file_exists($tempFile)) {
+ unlink($tempFile);
+ }
+ }
+ }
+
+ private function extractMetadata(Imagick $imagick): ImageMetadataDTO
+ {
+ $width = $imagick->getImageWidth();
+ $height = $imagick->getImageHeight();
+ $avgColour = $this->extractAverageColour($imagick);
+ $lqipBase64 = $this->generateLqip($imagick);
+
+ return new ImageMetadataDTO(
+ width: $width,
+ height: $height,
+ avg_colour: $avgColour,
+ lqip_base64: $lqipBase64,
+ );
+ }
+
+ private function extractAverageColour(Imagick $imagick): string
+ {
+ $clone = clone $imagick;
+ $clone->resizeImage(1, 1, Imagick::FILTER_LANCZOS, 1);
+ $pixel = $clone->getImagePixelColor(0, 0);
+ $rgb = $pixel->getColor();
+ $clone->clear();
+ $clone->destroy();
+
+ return sprintf('#%02x%02x%02x', $rgb['r'], $rgb['g'], $rgb['b']);
+ }
+
+ private function generateLqip(Imagick $imagick): string
+ {
+ $clone = clone $imagick;
+
+ $width = $clone->getImageWidth();
+ $height = $clone->getImageHeight();
+
+ if ($width > $height) {
+ $newWidth = self::LQIP_MAX_DIMENSION;
+ $newHeight = (int)round($height * (self::LQIP_MAX_DIMENSION / $width));
+ } else {
+ $newHeight = self::LQIP_MAX_DIMENSION;
+ $newWidth = (int)round($width * (self::LQIP_MAX_DIMENSION / $height));
+ }
+
+ $newWidth = max(1, $newWidth);
+ $newHeight = max(1, $newHeight);
+
+ $clone->resizeImage($newWidth, $newHeight, Imagick::FILTER_LANCZOS, 1);
+ $clone->setImageFormat('webp');
+ $clone->setImageCompressionQuality(self::LQIP_QUALITY);
+ $clone->stripImage();
+
+ $blob = $clone->getImageBlob();
+ $clone->clear();
+ $clone->destroy();
+
+ return 'data:image/webp;base64,' . base64_encode($blob);
+ }
+
+ private function isImagickAvailable(): bool
+ {
+ return extension_loaded('imagick') && class_exists(Imagick::class);
+ }
+}
diff --git a/backend/app/DomainObjects/Generated/ImageDomainObjectAbstract.php b/backend/app/DomainObjects/Generated/ImageDomainObjectAbstract.php
index 60059c09b..f2d88a668 100644
--- a/backend/app/DomainObjects/Generated/ImageDomainObjectAbstract.php
+++ b/backend/app/DomainObjects/Generated/ImageDomainObjectAbstract.php
@@ -23,6 +23,10 @@ abstract class ImageDomainObjectAbstract extends \HiEvents\DomainObjects\Abstrac
final public const CREATED_AT = 'created_at';
final public const UPDATED_AT = 'updated_at';
final public const DELETED_AT = 'deleted_at';
+ final public const WIDTH = 'width';
+ final public const HEIGHT = 'height';
+ final public const AVG_COLOUR = 'avg_colour';
+ final public const LQIP_BASE64 = 'lqip_base64';
protected int $id;
protected ?int $account_id = null;
@@ -37,6 +41,10 @@ abstract class ImageDomainObjectAbstract extends \HiEvents\DomainObjects\Abstrac
protected ?string $created_at = 'CURRENT_TIMESTAMP';
protected ?string $updated_at = 'CURRENT_TIMESTAMP';
protected ?string $deleted_at = null;
+ protected ?int $width = null;
+ protected ?int $height = null;
+ protected ?string $avg_colour = null;
+ protected ?string $lqip_base64 = null;
public function toArray(): array
{
@@ -54,6 +62,10 @@ abstract class ImageDomainObjectAbstract extends \HiEvents\DomainObjects\Abstrac
'created_at' => $this->created_at ?? null,
'updated_at' => $this->updated_at ?? null,
'deleted_at' => $this->deleted_at ?? null,
+ 'width' => $this->width ?? null,
+ 'height' => $this->height ?? null,
+ 'avg_colour' => $this->avg_colour ?? null,
+ 'lqip_base64' => $this->lqip_base64 ?? null,
];
}
@@ -199,4 +211,48 @@ abstract class ImageDomainObjectAbstract extends \HiEvents\DomainObjects\Abstrac
{
return $this->deleted_at;
}
+
+ public function setWidth(?int $width): self
+ {
+ $this->width = $width;
+ return $this;
+ }
+
+ public function getWidth(): ?int
+ {
+ return $this->width;
+ }
+
+ public function setHeight(?int $height): self
+ {
+ $this->height = $height;
+ return $this;
+ }
+
+ public function getHeight(): ?int
+ {
+ return $this->height;
+ }
+
+ public function setAvgColour(?string $avg_colour): self
+ {
+ $this->avg_colour = $avg_colour;
+ return $this;
+ }
+
+ public function getAvgColour(): ?string
+ {
+ return $this->avg_colour;
+ }
+
+ public function setLqipBase64(?string $lqip_base64): self
+ {
+ $this->lqip_base64 = $lqip_base64;
+ return $this;
+ }
+
+ public function getLqipBase64(): ?string
+ {
+ return $this->lqip_base64;
+ }
}
diff --git a/backend/app/Resources/Image/ImageResource.php b/backend/app/Resources/Image/ImageResource.php
index 26c4cbaf5..244890e73 100644
--- a/backend/app/Resources/Image/ImageResource.php
+++ b/backend/app/Resources/Image/ImageResource.php
@@ -20,7 +20,11 @@ class ImageResource extends BaseResource
'size' => $this->getSize(),
'file_name' => $this->getFileName(),
'mime_type' => $this->getMimeType(),
- 'type' => $this->getType()
+ 'type' => $this->getType(),
+ 'width' => $this->getWidth(),
+ 'height' => $this->getHeight(),
+ 'avg_colour' => $this->getAvgColour(),
+ 'lqip_base64' => $this->getLqipBase64(),
];
}
}
diff --git a/backend/app/Services/Domain/Image/ImageUploadService.php b/backend/app/Services/Domain/Image/ImageUploadService.php
index 267080cf2..c7fcf6f0f 100644
--- a/backend/app/Services/Domain/Image/ImageUploadService.php
+++ b/backend/app/Services/Domain/Image/ImageUploadService.php
@@ -5,6 +5,7 @@ namespace HiEvents\Services\Domain\Image;
use HiEvents\DomainObjects\ImageDomainObject;
use HiEvents\Repository\Interfaces\ImageRepositoryInterface;
use HiEvents\Services\Infrastructure\Image\Exception\CouldNotUploadImageException;
+use HiEvents\Services\Infrastructure\Image\ImageMetadataService;
use HiEvents\Services\Infrastructure\Image\ImageStorageService;
use Illuminate\Http\UploadedFile;
@@ -12,9 +13,9 @@ class ImageUploadService
{
public function __construct(
private readonly ImageStorageService $imageStorageService,
- private readonly ImageRepositoryInterface $imageRepository
- )
- {
+ private readonly ImageRepositoryInterface $imageRepository,
+ private readonly ImageMetadataService $imageMetadataService,
+ ) {
}
/**
@@ -29,8 +30,9 @@ class ImageUploadService
): ImageDomainObject
{
$storedImage = $this->imageStorageService->store($image, $imageType);
+ $metadata = $this->imageMetadataService->extractMetadata($image);
- return $this->imageRepository->create([
+ $data = [
'account_id' => $accountId,
'entity_id' => $entityId,
'entity_type' => $entityType,
@@ -40,6 +42,15 @@ class ImageUploadService
'path' => $storedImage->path,
'size' => $storedImage->size,
'mime_type' => $storedImage->mime_type,
- ]);
+ ];
+
+ if ($metadata !== null) {
+ $data['width'] = $metadata->width;
+ $data['height'] = $metadata->height;
+ $data['avg_colour'] = $metadata->avg_colour;
+ $data['lqip_base64'] = $metadata->lqip_base64;
+ }
+
+ return $this->imageRepository->create($data);
}
}
diff --git a/backend/app/Services/Infrastructure/Image/DTO/ImageMetadataDTO.php b/backend/app/Services/Infrastructure/Image/DTO/ImageMetadataDTO.php
new file mode 100644
index 000000000..17bc7982f
--- /dev/null
+++ b/backend/app/Services/Infrastructure/Image/DTO/ImageMetadataDTO.php
@@ -0,0 +1,14 @@
+<?php
+
+namespace HiEvents\Services\Infrastructure\Image\DTO;
+
+readonly class ImageMetadataDTO
+{
+ public function __construct(
+ public int $width,
+ public int $height,
+ public string $avg_colour,
+ public string $lqip_base64,
+ ) {
+ }
+}
diff --git a/backend/app/Services/Infrastructure/Image/ImageMetadataService.php b/backend/app/Services/Infrastructure/Image/ImageMetadataService.php
new file mode 100644
index 000000000..ca6cbc67c
--- /dev/null
+++ b/backend/app/Services/Infrastructure/Image/ImageMetadataService.php
@@ -0,0 +1,96 @@
+<?php
+
+namespace HiEvents\Services\Infrastructure\Image;
+
+use HiEvents\Services\Infrastructure\Image\DTO\ImageMetadataDTO;
+use Illuminate\Http\UploadedFile;
+use Imagick;
+use Psr\Log\LoggerInterface;
+
+class ImageMetadataService
+{
+ private const LQIP_MAX_DIMENSION = 16;
+ private const LQIP_QUALITY = 60;
+
+ public function __construct(
+ private readonly LoggerInterface $logger,
+ ) {
+ }
+
+ public function extractMetadata(UploadedFile $image): ?ImageMetadataDTO
+ {
+ if (!$this->isImagickAvailable()) {
+ return null;
+ }
+
+ try {
+ $imagick = new Imagick($image->getRealPath());
+
+ $width = $imagick->getImageWidth();
+ $height = $imagick->getImageHeight();
+ $avgColour = $this->extractAverageColour($imagick);
+ $lqipBase64 = $this->generateLqip($imagick);
+
+ $imagick->clear();
+ $imagick->destroy();
+
+ return new ImageMetadataDTO(
+ width: $width,
+ height: $height,
+ avg_colour: $avgColour,
+ lqip_base64: $lqipBase64,
+ );
+ } catch (\Exception $e) {
+ $this->logger->warning('Failed to extract image metadata: ' . $e->getMessage());
+
+ return null;
+ }
+ }
+
+ private function isImagickAvailable(): bool
+ {
+ return extension_loaded('imagick') && class_exists(Imagick::class);
+ }
+
+ private function extractAverageColour(Imagick $imagick): string
+ {
+ $clone = clone $imagick;
+ $clone->resizeImage(1, 1, Imagick::FILTER_LANCZOS, 1);
+ $pixel = $clone->getImagePixelColor(0, 0);
+ $rgb = $pixel->getColor();
+ $clone->clear();
+ $clone->destroy();
+
+ return sprintf('#%02x%02x%02x', $rgb['r'], $rgb['g'], $rgb['b']);
+ }
+
+ private function generateLqip(Imagick $imagick): string
+ {
+ $clone = clone $imagick;
+
+ $width = $clone->getImageWidth();
+ $height = $clone->getImageHeight();
+
+ if ($width > $height) {
+ $newWidth = self::LQIP_MAX_DIMENSION;
+ $newHeight = (int) round($height * (self::LQIP_MAX_DIMENSION / $width));
+ } else {
+ $newHeight = self::LQIP_MAX_DIMENSION;
+ $newWidth = (int) round($width * (self::LQIP_MAX_DIMENSION / $height));
+ }
+
+ $newWidth = max(1, $newWidth);
+ $newHeight = max(1, $newHeight);
+
+ $clone->resizeImage($newWidth, $newHeight, Imagick::FILTER_LANCZOS, 1);
+ $clone->setImageFormat('webp');
+ $clone->setImageCompressionQuality(self::LQIP_QUALITY);
+ $clone->stripImage();
+
+ $blob = $clone->getImageBlob();
+ $clone->clear();
+ $clone->destroy();
+
+ return 'data:image/webp;base64,' . base64_encode($blob);
+ }
+}
diff --git a/backend/composer.json b/backend/composer.json
index bcb60aa74..55b0bb88f 100644
--- a/backend/composer.json
+++ b/backend/composer.json
@@ -30,6 +30,9 @@
"stripe/stripe-php": "^17.0",
"ext-xmlwriter": "*"
},
+ "suggest": {
+ "ext-imagick": "Required for image dimension extraction and LQIP generation"
+ },
"require-dev": {
"druc/laravel-langscanner": "dev-l12-compatibility",
"fakerphp/faker": "^1.9.1",
diff --git a/backend/database/migrations/2025_12_07_150927_add_image_metadata_columns_to_images_table.php b/backend/database/migrations/2025_12_07_150927_add_image_metadata_columns_to_images_table.php
new file mode 100644
index 000000000..084d77fb6
--- /dev/null
+++ b/backend/database/migrations/2025_12_07_150927_add_image_metadata_columns_to_images_table.php
@@ -0,0 +1,31 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+ /**
+ * Run the migrations.
+ */
+ public function up(): void
+ {
+ Schema::table('images', function (Blueprint $table) {
+ $table->unsignedInteger('width')->nullable()->after('mime_type');
+ $table->unsignedInteger('height')->nullable()->after('width');
+ $table->string('avg_colour', 7)->nullable()->after('height');
+ $table->text('lqip_base64')->nullable()->after('avg_colour');
+ });
+ }
+
+ /**
+ * Reverse the migrations.
+ */
+ public function down(): void
+ {
+ Schema::table('images', function (Blueprint $table) {
+ $table->dropColumn(['width', 'height', 'avg_colour', 'lqip_base64']);
+ });
+ }
+};
diff --git a/backend/tests/Unit/Services/Domain/Image/ImageUploadServiceTest.php b/backend/tests/Unit/Services/Domain/Image/ImageUploadServiceTest.php
index 4d684c3aa..9f8f4328b 100644
--- a/backend/tests/Unit/Services/Domain/Image/ImageUploadServiceTest.php
+++ b/backend/tests/Unit/Services/Domain/Image/ImageUploadServiceTest.php
@@ -5,8 +5,10 @@ namespace Tests\Unit\Services\Domain\Image;
use HiEvents\DomainObjects\ImageDomainObject;
use HiEvents\Repository\Interfaces\ImageRepositoryInterface;
use HiEvents\Services\Domain\Image\ImageUploadService;
+use HiEvents\Services\Infrastructure\Image\DTO\ImageMetadataDTO;
use HiEvents\Services\Infrastructure\Image\DTO\ImageStorageResponseDTO;
use HiEvents\Services\Infrastructure\Image\Exception\CouldNotUploadImageException;
+use HiEvents\Services\Infrastructure\Image\ImageMetadataService;
use HiEvents\Services\Infrastructure\Image\ImageStorageService;
use Illuminate\Http\UploadedFile;
use Mockery as m;
@@ -16,6 +18,7 @@ class ImageUploadServiceTest extends TestCase
{
private ImageStorageService $imageStorageService;
private ImageRepositoryInterface $imageRepository;
+ private ImageMetadataService $imageMetadataService;
private ImageUploadService $service;
protected function setUp(): void
@@ -24,14 +27,72 @@ class ImageUploadServiceTest extends TestCase
$this->imageStorageService = m::mock(ImageStorageService::class);
$this->imageRepository = m::mock(ImageRepositoryInterface::class);
+ $this->imageMetadataService = m::mock(ImageMetadataService::class);
$this->service = new ImageUploadService(
$this->imageStorageService,
- $this->imageRepository
+ $this->imageRepository,
+ $this->imageMetadataService
);
}
- public function testUploadSuccessfullyCreatesImageRecord(): void
+ public function testUploadSuccessfullyCreatesImageRecordWithMetadata(): void
+ {
+ $uploadedFile = m::mock(UploadedFile::class);
+ $storedImage = new ImageStorageResponseDTO(
+ filename: 'foo.jpg',
+ disk: 'public',
+ path: 'images/foo.jpg',
+ size: 123456,
+ mime_type: 'image/jpeg'
+ );
+ $metadata = new ImageMetadataDTO(
+ width: 800,
+ height: 600,
+ avg_colour: '#ff5500',
+ lqip_base64: 'data:image/webp;base64,abc123',
+ );
+ $imageDomainObject = m::mock(ImageDomainObject::class);
+ $accountId = 123;
+
+ $this->imageStorageService
+ ->shouldReceive('store')
+ ->once()
+ ->with($uploadedFile, 'profile')
+ ->andReturn($storedImage);
+
+ $this->imageMetadataService
+ ->shouldReceive('extractMetadata')
+ ->once()
+ ->with($uploadedFile)
+ ->andReturn($metadata);
+
+ $this->imageRepository
+ ->shouldReceive('create')
+ ->once()
+ ->with([
+ 'account_id' => $accountId,
+ 'entity_id' => 1,
+ 'entity_type' => 'user',
+ 'type' => 'profile',
+ 'filename' => 'foo.jpg',
+ 'disk' => 'public',
+ 'path' => 'images/foo.jpg',
+ 'size' => 123456,
+ 'mime_type' => 'image/jpeg',
+ 'width' => 800,
+ 'height' => 600,
+ 'avg_colour' => '#ff5500',
+ 'lqip_base64' => 'data:image/webp;base64,abc123',
+ ])
+ ->andReturn($imageDomainObject);
+
+ $result = $this->service->upload($uploadedFile, 1, 'user', 'profile', $accountId);
+
+ $this->assertSame($imageDomainObject, $result);
+ }
+
+ public function testUploadSuccessfullyCreatesImageRecordWithoutMetadata(): void
{
$uploadedFile = m::mock(UploadedFile::class);
$storedImage = new ImageStorageResponseDTO(
@@ -50,6 +111,12 @@ class ImageUploadServiceTest extends TestCase
->with($uploadedFile, 'profile')
->andReturn($storedImage);
+ $this->imageMetadataService
+ ->shouldReceive('extractMetadata')
+ ->once()
+ ->with($uploadedFile)
+ ->andReturn(null);
+
$this->imageRepository
->shouldReceive('create')
->once()
diff --git a/backend/tests/Unit/Services/Infrastructure/Image/ImageMetadataServiceTest.php b/backend/tests/Unit/Services/Infrastructure/Image/ImageMetadataServiceTest.php
new file mode 100644
index 000000000..884e72a22
--- /dev/null
+++ b/backend/tests/Unit/Services/Infrastructure/Image/ImageMetadataServiceTest.php
@@ -0,0 +1,95 @@
+<?php
+
+namespace Tests\Unit\Services\Infrastructure\Image;
+
+use HiEvents\Services\Infrastructure\Image\ImageMetadataService;
+use Illuminate\Http\UploadedFile;
+use Mockery as m;
+use PHPUnit\Framework\TestCase;
+use Psr\Log\LoggerInterface;
+
+class ImageMetadataServiceTest extends TestCase
+{
+ private LoggerInterface $logger;
+ private ImageMetadataService $service;
+
+ protected function setUp(): void
+ {
+ parent::setUp();
+
+ $this->logger = m::mock(LoggerInterface::class);
+ $this->service = new ImageMetadataService($this->logger);
+ }
+
+ public function testExtractMetadataReturnsNullWhenImagickNotAvailable(): void
+ {
+ if (extension_loaded('imagick')) {
+ $this->markTestSkipped('This test requires Imagick to NOT be installed');
+ }
+
+ $uploadedFile = m::mock(UploadedFile::class);
+
+ $result = $this->service->extractMetadata($uploadedFile);
+
+ $this->assertNull($result);
+ }
+
+ public function testExtractMetadataReturnsMetadataWhenImagickAvailable(): void
+ {
+ if (!extension_loaded('imagick')) {
+ $this->markTestSkipped('This test requires Imagick to be installed');
+ }
+
+ $testImagePath = $this->createTestImage();
+ $uploadedFile = new UploadedFile($testImagePath, 'test.png', 'image/png', null, true);
+
+ $result = $this->service->extractMetadata($uploadedFile);
+
+ $this->assertNotNull($result);
+ $this->assertEquals(100, $result->width);
+ $this->assertEquals(100, $result->height);
+ $this->assertMatchesRegularExpression('/^#[a-f0-9]{6}$/i', $result->avg_colour);
+ $this->assertStringStartsWith('data:image/webp;base64,', $result->lqip_base64);
+
+ unlink($testImagePath);
+ }
+
+ public function testExtractMetadataLogsWarningOnFailure(): void
+ {
+ if (!extension_loaded('imagick')) {
+ $this->markTestSkipped('This test requires Imagick to be installed');
+ }
+
+ $uploadedFile = m::mock(UploadedFile::class);
+ $uploadedFile->shouldReceive('getRealPath')
+ ->once()
+ ->andReturn('/nonexistent/path/to/image.png');
+
+ $this->logger->shouldReceive('warning')
+ ->once()
+ ->with(m::type('string'));
+
+ $result = $this->service->extractMetadata($uploadedFile);
+
+ $this->assertNull($result);
+ }
+
+ private function createTestImage(): string
+ {
+ $imagick = new \Imagick();
+ $imagick->newImage(100, 100, '#ff5500');
+ $imagick->setImageFormat('png');
+
+ $tempPath = sys_get_temp_dir() . '/test_image_' . uniqid() . '.png';
+ $imagick->writeImage($tempPath);
+ $imagick->destroy();
+
+ return $tempPath;
+ }
+
+ protected function tearDown(): void
+ {
+ m::close();
+ parent::tearDown();
+ }
+}
diff --git a/frontend/src/components/layouts/EventHomepage/EventHomepage.module.scss b/frontend/src/components/layouts/EventHomepage/EventHomepage.module.scss
index 565577164..5fd6b1822 100644
--- a/frontend/src/components/layouts/EventHomepage/EventHomepage.module.scss
+++ b/frontend/src/components/layouts/EventHomepage/EventHomepage.module.scss
@@ -134,17 +134,47 @@ $transition-slow: 0.4s cubic-bezier(0.4, 0, 0.2, 1);
width: 100%;
max-height: 560px;
overflow: hidden;
+ background-color: var(--accent-soft);
+
+ // When aspect ratio is provided via CSS custom property, use it
+ // Otherwise fall back to auto sizing based on image
+ &[style*="--cover-aspect-ratio"] {
+ aspect-ratio: var(--cover-aspect-ratio);
+ }
@include mixins.respond-below(md) {
max-height: 400px;
}
}
+.coverLqip {
+ position: absolute;
+ inset: 0;
+ width: 100%;
+ height: 100%;
+ object-fit: cover;
+ filter: blur(20px);
+ transform: scale(1.1);
+ z-index: 0;
+}
+
.coverImage {
width: 100%;
- height: auto;
display: block;
transition: transform $transition-slow;
+ z-index: 1;
+
+ // When wrapper has aspect ratio, image should fill it
+ .coverWrapper[style*="--cover-aspect-ratio"] & {
+ position: relative;
+ height: 100%;
+ object-fit: cover;
+ }
+
+ // When no aspect ratio, let image determine height naturally
+ .coverWrapper:not([style*="--cover-aspect-ratio"]) & {
+ height: auto;
+ }
.mainCard:hover & {
transform: scale(1.02);
diff --git a/frontend/src/components/layouts/EventHomepage/index.tsx b/frontend/src/components/layouts/EventHomepage/index.tsx
index 56f3659b4..8a29e6363 100644
--- a/frontend/src/components/layouts/EventHomepage/index.tsx
+++ b/frontend/src/components/layouts/EventHomepage/index.tsx
@@ -1,9 +1,9 @@
import classes from "./EventHomepage.module.scss";
import SelectProducts from "../../routes/product-widget/SelectProducts";
import "../../../styles/widget/default.scss";
-import {useEffect, useRef, useState} from "react";
+import React, {useEffect, useRef, useState} from "react";
import {EventDocumentHead} from "../../common/EventDocumentHead";
-import {eventCoverImageUrl, eventHomepageUrl, imageUrl, organizerHomepageUrl} from "../../../utilites/urlHelper.ts";
+import {eventCoverImage, eventHomepageUrl, imageUrl, organizerHomepageUrl} from "../../../utilites/urlHelper.ts";
import {Event, OrganizerStatus} from "../../../types.ts";
import {EventNotAvailable} from "./EventNotAvailable";
import {
@@ -110,7 +110,8 @@ const EventHomepage = ({...loaderData}: EventHomepageProps) => {
'--event-border-color': cssVars['--theme-border'],
} as React.CSSProperties;
- const coverImage = eventCoverImageUrl(event);
+ const coverImageData = eventCoverImage(event);
+ const coverImage = coverImageData?.url;
const organizer = event.organizer!;
const organizerSocials = organizer?.settings?.social_media_handles;
const organizerLogo = imageUrl('ORGANIZER_LOGO', organizer?.images);
@@ -209,7 +210,20 @@ const EventHomepage = ({...loaderData}: EventHomepageProps) => {
{/* Hero Section */}
<div className={classes.heroSection}>
{coverImage && (
- <div className={classes.coverWrapper}>
+ <div
+ className={classes.coverWrapper}
+ style={(coverImageData?.width && coverImageData?.height) ? {
+ '--cover-aspect-ratio': `${coverImageData.width} / ${coverImageData.height}`,
+ } as React.CSSProperties : undefined}
+ >
+ {coverImageData?.lqip_base64 && (
+ <img
+ src={coverImageData.lqip_base64}
+ alt=""
+ aria-hidden="true"
+ className={classes.coverLqip}
+ />
+ )}
<img
src={coverImage}
alt={event.title}
diff --git a/frontend/src/components/layouts/OrganizerHomepage/OrganizerHomepage.module.scss b/frontend/src/components/layouts/OrganizerHomepage/OrganizerHomepage.module.scss
index 0b629fa27..35807a524 100644
--- a/frontend/src/components/layouts/OrganizerHomepage/OrganizerHomepage.module.scss
+++ b/frontend/src/components/layouts/OrganizerHomepage/OrganizerHomepage.module.scss
@@ -127,19 +127,36 @@ $transition-slow: 0.4s cubic-bezier(0.4, 0, 0.2, 1);
.coverWrapper {
position: relative;
width: 100%;
- aspect-ratio: 2.5 / 1;
+ aspect-ratio: var(--cover-aspect-ratio, 2.5 / 1);
+ max-height: 400px;
overflow: hidden;
+ background-color: var(--accent-soft);
@include mixins.respond-below(md) {
- aspect-ratio: 16 / 10;
+ aspect-ratio: var(--cover-aspect-ratio, 16 / 10);
+ max-height: 300px;
}
}
+.coverLqip {
+ position: absolute;
+ inset: 0;
+ width: 100%;
+ height: 100%;
+ object-fit: cover;
+ filter: blur(20px);
+ transform: scale(1.1);
+ z-index: 0;
+}
+
.coverImage {
+ position: absolute;
+ inset: 0;
width: 100%;
height: 100%;
object-fit: cover;
transition: transform $transition-slow;
+ z-index: 1;
.heroSection:hover & {
transform: scale(1.02);
diff --git a/frontend/src/components/layouts/OrganizerHomepage/index.tsx b/frontend/src/components/layouts/OrganizerHomepage/index.tsx
index 02a89241a..8fde5ba47 100644
--- a/frontend/src/components/layouts/OrganizerHomepage/index.tsx
+++ b/frontend/src/components/layouts/OrganizerHomepage/index.tsx
@@ -148,7 +148,20 @@ export const OrganizerHomepage = ({
{/* Hero Section */}
<div className={classes.heroSection}>
{organizerCover && (
- <div className={classes.coverWrapper}>
+ <div
+ className={classes.coverWrapper}
+ style={organizerCover?.width && organizerCover?.height ? {
+ '--cover-aspect-ratio': `${organizerCover.width} / ${organizerCover.height}`,
+ } as React.CSSProperties : undefined}
+ >
+ {organizerCover?.lqip_base64 && (
+ <img
+ src={organizerCover.lqip_base64}
+ alt=""
+ aria-hidden="true"
+ className={classes.coverLqip}
+ />
+ )}
<img
src={organizerCover.url}
alt="Cover"
diff --git a/frontend/src/types.ts b/frontend/src/types.ts
index c07b2f93a..a1967cb93 100644
--- a/frontend/src/types.ts
+++ b/frontend/src/types.ts
@@ -160,6 +160,10 @@ export interface Image {
size: number;
mime_type: string;
type: ImageType;
+ width?: number | null;
+ height?: number | null;
+ avg_colour?: string | null;
+ lqip_base64?: string | null;
}
export type ImageType = 'EVENT_COVER' | 'EDITOR_IMAGE' | 'ORGANIZER_LOGO' | 'ORGANIZER_COVER' | 'ORGANIZER_IMAGE' | 'TICKET_LOGO';
diff --git a/frontend/src/utilites/urlHelper.ts b/frontend/src/utilites/urlHelper.ts
index e4e1f614c..b32ca77f8 100644
--- a/frontend/src/utilites/urlHelper.ts
+++ b/frontend/src/utilites/urlHelper.ts
@@ -29,6 +29,10 @@ export const eventCoverImageUrl = (event: Event) => {
return event?.images?.find((image) => image.type === 'EVENT_COVER')?.url;
}
+export const eventCoverImage = (event: Event): Image | undefined => {
+ return event?.images?.find((image) => image.type === 'EVENT_COVER');
+}
+
export const imageUrl = (imageType: ImageType, images?: Image[], fallbackUrl?: string) => {
if (!images || images.length === 0) {
return fallbackUrl || getConfig('VITE_DEFAULT_IMAGE_URL');