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 the weekly newsletter and never miss out on new tips, tutorials, and more.

Laravel News Partners

Laravel Jobs

Laravel Developer
San Jose, CA
X3 Builders
Lead Front End Developer
Full-Stack Laravel Developer
Revive Interior
Intermediate PHP Developer (Full Stack | CakePHP | Laravel | Vue | jQuery)
Senior PHP Developer (Full Stack | CakePHP | Laravel | Vue | jQuery)
Laravel Developer
Amsterdam (partially remote possible)
Let's Book
Web Developer (Laravel)
Tweed Heads, New South Wales, AUSTRALIA
Tursa Employment & Training