A simple Symfony bundle to ease file uploads with ORM entities and ODM documents.
PHP Other
Latest commit 2f19166 Jan 11, 2017 @garak garak committed on GitHub Merge pull request #662 from dustin10/analysis-8jNdxZ
Apply fixes from StyleCI



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, PHPCR ODM documents or Propel models.

  • 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.