Laravel Media Package

Laravel Media Package

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)
    ->useName('Custom media name')

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

// 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()

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

Filed in: News


Join 31,000+ others and never miss out on new tips, tutorials, and more.

Laravel News Partners

Laravel Jobs

Senior Fullstack Developer / Architect (w/m/d)
Remote / Munich - Germany GmbH
Medior full stack developer (Laravel)
Deventer (or remote) in the Netherlands, Dutch speaking required.
Senior Full Stack PHP Developer (Laravel)
Senior Laravel Developer
Senior Full-Stack Engineer