Laravel Media Package


July 16th, 2019

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:

Paul Redmond

Full stack web developer. Author of Lumen Programming Guide and Docker for PHP Developers.