Installation & setup | laravel-medialibrary | Spatie SPATIE Laravel Media Library ======================== spatie.be/open-source [Docs](https://spatie.be/docs) [Laravel-medialibrary](https://spatie.be/docs/laravel-medialibrary/v3) Installation & setup Version v11 v10 v9 v8 v7 v6 v5 v4 v3 Other versions for crawler [v11](https://spatie.be/docs/laravel-medialibrary/v11) [v10](https://spatie.be/docs/laravel-medialibrary/v10) [v9](https://spatie.be/docs/laravel-medialibrary/v9) [v8](https://spatie.be/docs/laravel-medialibrary/v8) [v7](https://spatie.be/docs/laravel-medialibrary/v7) [v6](https://spatie.be/docs/laravel-medialibrary/v6) [v5](https://spatie.be/docs/laravel-medialibrary/v5) [v4](https://spatie.be/docs/laravel-medialibrary/v4) [v3](https://spatie.be/docs/laravel-medialibrary/v3) - [ Introduction ](https://spatie.be/docs/laravel-medialibrary/v3/introduction) - [ Postcardware ](https://spatie.be/docs/laravel-medialibrary/v3/postcardware) - [ Requirements ](https://spatie.be/docs/laravel-medialibrary/v3/requirements) - [ Installation & setup ](https://spatie.be/docs/laravel-medialibrary/v3/installation-setup) - [ Questions and issues ](https://spatie.be/docs/laravel-medialibrary/v3/questions-issues) - [ Changelog ](https://spatie.be/docs/laravel-medialibrary/v3/changelog) Basic usage ----------- - [ Preparing your model ](https://spatie.be/docs/laravel-medialibrary/v3/basic-usage/preparing-your-model) - [ Associating files ](https://spatie.be/docs/laravel-medialibrary/v3/basic-usage/associating-files) - [ Retrieving media ](https://spatie.be/docs/laravel-medialibrary/v3/basic-usage/retrieving-media) - [ Working with collections ](https://spatie.be/docs/laravel-medialibrary/v3/basic-usage/working-with-collections) Converting images ----------------- - [ Defining conversions ](https://spatie.be/docs/laravel-medialibrary/v3/converting-images/defining-conversions) - [ Retrieving converted images ](https://spatie.be/docs/laravel-medialibrary/v3/converting-images/retrieving-converted-images) - [ Regenerating images ](https://spatie.be/docs/laravel-medialibrary/v3/converting-images/regenerating-images) Advanced usage -------------- - [ Working with multiple filesystems ](https://spatie.be/docs/laravel-medialibrary/v3/advanced-usage/working-with-multiple-filesystems) - [ Storing media specific manipulations ](https://spatie.be/docs/laravel-medialibrary/v3/advanced-usage/storing-media-specific-manipulations) - [ Using your own model ](https://spatie.be/docs/laravel-medialibrary/v3/advanced-usage/using-your-own-model) - [ Using a custom directory structure ](https://spatie.be/docs/laravel-medialibrary/v3/advanced-usage/using-a-custom-directory-structure) - [ Consuming events ](https://spatie.be/docs/laravel-medialibrary/v3/advanced-usage/consuming-events) - [ Generating custom urls ](https://spatie.be/docs/laravel-medialibrary/v3/advanced-usage/generating-custom-urls) - [ Adding custom properties ](https://spatie.be/docs/laravel-medialibrary/v3/advanced-usage/adding-custom-properties) API --- - [ Adding files ](https://spatie.be/docs/laravel-medialibrary/v3/api/adding-files) - [ Defining conversions ](https://spatie.be/docs/laravel-medialibrary/v3/api/defining-conversions) 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 ` Installation & setup ======================== Medialibrary can be installed via composer: ``` $ composer require spatie/laravel-medialibrary ``` Next, you need to register the service provider: ``` // config/app.php 'providers' => [ ... Spatie\MediaLibrary\MediaLibraryServiceProvider::class, ]; ``` And publish and run the migration: ``` $ php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="migrations" $ php artisan migrate ``` Publishing the config file is optional: ``` php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="config" ``` The config file contains a number of default values: ``` 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 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', ], ]; ``` Finally you should add a disk to `app/config/filesystems.php`. All files added to the media library will be stored on that disk, this would be a typical configuration: ``` return [ ... 'disks' => [ 'media' => [ 'driver' => 'local', 'root' => public_path('media'), ], ... ]; ``` The package will add a .gitignore file to the directory where the media will be stored. Using another versioning sytem than git? Don't forget to ignore the directory of your media disk. If you are planning on working with image manipulations it's recommended to configure a queue on your service and specify it in the config file. Want to use S3? Then follow Laravel's instructions on [how to add the S3 Flysystem driver](http://laravel.com/docs/5.1/filesystem#configuration).