devfactory/media

Laravel package for saving uploaded files and linking them with models

Media

This package saves uploaded files and links them with models, _(*1)

Installation

Laravel 5

NOTE: If upgrading from 2.0.0, run php artisan vendor:publish and php artisan migrate, _(*2)

Using Composer, edit your composer.json file to require devfactory/media., _(*3)

"require": {
  "devfactory/media": "2.0.*"
}

Then from the terminal run, _(*4)

composer update

Then in your app/config/app.php file register the service providers:, _(*5)

'Devfactory\Media\MediaServiceProvider',
'That0n3guy\Transliteration\TransliterationServiceProvider',

From within the laravel folder of your project, run:, _(*6)

php artisan vendor:publish

Followed by:, _(*7)

php artisan migrate

Laravel 4

Using Composer, edit your composer.json file to require devfactory/media., _(*8)

"require": {
  "devfactory/media": "1.0.*"
}

Then from the terminal run, _(*9)

composer update

Then in your app/config/app.php file register the service providers:, _(*10)

'Devfactory\Media\MediaServiceProvider',
'That0n3guy\Transliteration\TransliterationServiceProvider',

Run the migration to create the DB table:, _(*11)

php artisan migrate --package=devfactory/media

Finally, publish the config to make changes to where and how the files are stored:, _(*12)

php artisan config:publish devfactory/media

Usage

To use the package, you need to add the following to any of your models which will be receiving media uploads., _(*13)

<?php

class User extends Eloquent {

  use \Devfactory\Media\MediaTrait;

);

Then to save a media, in the method that handles your form submission you just need to pass the File object to saveMedia():, _(*14)

public function upload() {
  $user = User::firstOrCreate(['id' => 1]);

  if (Input::hasFile('image')) {
    $user->saveMedia(Input::file('image'));
  }

  return Redirect::route('route');
}

This will create the file on the file system and insert an entry into the DB table media., _(*15)

If you need to set multiple different types of images on a Model, like the users' profile picture and a background for their page you can use the second parameter:, _(*16)

$user->saveMedia(Input::file('profile_picture'), 'profile_picture');
$user->saveMedia(Input::file('background_image'), 'background_image');

To retrieve the images again, you just need to call getMedia():, _(*17)

// Retrieves every Media linked with the user
$all_media = $user->getMedia();

// Retrieve a specific Media
$profile_picture = $user->getMedia('profile_picture');

Finally you can delete media with deleteMedia():, _(*18)

// Delete all media for a user
$user->deleteMedia();

// Delete specific media
$user->deleteMedia('profile_picture');