dustin10/VichUploaderBundle

A simple Symfony bundle to ease file uploads with ORM entities and ODM documents.

PHP

1,902

1,313 commits

updated Sep 21, 2026

See the code

README

VichUploaderBundle

Build Status Total Downloads Latest Unstable Version Latest stable Version

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

For usage documentation, see:

docs/index.md

If upgrading from a previous version, also check:

UPGRADE.md

Contributing

See the CONTRIBUTING file.

License

See the bundled LICENSE file.

bundle
php
symfony
symfony-bundle

dustin10/VichUploaderBundle

A simple Symfony bundle to ease file uploads with ORM entities and ODM documents.

PHP

1,902

1,313 commits

updated Sep 21, 2026

See the code

README

VichUploaderBundle

Build Status Total Downloads Latest Unstable Version Latest stable Version

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

For usage documentation, see:

docs/index.md

If upgrading from a previous version, also check:

UPGRADE.md

Contributing

See the CONTRIBUTING file.

License

See the bundled LICENSE file.

bundle
php
symfony
symfony-bundle

Project health

Overall

4.8/10

Maintained

10/10

Code review

4/10
OpenSSF Scorecard

Significant stargazers

Kévin Dunglas

4,629 followers · starred Dec 2014

Robin Chalas

609 followers · starred Jan 2021

Louis-Arnaud

30 followers · starred Feb 2025

Fabien Laurence

22 followers · starred Jul 2024