Ease file uploads attached to entities

Installs: 15 004 382

Dependents: 134

Suggesters: 16

Security: 0

Stars: 1 770

Watchers: 42

Forks: 516

Open Issues: 50


2.2.0 2023-08-10 12:55 UTC


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.


For usage documentation, see:


If upgrading from a previous version, also check:


See the CONTRIBUTING file.


See the bundled LICENSE file.