voerro/laravel-file-uploader

A small helper class for easier file and image uploading in Laravel

Laravel File Uploader

, _(*1)

A very simple helper class that makes these tasks a walk in the park: - replacing an old/existing file with a new one - downsizing an image on upload - deleting a file from a storage - determining if a file is an image, _(*2)

Installation

Via composer:, _(*3)

composer require voerro/laravel-file-uploader

For Laravel Below 5.5

Add the FileUploaderServiceProvider to the providers array of your config/app.php configuration file:, _(*4)

Voerro\FileUploader\FileUploaderServiceProvider::class,

Then add the Facade to the aliases array:, _(*5)

'FileUploader' => Voerro\FileUploader\FileUploaderFacade::class,

Basic Usage

Import the FileUploader class like this:, _(*6)

use Voerro\FileUploader\FileUploader;

Pass the uploaded file (an Illuminate\Http\UploadedFile) instance to the make method, then chain the upload method, which will return the path to the newly stored file., _(*7)

$path = FileUploader::make($file)->upload();

Methods

Static methods

Initialization:, _(*8)

::make(Illuminate\Http\UploadedFile $file)

Deleting a file (the method checks if the file exists to eliminate possible errors):, _(*9)

::delete(string $filePath, string $storage = 'public')

Determine if a file is an image. Pass to the method an UploadedFile instance or a string with a path to the file:, _(*10)

::isImage($file, $storage = 'public')

The following methods should be chained after the make method.

->upload(string $path = '', string $storage = 'public')

Upload file under a specified name:, _(*11)

->uploadAs(string $filename, string $path = '', string $storage = 'public')

Replace an old file:, _(*12)

->replace(string $oldFilePath, string $path = '', string $storage = 'public')

Replace an old file, store the new file under a specified name:, _(*13)

->replaceAs(string $oldFilePath, string $newFilename, string $path = '', string $storage = 'public')

Downsize an image if it's bigger than the specified width and/or height (the aspect ratio will be saved). When called on a non-image file nothing would be happen, thus you don't need to manually check if the file is an image before deciding wether to call this method., _(*14)

->downsize(integer $maxWidth, integer $maxHeight)

Crop and resize an image to fit the the specified dimensions (the same as ->fit() from Intervention Image), _(*15)

->fit(integer $width, integer $height, boolean $dontUpsize = false)

Call this method before calling any of the above methods, for example:, _(*16)

FileUploader::make($image)->downsize(200, 200)->replace('old_image_file.jpg');

License

This is open-sourced software licensed under the MIT license., _(*17)