PHPackages                             oneup/uploader-bundle - 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 &amp; Storage](/categories/file-storage)
4. /
5. oneup/uploader-bundle

ActiveSymfony-bundle[File &amp; Storage](/categories/file-storage)

oneup/uploader-bundle
=====================

This Symfony bundle provides a server implementation for handling single and multiple file uploads using either FineUploader, jQuery File Uploader, YUI3 Uploader, Uploadify, FancyUpload, MooUpload, Plupload or Dropzone. Features include chunked uploads, orphanages, Gaufrette and Flysystem support.

5.1.2(3mo ago)6066.3M—2.6%173[19 issues](https://github.com/1up-lab/OneupUploaderBundle/issues)20MITPHPPHP ^8.0CI passing

Since Apr 9Pushed 3mo ago26 watchersCompare

[ Source](https://github.com/1up-lab/OneupUploaderBundle)[ Packagist](https://packagist.org/packages/oneup/uploader-bundle)[ Docs](https://1up.io)[ RSS](/packages/oneup-uploader-bundle/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (23)Versions (75)Used By (20)Security (1)

OneupUploaderBundle
===================

[](#oneupuploaderbundle)

[![CI](https://github.com/1up-lab/OneupUploaderBundle/workflows/CI/badge.svg)](https://github.com/1up-lab/OneupUploaderBundle/actions)[![Total Downloads](https://camo.githubusercontent.com/0daf45060e354deb7ab2f7d3289c9c8ff6702b85e06b1949cb8dcf16556b3f2c/68747470733a2f2f706f7365722e707567782e6f72672f6f6e6575702f75706c6f616465722d62756e646c652f642f746f74616c2e706e67)](https://packagist.org/packages/oneup/uploader-bundle)

The OneupUploaderBundle for Symfony adds support for handling file uploads using one of the following JavaScript libraries, or [your own implementation](https://github.com/1up-lab/OneupUploaderBundle/blob/main/doc/custom_uploader.md).

- [Dropzone](http://www.dropzonejs.com/)
- [jQuery File Upload](http://blueimp.github.io/jQuery-File-Upload/)
- [Plupload](http://www.plupload.com/)
- [FineUploader](http://fineuploader.com/)
- [FancyUpload](http://digitarald.de/project/fancyupload/) (based on MooTools)
- [MooUpload](https://github.com/juanparati/MooUpload) (based on MooTools)
- [YUI3 Uploader](http://yuilibrary.com/yui/docs/uploader/) (the YUI library is no longer maintained)
- [UploadiFive](http://www.uploadify.com/) ($ 5.00)

Features included:

- Multiple file uploads handled by your chosen frontend library
- Chunked uploads
- Support for: [Gaufrette](https://github.com/KnpLabs/Gaufrette) / [Flysystem](https://github.com/thephpleague/flysystem) / local filesystem
- Provides an orphanage for cleaning up orphaned files
- Supports [Session upload progress &amp; cancelation of uploads](http://php.net/manual/en/session.upload-progress.php) as of PHP 5.4
- Fully unit tested

Documentation
-------------

[](#documentation)

The entry point of the documentation can be found in the file `docs/index.md`

[Read the documentation for main](https://github.com/1up-lab/OneupUploaderBundle/blob/main/doc/index.md)

Upgrade Notes
-------------

[](#upgrade-notes)

- Version **5.1.0** supports now Symfony 8 (kudos to @[knallcharge](https://github.com/knallcharge), see [\#446](https://github.com/1up-lab/OneupUploaderBundle/pull/446)!
- Version **5.0.0** supports now Symfony 7 (kudos to @[evertharmeling](https://github.com/evertharmeling) and @[joesenova](https://github.com/joesenova)), see [\#436](https://github.com/1up-lab/OneupUploaderBundle/pull/436)! Symfony 4 and PHP 7 support was dropped.
- Version **4.0.0** supports now [Flysystem 2 &amp; 3](https://github.com/1up-lab/OneupFlysystemBundle) (kudos to @[m2mtech](https://github.com/m2mtech)), see [\#412](https://github.com/1up-lab/OneupUploaderBundle/pull/412)! Flysystem 1 and OneupFlysystemBundle &lt; 4.0 support was dropped.
- Version **3.2.0** supports now Symfony 6 (kudos to @[pich](https://github.com/pich)), see [\#421](https://github.com/1up-lab/OneupUploaderBundle/pull/421)! PHP 7.2/7.3 support was dropped.
- Version **3.0.0** supports now Symfony 5 (kudos to @[steveWinter](https://github.com/steveWinter), @[gubler](https://github.com/gubler), @[patrickbussmann](https://github.com/patrickbussmann), @[ErnadoO](https://github.com/ErnadoO) and @[enumag](https://github.com/enumag), see [\#373](https://github.com/1up-lab/OneupUploaderBundle/pull/373)! Symfony 3.x support was dropped.
- Version **2.0.0** supports now Symfony 4 (Thank you @[istvancsabakis](https://github.com/istvancsabakis), see [\#295](https://github.com/1up-lab/OneupUploaderBundle/pull/295))! Symfony 2.x support was dropped. You can also configure a file extension validation whitelist now (PR [\#262](https://github.com/1up-lab/OneupUploaderBundle/pull/262)).
- Version **1.5.0** supports now [Flysystem](https://github.com/1up-lab/OneupFlysystemBundle) (Thank you @[lsv](https://github.com/lsv)! PR [\#213](https://github.com/1up-lab/OneupUploaderBundle/pull/213)) and is no longer compatible with PHP 5.3 (it's [EOL](http://php.net/eol.php) since August 2014 anyway).
- Version **v1.0.0** introduced some backward compatibility breaks. For a full list of changes, head to the [dedicated pull request](https://github.com/1up-lab/OneupUploaderBundle/pull/57).
- If you're using chunked uploads consider upgrading from **v0.9.6** to **v0.9.7**. A critical issue was reported regarding the assembly of chunks. More information in ticket [\#21](https://github.com/1up-lab/OneupUploaderBundle/issues/21#issuecomment-21560320).
- Error management [changed](https://github.com/1up-lab/OneupUploaderBundle/pull/25) in Version **0.9.6**. You can now register an `ErrorHandler` per configured frontend. This comes bundled with some adjustments to the `blueimp` controller. More information is available in [the documentation](https://github.com/1up-lab/OneupUploaderBundle/blob/main/doc/custom_error_handler.md).
- Event dispatching [changed](https://github.com/1up-lab/OneupUploaderBundle/commit/a408548b241f47af3539b2137c1817a21a51fde9) in Version **0.9.5**. The dispatching is now handled in the `upload*` functions. So if you have created your own implementation, be sure to remove the call to the `dispatchEvents` function, otherwise it will be called twice. Furthermore no `POST_UPLOAD` event will be fired anymore after uploading a chunk. You can get more information on this topic in the [documentation](https://github.com/1up-lab/OneupUploaderBundle/blob/main/doc/custom_logic.md#using-chunked-uploads).
- Event names [changed](https://github.com/1up-lab/OneupUploaderBundle/commit/f5d5fe4b6f7b9a04ce633acbc9c94a2dd0e0d6be) in Version **0.9.3**, update your EventListener accordingly.

License
-------

[](#license)

This bundle is under the MIT license. See the complete license in the bundle:

```
LICENSE

```

Reporting an issue or a feature request
---------------------------------------

[](#reporting-an-issue-or-a-feature-request)

Issues and feature requests are tracked in the [Github issue tracker](https://github.com/1up-lab/OneupUploaderBundle/issues).

When reporting a bug, it may be a good idea to reproduce it in a basic project built using the [Symfony Standard Edition](https://github.com/symfony/symfony-standard)to allow developers of the bundle to reproduce the issue by simply cloning it and following some steps.

###  Health Score

72

—

ExcellentBetter than 100% of packages

Maintenance82

Actively maintained with recent releases

Popularity67

Solid adoption and visibility

Community46

Growing community involvement

Maturity83

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 62.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 ~67 days

Recently: every ~175 days

Total

71

Last Release

90d ago

Major Versions

1.9.4 → 2.1.62020-02-04

2.2.0 → 3.0.02020-03-27

3.2.0 → 4.0.02022-07-20

3.2.1 → 4.0.12022-07-25

4.0.1 → 5.0.02024-03-18

PHP version history (7 changes)1.5.0PHP &gt;=5.4

2.0.0PHP ^7.0

2.0.5PHP ^7.1

3.0.0PHP ^7.2.5

3.1.0PHP ^7.2.5 || ^8.0

3.2.0PHP ^7.4 || ^8.0

5.0.0PHP ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/87bf1d07a851471e5d0ba2052e6a7a78d6313378214087a2919ff9979656ad0b?d=identicon)[bytehead](/maintainers/bytehead)

![](https://www.gravatar.com/avatar/851cd6cc31c9f924bd4d61793ea7a68e24304632ccf03babf0acab6118f70758?d=identicon)[sheeep](/maintainers/sheeep)

---

Top Contributors

[![sheeep](https://avatars.githubusercontent.com/u/607530?v=4)](https://github.com/sheeep "sheeep (409 commits)")[![bytehead](https://avatars.githubusercontent.com/u/754921?v=4)](https://github.com/bytehead "bytehead (141 commits)")[![mitom](https://avatars.githubusercontent.com/u/3754515?v=4)](https://github.com/mitom "mitom (36 commits)")[![lsv](https://avatars.githubusercontent.com/u/20708?v=4)](https://github.com/lsv "lsv (15 commits)")[![ThomasLandauer](https://avatars.githubusercontent.com/u/1054469?v=4)](https://github.com/ThomasLandauer "ThomasLandauer (5 commits)")[![albenik](https://avatars.githubusercontent.com/u/1047425?v=4)](https://github.com/albenik "albenik (5 commits)")[![mediafigaro](https://avatars.githubusercontent.com/u/18629935?v=4)](https://github.com/mediafigaro "mediafigaro (3 commits)")[![lchrusciel](https://avatars.githubusercontent.com/u/6213903?v=4)](https://github.com/lchrusciel "lchrusciel (3 commits)")[![Lctrs](https://avatars.githubusercontent.com/u/5477973?v=4)](https://github.com/Lctrs "Lctrs (3 commits)")[![AhmadTawila](https://avatars.githubusercontent.com/u/731905?v=4)](https://github.com/AhmadTawila "AhmadTawila (2 commits)")[![deviprsd](https://avatars.githubusercontent.com/u/3809354?v=4)](https://github.com/deviprsd "deviprsd (2 commits)")[![ErnadoO](https://avatars.githubusercontent.com/u/6375756?v=4)](https://github.com/ErnadoO "ErnadoO (2 commits)")[![giosh94mhz](https://avatars.githubusercontent.com/u/5219975?v=4)](https://github.com/giosh94mhz "giosh94mhz (2 commits)")[![knallcharge](https://avatars.githubusercontent.com/u/1715912?v=4)](https://github.com/knallcharge "knallcharge (2 commits)")[![m2mtech](https://avatars.githubusercontent.com/u/1568448?v=4)](https://github.com/m2mtech "m2mtech (2 commits)")[![mhlavac](https://avatars.githubusercontent.com/u/743421?v=4)](https://github.com/mhlavac "mhlavac (2 commits)")[![ndench](https://avatars.githubusercontent.com/u/2062388?v=4)](https://github.com/ndench "ndench (2 commits)")[![ribeiropaulor](https://avatars.githubusercontent.com/u/376830?v=4)](https://github.com/ribeiropaulor "ribeiropaulor (2 commits)")[![Schyzophrenic](https://avatars.githubusercontent.com/u/1174479?v=4)](https://github.com/Schyzophrenic "Schyzophrenic (2 commits)")[![snarktooth](https://avatars.githubusercontent.com/u/19474521?v=4)](https://github.com/snarktooth "snarktooth (2 commits)")

---

Tags

chunked-uploadsdropzonefineuploadergaufrettephppluploadsymfonyuploadpluploadblueimpfileuploadFineUploaderjQuery File UploaderYUI3 UploaderUploadifyFancyUploadMooUploaddropzone

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/oneup-uploader-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/oneup-uploader-bundle/health.svg)](https://phpackages.com/packages/oneup-uploader-bundle)
```

###  Alternatives

[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[contao/core-bundle

Contao Open Source CMS

1231.6M2.4k](/packages/contao-core-bundle)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)

PHPackages © 2026

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