PHPackages                             jenky/laravel-plupload - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. jenky/laravel-plupload

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

jenky/laravel-plupload
======================

Plupload package for Laravel 5

3.0.1(6y ago)2919.5k10[3 issues](https://github.com/jenky/laravel-plupload/issues)[3 PRs](https://github.com/jenky/laravel-plupload/pulls)MITPHPPHP &gt;=5.5.9

Since Apr 7Pushed 5y ago2 watchersCompare

[ Source](https://github.com/jenky/laravel-plupload)[ Packagist](https://packagist.org/packages/jenky/laravel-plupload)[ RSS](/packages/jenky-laravel-plupload/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (2)Versions (23)Used By (0)

Laravel 5 Plupload
==================

[](#laravel-5-plupload)

[![Latest Stable Version](https://camo.githubusercontent.com/9abe033786115972c695db69fbf902ef3d0f3bd348ff694c24b8323426c6f10a/68747470733a2f2f706f7365722e707567782e6f72672f6a656e6b792f6c61726176656c2d706c75706c6f61642f762f737461626c652e737667)](https://packagist.org/packages/jenky/laravel-plupload)[![Total Downloads](https://camo.githubusercontent.com/e8b9a70b3e1c6358835f806f0d2de8e16cbf87fc28c89afb30b571aa8b48fda0/68747470733a2f2f706f7365722e707567782e6f72672f6a656e6b792f6c61726176656c2d706c75706c6f61642f642f746f74616c2e737667)](https://packagist.org/packages/jenky/laravel-plupload)[![License](https://camo.githubusercontent.com/465937214f6b7575bfda43b1b0d426f4564e7029ac6d7137d7d68a4e973558e5/68747470733a2f2f706f7365722e707567782e6f72672f6a656e6b792f6c61726176656c2d706c75706c6f61642f6c6963656e73652e737667)](https://packagist.org/packages/jenky/laravel-plupload)

##### Laravel package for Plupload .

[](#laravel-package-for-plupload-httppluploadcom)

This package uses some parts of

Installation
------------

[](#installation)

Require this package with composer:

```
composer require jenky/laravel-plupload

```

Laravel 5.5+ uses Package Auto-Discovery, so doesn't require you to manually add the ServiceProvider.

**For Laravel 5.4 or older**

Add the ServiceProvider to the providers array in `config/app.php`

```
Jenky\LaravelPlupload\PluploadServiceProvider::class,
```

and add this to your facades in `config/app.php`:

```
'Plupload' => Jenky\LaravelPlupload\Facades\Plupload::class,
```

Copy the package config to your local config with the publish command:

```
php artisan vendor:publish

```

or

```
php artisan vendor:publish --provider="Jenky\LaravelPlupload\PluploadServiceProvider"

```

Usage
-----

[](#usage)

### Uploading files

[](#uploading-files)

##### 1. Use default plupload html

[](#1-use-default-plupload-html)

Use the [examples](http://www.plupload.com/examples) found on the plupload site. The [Getting Started](http://plupload.com/docs/Getting-Started) page is good place to start.

##### 2. Plupload builder

[](#2-plupload-builder)

**make($id, $url)**

Create new uploader.

- **$id**: the unique identification for the uploader.
- **$url**: the upload url end point.

```
{!! Plupload::make('my_uploader_id', route('photos.store'))->render() !!}
```

or use the helper

```
{!! plupload()->make('my_uploader_id', route('photos.store')) !!}
// or even shorter
{!! plupload('my_uploader_id', route('photos.store')) !!}
```

**render($view = 'plupload::uploader', array $data = \[\])**

Renders the uploader. You can customize this by passing a view name and it's data. From version `2.0`, you can omit the `render` method in the builder if you don't want to set the view or extra data.

##### 3. Use package js file to initialize Plupload (Optional)

[](#3-use-package-js-file-to-initialize-plupload-optional)

If you do not want to write your own js to initialize Plupload, you can use the `upload.js` file that included with the package in `resources/views/vendor/plupload/assets/js`. Make sure that you already have `jQuery` loaded on your page.

**Initialize Plupload**

```

$(function () {
    createUploader('my_uploader_id'); // The Id that you used to create with the builder
});

```

These following methods are useable with the `upload.js` file.

**Set Uploader options**

**setOptions(array $options)**

Set uploader options. Please visit  to see all the options. You can set the default global options in `config/plupload.php`

```
{!! plupload('my_uploader_id', route('photos.store'))
    ->setOptions([
        'filters' => [
            'max_file_size' => '2mb',
            'mime_types' => [
                ['title' => 'Image files', 'extensions' => 'jpg,gif,png'],
            ],
        ],
    ]) !!}
```

**Automatically start upload when files added**

Use `setAutoStart()` in your builder before calling render() function.

**setAutoStart($bool)**

- **$bool**: `true` or `false`

```
{!! plupload('my_uploader_id', route('photos.store'))->setAutoStart(true) !!}
```

### Receiving files

[](#receiving-files)

**file($name, $handler)**

- **$name**: the input name.
- **$handler**: callback handler.

Use this in your route or your controller. Feel free to modify to suit your needs.

```
return Plupload::file('file', function($file) {
    // Store the uploaded file using storage disk
    $path = Storage::disk('local')->putFile('photos', $file);

    // Save the record to the db
    $photo = App\Photo::create([
        'name' => $file->getClientOriginalName(),
        'type' => 'image',
        // ...
    ]);

    // This will be included in JSON response result
    return [
        'success' => true,
        'message' => 'Upload successful.',
        'id' => $photo->id,
        // 'url' => $photo->getImageUrl($filename, 'medium'),
        // 'deleteUrl' => route('photos.destroy', $photo)
        // ...
    ];
});
```

Helper is also available

```
return plupload()->file('file', function($file) {

});
```

If you are using the package `upload.js` file. The `url` and `deleteUrl` in the JSON payload will be used to generate preview and delete link while the `id` will be appended to the uploader as a hidden field with the following format:

``.

Please note that the `deleteUrl` uses `DELETE` method.

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity32

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 98.4% 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 ~87 days

Recently: every ~204 days

Total

19

Last Release

2473d ago

Major Versions

1.x-dev → 2.0.02017-06-16

2.x-dev → 3.0.02018-06-16

PHP version history (2 changes)1.0.0PHP &gt;=5.4.0

1.2.0PHP &gt;=5.5.9

### Community

Maintainers

![](https://www.gravatar.com/avatar/783e915bb411d566e8f1035f197842db5e870a2a995b3943bcbe5db2f9abf09b?d=identicon)[Milano](/maintainers/Milano)

---

Top Contributors

[![jenky](https://avatars.githubusercontent.com/u/1808758?v=4)](https://github.com/jenky "jenky (63 commits)")[![nickfan](https://avatars.githubusercontent.com/u/100613?v=4)](https://github.com/nickfan "nickfan (1 commits)")

---

Tags

laravelphppluploadlaravelplupload

### Embed Badge

![Health badge](/badges/jenky-laravel-plupload/health.svg)

```
[![Health](https://phpackages.com/badges/jenky-laravel-plupload/health.svg)](https://phpackages.com/packages/jenky-laravel-plupload)
```

###  Alternatives

[akaunting/laravel-money

Currency formatting and conversion package for Laravel

7825.3M18](/packages/akaunting-laravel-money)[spatie/laravel-livewire-wizard

Build wizards using Livewire

4061.0M4](/packages/spatie-laravel-livewire-wizard)[tonysm/importmap-laravel

Use ESM with importmap to manage modern JavaScript in Laravel without transpiling or bundling.

148399.8k1](/packages/tonysm-importmap-laravel)[bensampo/laravel-embed

Painless responsive embeds for videos, slideshows and more.

142146.8k](/packages/bensampo-laravel-embed)[dragon-code/pretty-routes

Pretty Routes for Laravel

10058.7k4](/packages/dragon-code-pretty-routes)[laracraft-tech/laravel-useful-additions

A collection of useful Laravel additions!

58109.4k](/packages/laracraft-tech-laravel-useful-additions)

PHPackages © 2026

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