News

Laravel Media Package

Published
Laravel Media Package image

Laravel Media is a package by Jack Robertson for attaching files to eloquent models:

An easy solution to attach files to your eloquent models, with image manipulation built in!

This package works by handling file uploads via the package’s MediaUploader class. By default, the MediaUploader class will use the disk specified in the media configuration provided by the package. It saves the file as a sanitized version and creates a media record in the database.

Here’s a few examples from the readme of basic and customized usage of the MediaUploader class:

$file = $request->file('file');
 
// Default usage
$media = MediaUploader::fromFile($file)->upload();
 
// Custom usage
$media = MediaUploader::fromFile($file)
->useFileName('custom-file-name.jpeg')
->useName('Custom media name')
->upload();

Here’s an example from the readme of associating media with a model:

use Optix\Media\HasMedia;
 
class Post extends Model
{
use HasMedia;
}
 
 
$post = Post::first();
 
// To the default group
$post->attachMedia($media);
 
// To a custom group
$post->attachMedia($media, 'custom-group');

Further, you can register media conversions in a service provider and then perform those conversions on a model:

// In a service provider's boot() method...
Conversion::register('thumb', function (Image $image) {
return $image->fit(64, 64);
});
 
// Perform a conversion on a model
class Post extends Model
{
use HasMedia;
 
public function registerMediaGroups()
{
$this->addMediaGroup('gallery')
->performConversions('thumb');
}
}

You can learn more about this package, get full installation instructions, and view the source code on GitHub at optixsolutions/laravel-media.

Paul Redmond photo

Staff writer at Laravel News. Full stack web developer and author.

Filed in

Sponsored

masteringlaravel logo
Laravel Code Review

Get expert guidance in a few days with a Laravel code review

Visit Laravel Code Review

The latest

View all →
WhenMounted and BigInt Props in Inertia.js v3.8 image

WhenMounted and BigInt Props in Inertia.js v3.8

Read article
Postcodes for Laravel: GB Postcode Lookup and Geography Data image

Postcodes for Laravel: GB Postcode Lookup and Geography Data

Read article
Laravel 14 Adds a defaults() Method to Eloquent Models image

Laravel 14 Adds a defaults() Method to Eloquent Models

Read article
Laravel AI SDK and Laravel MCP Security Fixes: Update Now image

Laravel AI SDK and Laravel MCP Security Fixes: Update Now

Read article
Mailbox for Laravel: Preview and Test Rendered Email image

Mailbox for Laravel: Preview and Test Rendered Email

Read article
Count Worker Crashes as Job Exceptions in Laravel 13.34 image

Count Worker Crashes as Job Exceptions in Laravel 13.34

Read article