Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A simple Symfony2 bundle to ease file uploads with ORM entities and ODM documents.
PHP Other
Failed to load latest commit information.
Adapter Remove the getClassName() method from the AdapterInterface
DependencyInjection Added a missing use statement preventing us from using a specific cac…
Event Join the mapping to upload events (fixes #266)
EventListener Allow the same mapping to be used more than once
Exception Throw a specific exception when a mapping is not found
Form Remove an unused parameter
Handler Fix UploadHandler::hasUploadedFile check
Injector Allow the same mapping to be used more than once
Mapping Fix default filename suffix usage
Metadata Handle inheritance in MetadataReader::getUploadableFields
Naming Update OrignameNamer.php
Resources Adding german translations
Storage Use r instead of r+
Templating/Helper Provide tests for the templating helper
Tests Add unit test for a custom filename attribute suffix.
Twig/Extension Provide tests for the twig extension
Util Remove the getClassName() method from the AdapterInterface
.gitattributes Add .gitattributes file
.gitignore Created helpful bash script for running tests locally.
.travis.yml Add symfony version 2.8.x-dev test target Various fixes in the CONTRIBUTING section and in the install doc Provide contribution guidelines Update UPGRADE guide for v0.12.0 to v0.13.0
VichUploaderBundle.php Add support for Propel 1.x
composer.json Applied some more suggestions, script is now more verbose.
phpunit.xml.dist Add a few functional tests Avoid downloading composer if it's already there


Build Status Total Downloads Latest Unstable Version

The VichUploaderBundle is a Symfony2 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.

Something went wrong with that request. Please try again.