PHPackages dees040/laravel-medialibrary - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Image & Media](/categories/media) 4. / 5. dees040/laravel-medialibrary ActiveLibrary[Image & Media](/categories/media) dees040/laravel-medialibrary ============================ Associate files with Eloquent models 6.0.0(8y ago)021MITPHPPHP ^7.0 Since Apr 22Pushed 8y ago1 watchersCompare [ Source](https://github.com/dees040/laravel-medialibrary)[ Packagist](https://packagist.org/packages/dees040/laravel-medialibrary)[ Docs](https://github.com/spatie/laravel-medialibrary)[ RSS](/packages/dees040-laravel-medialibrary/feed)WikiDiscussions master Synced yesterday READMEChangelogDependencies (13)Versions (155)Used By (0) Associate files with Eloquent models ==================================== [](#associate-files-with-eloquent-models) [![Latest Version](https://camo.githubusercontent.com/e4e512a2a6f24ff4330e48f9b15191ddbf68e232c6d178a5de1fd23ce41676a1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f7370617469652f6c61726176656c2d6d656469616c6962726172792e7376673f7374796c653d666c61742d737175617265)](https://github.com/spatie/laravel-medialibrary/releases)[![Build Status](https://camo.githubusercontent.com/781a65c4ecb52c4b7da4d51b10180343fb87a7e7a92452f41ce86294c1f1dc9d/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f7370617469652f6c61726176656c2d6d656469616c6962726172792f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/spatie/laravel-medialibrary)[![Quality Score](https://camo.githubusercontent.com/11acfb465ead8ce20118d8fb4471597b92e2dd7c74bd6f99d264184536e3be44/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f7370617469652f6c61726176656c2d6d656469616c6962726172792e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/spatie/laravel-medialibrary)[![StyleCI](https://camo.githubusercontent.com/ef9d6024305ca902e2e369070888cc97fc69b2ea3a10ac9ba795e9d0c5185293/68747470733a2f2f7374796c6563692e696f2f7265706f732f33333931363835302f736869656c64)](https://styleci.io/repos/33916850)[![Total Downloads](https://camo.githubusercontent.com/03393070342eb3b7bf5a63fd48eefe709a09344144a82d73a0987889dcad75cd/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7370617469652f6c61726176656c2d6d656469616c6962726172792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/laravel-medialibrary) This Laravel >=5.4 package can associate all sorts of files with Eloquent models. It provides a simple API to work with. To learn all about it, head over to [the extensive documentation](https://docs.spatie.be/laravel-medialibrary/v5). Here are a few short examples of what you can do: ``` $newsItem = News::find(1); $newsItem->addMedia($pathToFile)->toMediaCollection('images'); ``` It can handle your uploads directly: ``` $newsItem->addMedia($request->file('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](https://laravel.com/docs/5.4/filesystem), so you can use any filesystem you like. Additionally the package can create image manipulations on images and pdfs that have been added in the medialibrary. Spatie is a webdesign agency in Antwerp, Belgium. You'll find an overview of all our open source projects [on our website](https://spatie.be/opensource). Documentation ------------- [](#documentation) You'll find the documentation on . Find yourself stuck using the package? Found a bug? Do you have general questions or suggestions for improving the media library? Feel free to [create an issue on GitHub](https://github.com/spatie/laravel-medialibrary/issues), we'll try to address it as soon as possible. If you've found a bug regarding security please mail instead of using the issue tracker. Requirements ------------ [](#requirements) To create derived images [GD](http://php.net/manual/en/book.image.php) should be installed on your server. For the creation of thumbnails of svg's or pdf's you should also install [Imagick](http://php.net/manual/en/imagick.setresolution.php). Postcardware ------------ [](#postcardware) You're free to use this package (it's [MIT-licensed](LICENSE.md)), but if it makes it to your production environment you are required to send us a postcard from your hometown, mentioning which of our package(s) you are using. Our address is: Spatie, Samberstraat 69D, 2060 Antwerp, Belgium. The best postcards will get published on the open source page on our website. Installation ------------ [](#installation) You can install this package via composer using this command: ``` composer require spatie/laravel-medialibrary:^5.0.0 ``` Next, you must install the service provider: ``` // config/app.php 'providers' => [ ... Spatie\MediaLibrary\MediaLibraryServiceProvider::class, ]; ``` You can publish the migration with: ``` php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="migrations" ``` After the migration has been published you can create the media-table by running the migrations: ``` php artisan migrate ``` You can publish the config-file with: ``` php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="config" ``` This is the contents of the published config file: ``` return [ /* * The filesystems on which to store added files and derived images by default. Choose * one or more of the filesystems you configured in app/config/filesystems.php */ 'defaultFilesystem' => 'media', /* * The maximum file size of an item in bytes. Adding a file * that is larger will result in an exception. */ 'max_file_size' => 1024 * 1024 * 10, /* * This queue will be used to generate derived images. * Leave empty to use the default queue. */ 'queue_name' => '', /* * The class name of the media model to be used. */ 'media_model' => Spatie\MediaLibrary\Media::class, /* * When urls to files get generated this class will be called. Leave empty * if your files are stored locally above the site root or on s3. */ 'custom_url_generator_class' => null, /* * The class that contains the strategy for determining a media file's path. */ 'custom_path_generator_class' => null, 's3' => [ /* * The domain that should be prepended when generating urls. */ 'domain' => 'https://xxxxxxx.s3.amazonaws.com', ], 'remote' => [ /* * Any extra headers that should be included when uploading media to * a remote disk. Even though supported headers may vary between * different drivers, a sensible default has been provided. * * Supported by S3: CacheControl, Expires, StorageClass, * ServerSideEncryption, Metadata, ACL, ContentEncoding */ 'extra_headers' => [ 'CacheControl' => 'max-age=604800', ], ], /* * The path where to store temporary files while performing image conversions. * If set to null, storage_path('medialibrary/temp') will be used. */ 'temporary_directory_path' => null, /* * FFMPEG & FFProbe binaries path, only used if you try to generate video * thumbnails and have installed the php-ffmpeg/php-ffmpeg composer * dependency. */ 'ffmpeg_binaries' => '/usr/bin/ffmpeg', 'ffprobe_binaries' => '/usr/bin/ffprobe', ]; ``` And finally you should add a disk to `app/config/filesystems.php`. This would be a typical configuration: ``` ... 'disks' => [ ... 'media' => [ 'driver' => 'local', 'root' => public_path().'/media', ], ... ``` All files of the medialibrary will be stored on that disk. If you are planning on working with the image manipulations you should configure a queue on your service with the name specified in the config file. Lumen Support ------------- [](#lumen-support) Lumen configuration is slightly more involved but features and API are identical to Laravel. Install using this command: ``` composer require spatie/laravel-medialibrary ``` Uncomment the following lines in the bootstrap file: ``` // bootstrap/app.php: $app->withFacades(); $app->withEloquent(); ``` Configure the laravel-medialibrary service provider (and `AppServiceProvider` if not already enabled): ``` // bootstrap/app.php: $app->register(App\Providers\AppServiceProvider::class); $app->register(Spatie\MediaLibrary\MediaLibraryServiceProvider::class); ``` Update the `AppServiceProvider` register method to bind the filesystem manager to the IOC container: ``` // app/Providers/AppServiceProvider.php public function register() { $this->app->singleton('filesystem', function ($app) { return $app->loadComponent('filesystems', 'Illuminate\Filesystem\FilesystemServiceProvider', 'filesystem'); }); $this->app->bind('Illuminate\Contracts\Filesystem\Factory', function($app) { return new \Illuminate\Filesystem\FilesystemManager($app); }); } ``` Manually copy the package config file to `app\config\laravel-medialibrary.php` (you may need to create the config directory if it does not already exist). Copy the [Laravel filesystem config file](https://github.com/laravel/laravel/blob/v5.4.15/config/filesystems.php) into `app\config\filesystem.php`. You should add a disk configuration to the filesystem config matching the `defaultFilesystem` specified in the laravel-medialibrary config file. Finally, update `boostrap/app.php` to load both config files: ``` // bootstrap/app.php $app->configure('medialibrary'); $app->configure('filesystems'); ``` Testing ------- [](#testing) You can run the tests with: ``` vendor/bin/phpunit ``` Upgrading --------- [](#upgrading) Please see [UPGRADING](UPGRADING.md) for details. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. Security -------- [](#security) If you discover any security related issues, please email instead of using the issue tracker. Credits ------- [](#credits) - [Freek Van der Herten](https://github.com/freekmurze) - [All Contributors](../../contributors) A big thank you to [Nicolas Beauvais](https://github.com/nicolasbeauvais) for helping out with the issues on this repo. Alternatives ------------ [](#alternatives) - [laravel-mediable](https://github.com/plank/laravel-mediable) - [laravel-stapler](https://github.com/CodeSleeve/laravel-stapler) - [media-manager](https://github.com/talvbansal/media-manager) About Spatie ------------ [](#about-spatie) Spatie is a webdesign agency in Antwerp, Belgium. You'll find an overview of all our open source projects [on our website](https://spatie.be/opensource). License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 33 — LowBetter than 72% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity6 Limited adoption so far Community20 Small or concentrated contributor base Maturity76 Established project with proven stability Bus Factor1 Top contributor holds 84.8% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~5 days Total 153 Last Release 3240d ago Major Versions 4.13.2 → 5.5.32017-03-15 4.13.4 → 5.6.02017-03-22 4.13.5 → 5.8.12017-03-30 v4.x-dev → 5.11.02017-05-10 5.13.2 → 6.0.02017-08-16 PHP version history (4 changes)0.1.0PHP >=5.4.0 2.0.0PHP >=5.5.0 3.12.0PHP ^5.5|^7.0 4.0.0PHP ^7.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/2b0064d818f9593dfb4f9d86217bbf5f14961ad6779b84fd5546dd91f296d898?d=identicon)[dees040](/maintainers/dees040) --- Top Contributors [![freekmurze](https://avatars.githubusercontent.com/u/483853?v=4)](https://github.com/freekmurze "freekmurze (827 commits)")[![sebastiandedeyne](https://avatars.githubusercontent.com/u/1561079?v=4)](https://github.com/sebastiandedeyne "sebastiandedeyne (62 commits)")[![MatthiasDeWinter](https://avatars.githubusercontent.com/u/8791525?v=4)](https://github.com/MatthiasDeWinter "MatthiasDeWinter (25 commits)")[![AlexVanderbist](https://avatars.githubusercontent.com/u/6287961?v=4)](https://github.com/AlexVanderbist "AlexVanderbist (17 commits)")[![arubacao](https://avatars.githubusercontent.com/u/7462542?v=4)](https://github.com/arubacao "arubacao (5 commits)")[![irazasyed](https://avatars.githubusercontent.com/u/1915268?v=4)](https://github.com/irazasyed "irazasyed (3 commits)")[![Rhincodon](https://avatars.githubusercontent.com/u/6630959?v=4)](https://github.com/Rhincodon "Rhincodon (3 commits)")[![antonkomarev](https://avatars.githubusercontent.com/u/1849174?v=4)](https://github.com/antonkomarev "antonkomarev (3 commits)")[![canvural](https://avatars.githubusercontent.com/u/1574232?v=4)](https://github.com/canvural "canvural (3 commits)")[![coding-sunshine](https://avatars.githubusercontent.com/u/3206025?v=4)](https://github.com/coding-sunshine "coding-sunshine (3 commits)")[![MarceauKa](https://avatars.githubusercontent.com/u/1665333?v=4)](https://github.com/MarceauKa "MarceauKa (2 commits)")[![amosmos](https://avatars.githubusercontent.com/u/2318695?v=4)](https://github.com/amosmos "amosmos (2 commits)")[![bstrahija](https://avatars.githubusercontent.com/u/125499?v=4)](https://github.com/bstrahija "bstrahija (2 commits)")[![faustbrian](https://avatars.githubusercontent.com/u/22145591?v=4)](https://github.com/faustbrian "faustbrian (2 commits)")[![kduma](https://avatars.githubusercontent.com/u/1062582?v=4)](https://github.com/kduma "kduma (1 commits)")[![ethaizone](https://avatars.githubusercontent.com/u/1168777?v=4)](https://github.com/ethaizone "ethaizone (1 commits)")[![markvaneijk](https://avatars.githubusercontent.com/u/1925388?v=4)](https://github.com/markvaneijk "markvaneijk (1 commits)")[![dees040](https://avatars.githubusercontent.com/u/5390555?v=4)](https://github.com/dees040 "dees040 (1 commits)")[![Maxeee09](https://avatars.githubusercontent.com/u/6651496?v=4)](https://github.com/Maxeee09 "Maxeee09 (1 commits)")[![mintbridge](https://avatars.githubusercontent.com/u/32777?v=4)](https://github.com/mintbridge "mintbridge (1 commits)") --- Tags spatielaravelconversionimagesmediacmsdownloadslaravel-medialibrary ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/dees040-laravel-medialibrary/health.svg) ``` [![Health](https://phpackages.com/badges/dees040-laravel-medialibrary/health.svg)](https://phpackages.com/packages/dees040-laravel-medialibrary) ``` ### Alternatives [spatie/laravel-medialibrary Associate files with Eloquent models 6.1k41.3M604](/packages/spatie-laravel-medialibrary) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)