PHPackages                             voerro/laravel-file-uploader - 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. [File & Storage](/categories/file-storage)
4. /
5. voerro/laravel-file-uploader

AbandonedLibrary[File & Storage](/categories/file-storage)

voerro/laravel-file-uploader
============================

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

v1.2.0(6y ago)31302MITPHPPHP ^7.0CI failing

Since Dec 7Pushed 6y ago1 watchersCompare

[ Source](https://github.com/voerro/laravel-file-uploader)[ Packagist](https://packagist.org/packages/voerro/laravel-file-uploader)[ RSS](/packages/voerro-laravel-file-uploader/feed)WikiDiscussions master Synced yesterday

READMEChangelog (6)Dependencies (5)Versions (7)Used By (0)

Laravel File Uploader
=====================

[](#laravel-file-uploader)

[![Packagist](https://camo.githubusercontent.com/00d2280277a90c63f3845c6361ef1475f365de89930a0823729e42b8da79c25a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f766f6572726f2f6c61726176656c2d66696c652d75706c6f616465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/voerro/laravel-file-uploader) [![Packagist](https://camo.githubusercontent.com/b5b926238b3d215a6005dcc8e56ebbb06a472e6d433ece0a968611b2213c63b8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f766f6572726f2f6c61726176656c2d66696c652d75706c6f616465722e7376673f7374796c653d666c61742d737175617265)](https://opensource.org/licenses/MIT)

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

[](#installation)

Via composer:

```
composer require voerro/laravel-file-uploader

```

#### For Laravel Below 5.5

[](#for-laravel-below-55)

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

[](#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
-------

[](#methods)

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

[](#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
-------

[](#license)

This is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT).

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 86.7% 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 ~157 days

Recently: every ~197 days

Total

6

Last Release

2290d ago

PHP version history (2 changes)v1.0PHP >=7.0

v1.2.0PHP ^7.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/9262f3a0b6d6f98f4be06bec28d16f70290a1a7a5d05d07ffa5c5432a4521c17?d=identicon)[AlexMordred](/maintainers/AlexMordred)

---

Top Contributors

[![AlexMordred](https://avatars.githubusercontent.com/u/8043551?v=4)](https://github.com/AlexMordred "AlexMordred (26 commits)")[![AD-Soft](https://avatars.githubusercontent.com/u/7234817?v=4)](https://github.com/AD-Soft "AD-Soft (3 commits)")[![Dylan-DPC](https://avatars.githubusercontent.com/u/99973273?v=4)](https://github.com/Dylan-DPC "Dylan-DPC (1 commits)")

---

Tags

laravel

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/voerro-laravel-file-uploader/health.svg)

```
[![Health](https://phpackages.com/badges/voerro-laravel-file-uploader/health.svg)](https://phpackages.com/packages/voerro-laravel-file-uploader)
```

###  Alternatives

[unisharp/laravel-filemanager

A file upload/editor intended for use with Laravel 5 to 10 and CKEditor / TinyMCE

2.2k3.3M74](/packages/unisharp-laravel-filemanager)[intervention/image-laravel

Laravel Integration of Intervention Image

1496.5M102](/packages/intervention-image-laravel)[beyondcode/laravel-favicon

Create dynamic favicons based on your environment settings.

37345.5k](/packages/beyondcode-laravel-favicon)[farhanshares/laravel-mediaman

MediaMan - The most elegant & powerful media management package for Laravel!

293.7k](/packages/farhanshares-laravel-mediaman)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)