Skip to content
A simple Symfony2 bundle to ease file uploads with ORM entities and ODM documents.
PHP Other
Latest commit fb74df5 Apr 15, 2016 @K-Phoen K-Phoen Merge pull request #559 from Dragnucs/patch-3
Hint to usual file overriding issue.
Failed to load latest commit information.
Adapter Remove the getClassName() method from the AdapterInterface Jun 21, 2014
Command Add a few commands to display information about uploadable classes an… Aug 29, 2015
DependencyInjection Allow to specify options to namers through the configuration Aug 29, 2015
Event Join the mapping to upload events (fixes #266) Jun 26, 2014
EventListener Fixed typo UploaderHandler -> UploadHandler Mar 11, 2016
Exception Improve the DownloadHandler Nov 10, 2015
Form Add error_bubbliing option Jan 15, 2016
Handler Force ASCII filenames in the DownloadHandler Feb 25, 2016
Injector Allow the same mapping to be used more than once Dec 11, 2014
Mapping Correct FQCN Dec 9, 2015
Metadata Fix loading configuration from yaml, see: #490 Jan 25, 2016
Naming Force ASCII filenames in the DownloadHandler Feb 25, 2016
Resources Hint to usual file overriding issue. Apr 15, 2016
Storage Use r instead of r+ Jul 22, 2015
Templating/Helper Provide tests for the templating helper Dec 11, 2014
Tests Improve transliterator Feb 26, 2016
Twig/Extension remove deprecation warning while creating twig function Sep 9, 2015
Util Allow underscores in the Transliterator when intl is enabled Feb 26, 2016
.gitattributes Add .gitattributes file Nov 9, 2014
.gitignore Created helpful bash script for running tests locally. Jun 30, 2015
.travis.yml Lie about the ext-mongo extension in travis Mar 18, 2016 Various fixes in the CONTRIBUTING section and in the install doc Jul 3, 2015 Add a badge for the latest stable version Mar 18, 2016 Update UPGRADE guide for v0.12.0 to v0.13.0 Dec 11, 2014
VichUploaderBundle.php Add support for Propel 1.x Feb 14, 2014
composer.json Lie about the ext-mongo extension in travis Mar 18, 2016
phpunit.xml.dist Add a few functional tests Oct 10, 2014 Remove the composer.lock file between different runs Feb 13, 2016


Build Status Total Downloads Latest Unstable Version Latest stable 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.