Media Module — File Storage & Transformation

Last updated: 2026-07-28

Complete media management for the Laraxot ecosystem: image optimization, video encoding, FFmpeg integration, and cloud storage (S3/CloudFront).

Why This Module

• Unified file handling — Consistent API for uploads, validation, and storage across all modules
• FFmpeg integration — Professional-grade video encoding with automatic quality presets
• Image optimization — Intervention Image transforms with smart caching strategy
• Cloud-native — Built-in S3/CloudFront support with fallback to local storage
• Filament admin UI — Media library, bulk operations, batch processing
• Battle-tested conventions — Laraxot best practices embedded from day one

Key Features

File Upload & Storage

• Temporary upload handling with session tracking
• Automatic validation (MIME type, size, extensions)
• Multiple disk support (local, S3, Minio, CloudFront)
• Atomic attachment operations

Image Processing

• Intervention Image transforms (resize, crop, optimize)
• Automatic format conversion (WebP, AVIF fallback)
• Smart thumbnail generation
• EXIF data preservation & sanitization

Video Encoding

• FFmpeg conversion pipeline (MP4, WebM, HLS)
• Subtitle generation & embedding
• Frame extraction for thumbnails
• Adaptive bitrate streaming preparation

Cloud Integration

• AWS S3 native support
• CloudFront URL signing for private content
• Minio compatibility for self-hosted deployments
• Automatic CDN invalidation

Dependencies

Composer packages:

• pbmedia/laravel-ffmpeg:^8.7 — Video processing
• intervention/image:^3.0 — Image transformation
• laravel/framework:^11.0 — Laravel framework
• spatie/laravel-queueable-action — Async actions

System packages (required):

• ffmpeg — Video encoding engine
• imagemagick or gd — Image processing library

Documentation

Start here:

1. Documentation Index — Navigation & file guide
2. Architecture — System design & patterns
3. Patterns & Best Practices — Common patterns & anti-patterns
4. Troubleshooting — Error resolution

Deep dives:

• API Documentation — Action signatures & contracts
• FFmpeg Integration — Video encoding guide
• Components — Intervention Image, Storage strategies

Operations:

• Performance Optimization — Tuning guide
• Migration Guide — Database upgrades
• Testing Guidelines — Test strategies

Release & Automation

• Semantic Release: Workflow
• Configuration: .releaserc.json
• Changelog: CHANGELOG.md

Philosophy

Scopo prima del codice — Every class serves a specific use case.
DRY prima dell'orgoglio — Reuse patterns established in Laraxot.
KISS prima dell'astrazione — Simple, verifiable code over clever frameworks.

---

Quick links: Index | Patterns | Troubleshooting | Contributing