cesurapp/media-bundle

Symfony Media Bundle

1.2.8 2026-01-23 23:41 UTC

Requires

• php: >=8.4
• ext-fileinfo: *
• ext-gd: *
• cesurapp/storage-bundle: ^1.2
• claviska/simpleimage: ^4.2
• doctrine/doctrine-bundle: ^3.1.0
• doctrine/orm: ^3.5.0
• symfony/console: ^8.0
• symfony/dependency-injection: ^8.0
• symfony/framework-bundle: ^8.0
• symfony/http-kernel: ^8.0
• symfony/mime: ^8.0
• symfony/uid: ^8.0
• symfony/validator: ^8.0

Requires (Dev)

• php-cs-fixer/shim: ^v3.91.3
• phpstan/phpstan: ^2.1.33
• phpunit/phpunit: ^12.5
• zenstruck/foundry: ^2.8.1

MIT

• Cesur APAYDIN

• symfony
• media-bundle

README

Media management bundle for Symfony with automatic storage integration and reference counting.

Features:

• Automatic file tracking with reference counting
• Auto-cleanup when media is deleted or unused
• Image compression, resizing, and format conversion
• Multiple upload methods (HTTP, Base64, URL)
• Support for multiple media columns per entity
• Built on top of cesurapp/storage-bundle

Installation

Requirements:

• PHP 8.4+
• Symfony 8.0+

composer require cesurapp/media-bundle

Quick Start

1. Add Media Column to Entity

use Cesurapp\MediaBundle\Entity\{MediaInterface,Traits\MediaTrait};

class User implements MediaInterface
{
    use MediaTrait;

    // For single column, getMediaColumns() is optional
    // For multiple columns, override:
    public function getMediaColumns(): array
    {
        return ['media', 'avatar'];
    }
}

Note: Copy and rename MediaTrait for each additional media column (e.g., LogoTrait, AvatarTrait).

2. Upload Media

use Cesurapp\MediaBundle\Manager\MediaManager;
use Symfony\Component\HttpFoundation\Request;

class UploadController
{
    public function upload(Request $request, MediaManager $manager): void
    {
        // Configure image processing
        $medias = $manager
            ->setImageCompress(true)        // Enable compression
            ->setImageConvertJPG(true)      // Convert PNG/JPEG to JPG
            ->setImageQuality(75)           // JPEG quality (0-100)
            ->setImageSize(1280, 720)       // Max dimensions (aspect ratio preserved)
            ->uploadFile($request);         // Upload HTTP files

        // Attach to entity
        $user->addMedias($medias);
    }
}

3. Upload Methods

// HTTP file upload
$medias = $manager->uploadFile($request, ['avatar', 'photos']);

// Base64 upload with MIME validation
$medias = $manager->uploadBase64(
    $request,
    ['image'],
    ['image' => ['image/png', 'image/jpeg']]
);

// Remote URL download
$medias = $manager->uploadLink(
    $request,
    ['imageUrl'],
    ['imageUrl' => ['image/png']]
);

// Direct content creation
$media = $manager->createMedia('image/png', 'png', $content, strlen($content));

4. Access Media

// Get all media
$allMedia = $user->getMedia();

// Get first media
$firstMedia = $user->getMedia()[0] ?? null;

// Using helper method (available in LogoTrait, etc.)
$logo = $user->getLogoFirst();

// Serve as HTTP response
return $media->getResponse($storage);

// Get file content
$content = $media->getContent($storage);

// Get file path
$path = $media->getPath(); // e.g., "2025/01/20/01hmz3k4.jpg"

5. Delete Media

// Manual deletion
$em->remove($media);
$em->flush(); // File automatically deleted from storage

// Remove from entity (auto-cleanup via counter)
$user->removeMedia($media);
$em->flush(); // Media deleted if no other references

// Entity deletion (cascading cleanup)
$em->remove($user);
$em->flush(); // All associated media auto-deleted when counter reaches 0

Commands

# View media storage statistics
bin/console media:status

Documentation

For detailed usage, see GUIDELINES.md