survos/media-bundle

Manage media without direct relationships

2.0.106 2026-01-14 11:10 UTC

Requires

• php: ^8.4
• doctrine/dbal: ^4.3.2
• doctrine/doctrine-bundle: ^2.7|^3.0
• mperonnet/imgproxy-php: ^1.0
• onliner/imgproxy-php: ^0.2
• symfony/config: ^7.3||^8.0
• symfony/dependency-injection: ^7.3||^8.0
• symfony/http-kernel: ^7.3||^8.0
• twig/twig: ^3.4

Requires (Dev)

• nyholm/psr7: ^1.8
• openai-php/client: ^0.16.1
• phpstan/phpstan: ^2.0
• symfony/browser-kit: ^7.3||^8.0
• symfony/framework-bundle: ^7.3||^8.0
• symfony/http-client: ^7.3||^8.0
• symfony/phpunit-bridge: ^7.3||^8.0
• symfony/twig-bundle: ^7.3||^8.0
• symfony/var-dumper: ^7.3||^8.0

MIT

• symfony
• symfony-ux

README

SurvosMediaBundle provides a deterministic, URL‑centric media registry for Symfony applications.

It is intentionally not a media processor. Instead, it:

• Registers media references (URLs or local files)
• Assigns deterministic IDs derived from URLs
• Stores application‑local media metadata
• Syncs with a centralized media server (future step)
• Generates thumbnail URLs via imgproxy‑style patterns (future step)

This mirrors the relationship between babel‑bundle and lingua‑server:

• Applications own their media tables
• A central service owns the binaries and heavy processing

Core Concept: Deterministic Media IDs

Every media item has a stable, deterministic ID derived from its URL.

use Survos\MediaBundle\Service\MediaRegistry;

$id = MediaRegistry::idFromUrl('https://example.com/image.jpg');

The algorithm:

• Base64‑encodes the URL
• Converts it to URL‑safe base64
• Removes padding

This is the same philosophy used by imgproxy.

Why this matters

• No database lookups to resolve URLs
• IDs are reversible
• Same URL → same ID across apps
• Safe primary key for Meilisearch

Registering Media

The primary entry point is MediaRegistry.

foreach ($data->images as $imageUrl) {
    $media = $mediaRegistry->ensureMedia($imageUrl);
}

Behavior

• Defaults to Photo
• No duplicate URLs
• Bulk‑safe (flush: false)
• No network calls

Local files are also supported:

$media = $mediaRegistry->ensureMedia($uploadedFile);

Local files are assigned a temporary local:// URL until synced.

What This Bundle Does Not Do

• Download media
• Resize images
• Cache thumbnails
• Perform OCR, tagging, or EXIF extraction

Those responsibilities belong to the media server and imgproxy.

Status

This bundle is intentionally minimal and evolving.

Next steps include:

• media:sync command
• Provider detection (YouTube, Flickr, etc.)
• Thumbnail URL generation helpers