Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A simple Symfony2 bundle to ease file uploads with ORM entities and ODM documents.
Failed to load latest commit information.
Adapter Remove the getClassName() method from the AdapterInterface
DependencyInjection Add a DownloadHandler to ease file downloads from non web-accessible …
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 Removed unused methods in UploadableField
Metadata Handle inheritance in MetadataReader::getUploadableFields
Naming Fix mapping type in docbock
Resources Add a note about UploadedFile test mode
Storage Fix docblock
Templating/Helper Provide tests for the templating helper
Tests Do not require Flysystem for PHP 5.3 builds
Twig/Extension Provide tests for the twig extension
Util Remove the getClassName() method from the AdapterInterface
.gitattributes Add .gitattributes file
.gitignore Update .travis.yml/composer.json config
.travis.yml Do not require Flysystem for PHP 5.3 builds Provide contribution guidelines Provide contribution guidelines Update UPGRADE guide for v0.12.0 to v0.13.0
VichUploaderBundle.php Add support for Propel 1.x
composer.json Fix circular dependency when using gaufrette doctrine storage and doc…
phpunit.xml.dist Add a few functional tests


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.