voerro/laravel-file-uploader

This package is abandoned and no longer maintained. No replacement package was suggested.

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

v1.2.0 2020-02-04 11:39 UTC

This package is auto-updated.

Last update: 2021-02-24 07:53:32 UTC


README

Packagist Packagist

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

Installation

Via composer:

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:

Voerro\FileUploader\FileUploaderServiceProvider::class,

Then add the Facade to the aliases array:

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

Basic Usage

Import the FileUploader class like this:

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.

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

Methods

Static methods

Initialization:

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

Deleting a file (the method checks if the file exists to eliminate possible errors):

::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:

::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:

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

Replace an old file:

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

Replace an old file, store the new file under a specified name:

->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.

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

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

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

Call this method before calling any of the above methods, for example:

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

License

This is open-sourced software licensed under the MIT license.