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
Latest commit 500f720 @K-Phoen K-Phoen Merge pull request #474 from jvasseur/downloadhandler-fix
Fix DownloadHandler
Failed to load latest commit information.
Adapter Remove the getClassName() method from the AdapterInterface
Command Add a few commands to display information about uploadable classes an…
DependencyInjection Allow to specify options to namers through the configuration
Event Join the mapping to upload events (fixes #266)
EventListener Compute changeset after updating all fields
Exception Improve the DownloadHandler
Form Deprecation fixed in VichFileType.
Handler Fix DownloadHandler
Injector Allow the same mapping to be used more than once
Mapping Allow to specify options to namers through the configuration
Metadata Handle inheritance in MetadataReader::getUploadableFields
Naming Only use iconv if available
Resources Fix markdown markup
Storage Use r instead of r+
Templating/Helper Provide tests for the templating helper
Tests Improve the DownloadHandler
Twig/Extension remove deprecation warning while creating twig function
Util Remove the getClassName() method from the AdapterInterface
.gitattributes Add .gitattributes file
.gitignore Created helpful bash script for running tests locally.
.travis.yml Do not require mongo db extension 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 Use a safer symfony/finder version constraint
phpunit.xml.dist Add a few functional tests Color output


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.