You are viewing the documentation for an older version of this package. You can check the version you are using with the following command:

composer show spatie/laravel-medialibrary

Laravel-medialibrary

Associate files with Eloquent models.

Useful links

Introduction

On this page

  1. We have badges!

Medialibrary is a Laravel (5.4 and up) package that can associate all sorts of files with Eloquent models. It provides a simple, fluent API to work with. Here's a quick example:

$newsItem = News::find(1);
$newsItem->addMedia($pathToFile)->toMediaCollection('images');

It can also directly handle your uploads:

$newsItem->addMediaFromRequest('image')->toMediaCollection('images');

Want to store some large files on another filesystem? No problem:

$newsItem->addMedia($smallFile)->toMediaCollection('downloads', 'local');
$newsItem->addMedia($bigFile)->toMediaCollection('downloads', 's3');

The storage of the files is handled by Laravel's Filesystem, so you can plug in any compatible filesystem.

The package can also generate derived images such as thumbnails for images, video's and pdf's. Once you've set up your model, they're easily accessible:

$newsItem->getMedia('images')->first()->getUrl('thumb');
Latest Version Software License Build Status SensioLabsInsight Quality Score Total Downloads
About us
Postcardware
Help us improve this page