PHPackages                             vich/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. vich/uploader-bundle

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

vich/uploader-bundle
====================

Ease file uploads attached to entities

v2.9.2(2mo ago)1.9k25.9M—5.5%520[51 issues](https://github.com/dustin10/VichUploaderBundle/issues)[3 PRs](https://github.com/dustin10/VichUploaderBundle/pulls)20MITPHPPHP ^8.1CI passing

Since Jan 28Pushed 2mo ago37 watchersCompare

[ Source](https://github.com/dustin10/VichUploaderBundle)[ Packagist](https://packagist.org/packages/vich/uploader-bundle)[ Docs](https://github.com/dustin10/VichUploaderBundle)[ RSS](/packages/vich-uploader-bundle/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (74)Versions (113)Used By (20)

VichUploaderBundle
==================

[](#vichuploaderbundle)

[![Build Status](https://github.com/dustin10/VichUploaderBundle/workflows/build/badge.svg)](https://github.com/dustin10/VichUploaderBundle/actions)[![Total Downloads](https://camo.githubusercontent.com/aaf68540f96ca356e05262dd6406f6d8436f6b1b411678cb6d0f5ce50030e8b3/68747470733a2f2f706f7365722e707567782e6f72672f766963682f75706c6f616465722d62756e646c652f646f776e6c6f6164732e706e67)](https://packagist.org/packages/vich/uploader-bundle)[![Latest Unstable Version](https://camo.githubusercontent.com/5ef0ae4cb743b90f3d46ef4a8ddbe62c207140ee1ae95dc7091917a28b0a4533/68747470733a2f2f706f7365722e707567782e6f72672f766963682f75706c6f616465722d62756e646c652f762f756e737461626c652e706e67)](https://packagist.org/packages/vich/uploader-bundle)[![Latest stable Version](https://camo.githubusercontent.com/fda33eaabbb6b353d7dd7bade59f069726d68950742380a0f4c34ece08c07ff0/68747470733a2f2f706f7365722e707567782e6f72672f766963682f75706c6f616465722d62756e646c652f762f737461626c652e706e67)](https://packagist.org/packages/vich/uploader-bundle)

The VichUploaderBundle is a Symfony bundle that attempts to ease file uploads that are attached to ORM entities, MongoDB ODM documents, or PHPCR ODM documents.

- Automatically name and save a file to a configured directory
- Inject the file back into the entity or document when it is loaded from the datastore as an instance of `Symfony\Component\HttpFoundation\File\File`
- Delete the file from the file system upon removal of the entity or document from the datastore
- Templating helpers to generate public URLs to the file

All of this functionality is fully configurable to allow for app-specific customization.

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

[](#documentation)

For usage documentation, see:

[docs/index.md](https://github.com/dustin10/VichUploaderBundle/blob/master/docs/index.md)

If upgrading from a previous version, also check:

[UPGRADE.md](https://github.com/dustin10/VichUploaderBundle/blob/master/UPGRADE.md)

Contributing
------------

[](#contributing)

See the [CONTRIBUTING](https://github.com/dustin10/VichUploaderBundle/blob/master/CONTRIBUTING.md) file.

License
-------

[](#license)

See the bundled [LICENSE](https://github.com/dustin10/VichUploaderBundle/blob/master/LICENSE) file.

###  Health Score

79

—

ExcellentBetter than 100% of packages

Maintenance86

Actively maintained with recent releases

Popularity76

Solid adoption and visibility

Community55

Growing community involvement

Maturity89

Battle-tested with a long release history

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~48 days

Recently: every ~23 days

Total

108

Last Release

67d ago

Major Versions

v0.14.0 → 1.0.0-beta12014-12-27

1.21.1 → 2.0.0-beta12022-09-03

1.x-dev → 2.2.02023-08-10

v2.9.1 → v3.0.0-rc2025-12-20

PHP version history (10 changes)v0.3.0PHP &gt;=5.3.2

1.0.0-beta4PHP &gt;=5.4

1.0.0-beta7PHP ~5.5|~7.0

1.4.0PHP ^5.5|^7.0

1.5.0PHP ^7.0

1.8.0PHP ^7.1

1.9.0PHP ^7.2

1.16.0PHP ^7.3 || ^8.0

2.0.0-beta1PHP ^8.1

v3.0.0-rcPHP ^8.3

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/66958?v=4)[Kévin Gomez](/maintainers/K-Phoen)[@K-Phoen](https://github.com/K-Phoen)

![](https://www.gravatar.com/avatar/4e9948ef07cd3888a1b4ed4c2615682af96b7f8728458f5b325f2abbe32369a9?d=identicon)[dustin10](/maintainers/dustin10)

![](https://www.gravatar.com/avatar/d191f9ff3aa52357cb523c9eec3553d267128fc75e0faf9dca74f289f6604f54?d=identicon)[garak](/maintainers/garak)

---

Top Contributors

[![garak](https://avatars.githubusercontent.com/u/179866?v=4)](https://github.com/garak "garak (421 commits)")[![K-Phoen](https://avatars.githubusercontent.com/u/66958?v=4)](https://github.com/K-Phoen "K-Phoen (308 commits)")[![ftassi](https://avatars.githubusercontent.com/u/176622?v=4)](https://github.com/ftassi "ftassi (97 commits)")[![dustin10](https://avatars.githubusercontent.com/u/546381?v=4)](https://github.com/dustin10 "dustin10 (59 commits)")[![Koc](https://avatars.githubusercontent.com/u/191082?v=4)](https://github.com/Koc "Koc (27 commits)")[![endelwar](https://avatars.githubusercontent.com/u/28512?v=4)](https://github.com/endelwar "endelwar (13 commits)")[![Restless-ET](https://avatars.githubusercontent.com/u/2746590?v=4)](https://github.com/Restless-ET "Restless-ET (13 commits)")[![bocharsky-bw](https://avatars.githubusercontent.com/u/3317635?v=4)](https://github.com/bocharsky-bw "bocharsky-bw (10 commits)")[![kbond](https://avatars.githubusercontent.com/u/127811?v=4)](https://github.com/kbond "kbond (9 commits)")[![guillaume-sainthillier](https://avatars.githubusercontent.com/u/5052984?v=4)](https://github.com/guillaume-sainthillier "guillaume-sainthillier (9 commits)")[![khepin](https://avatars.githubusercontent.com/u/455656?v=4)](https://github.com/khepin "khepin (7 commits)")[![laurentmuller](https://avatars.githubusercontent.com/u/4330059?v=4)](https://github.com/laurentmuller "laurentmuller (6 commits)")[![GeLoLabs](https://avatars.githubusercontent.com/u/149005863?v=4)](https://github.com/GeLoLabs "GeLoLabs (6 commits)")[![benr77](https://avatars.githubusercontent.com/u/2156742?v=4)](https://github.com/benr77 "benr77 (5 commits)")[![oleg-andreyev](https://avatars.githubusercontent.com/u/1244112?v=4)](https://github.com/oleg-andreyev "oleg-andreyev (5 commits)")[![tgabi333](https://avatars.githubusercontent.com/u/187022?v=4)](https://github.com/tgabi333 "tgabi333 (5 commits)")[![tgalopin](https://avatars.githubusercontent.com/u/1651494?v=4)](https://github.com/tgalopin "tgalopin (5 commits)")[![EmmanuelVella](https://avatars.githubusercontent.com/u/663607?v=4)](https://github.com/EmmanuelVella "EmmanuelVella (4 commits)")[![VincentLanglet](https://avatars.githubusercontent.com/u/9052536?v=4)](https://github.com/VincentLanglet "VincentLanglet (4 commits)")[![Dragnucs](https://avatars.githubusercontent.com/u/6125772?v=4)](https://github.com/Dragnucs "Dragnucs (4 commits)")

---

Tags

bundlephpsymfonysymfony-bundleuploadfile uploads

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[sulu/sulu

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

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

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[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)[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)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)

PHPackages © 2026

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