A simple Symfony2 bundle to ease file uploads with ORM entities and ODM documents.
PHP Other
Latest commit 0ecb31a Aug 26, 2016 @K-Phoen K-Phoen committed on GitHub Merge pull request #613 from tgabi333/patch-1
fix for deprecation in documentattion
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 Add custom storage support May 26, 2016
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 fix for deprecation in documentattion Aug 25, 2016
Storage Use r instead of r+ Jul 22, 2015
Templating/Helper Provide tests for the templating helper Dec 11, 2014
Tests fix for deprecation Aug 25, 2016
Twig/Extension remove deprecation warning while creating twig function Sep 9, 2015
Util check if class exists instead of function exists Aug 24, 2016
.gitattributes Add .gitattributes file Nov 9, 2014
.gitignore Created helpful bash script for running tests locally. Jun 30, 2015
.travis.yml Fix rusty command May 31, 2016
CONTRIBUTING.md Various fixes in the CONTRIBUTING section and in the install doc Jul 3, 2015
README.md Inform the world that this bundle needs a new maintainer Aug 10, 2016
UPGRADE.md 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 Update unstable branch alias May 29, 2016
phpunit.xml.dist Add a few functional tests Oct 10, 2014
runTests.sh Remove the composer.lock file between different runs Feb 13, 2016



Build Status Total Downloads Latest Unstable Version Latest stable Version

⚠ This bundle is looking for a new maintainer! ⚠

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.