NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #1023 most downloaded on Packagist
Ease file uploads attached to entities
Latest stable
v3.0.0
Last release 2 months ago
09 Sep 2026
Ships fairly regularly
a new release about every 2 months
Most releases are documented
notes for 45 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
15 years old
113 releases · first in 2012
Drag across the ruler to compare, or tap a release to open it.
Annotations are gone. Only PHP attributes from Vich\UploaderBundle\Mapping\Attribute are supported. The deprecated Mapping\Annotation namespace, Annot…
First stable release of the 3.x line. It includes every fix shipped in 2.9.x and 2.10.0.
Upgrading from 2.x: read UPGRADE.md first.
2.x moves to maintenance on the 2.x branch.
Vich\UploaderBundle\Mapping\Attribute are supported. The deprecated Mapping\Annotation namespace, AnnotationInterface and the *Annotation() methods of AttributeReader are removed. (#1549, #1556)NamerInterface::name() and DirectoryNamerInterface::directoryName() now take object|array. Custom namers type-hinting object must widen their signature. (#1561)PropertyMappingResolverInterface::resolve() returns PropertyMappingInterface instead of PropertyMapping.PropertyMapping, PropertyMappingFactory, MetadataReader and AttributeReader are final. Extend or mock the new interfaces instead: PropertyMappingInterface, PropertyMappingFactoryInterface, MetadataReaderInterface, UploadHandlerInterface. (#1539, #1565)StorageInterface has a new listFiles(PropertyMappingInterface $mapping): iterable method, used by the cleanup command. Custom storages must implement it. (#1553)vich:cleanup command removes files in storage that no mapped entity references any more. Ships with --dry-run, a --min-age guard against in-flight uploads and an explicit confirmation step. See docs/command/cleanup.md. (#1553)ChainDirectoryNamer concatenates the output of several directory namers. Empty segments are skipped. See docs/namers.md. (#1570)Random\Randomizer. (#1568)TypeError. (#1605)resolveUri() normalises slashes between uri_prefix, directory and file name, so a trailing slash in uri_prefix no longer produces //. (#1604)AttributeReader no longer instantiates attributes unrelated to the bundle. (#1603)mkdir(). (#1589)PropertyNamer and PropertyDirectoryNamer accept "0" as a value. (#1597)VichFileType: delete_label keeps its own translation domain when download_label is a callable. New options download_label_translation_domain and delete_label_translation_domain. Custom form themes must read download_label_translation_domain instead of translation_domain for the download link. (#1574)MappingCollector no longer breaks the profiler when no mapping data was collected. (#1594)FileExtensionTrait no longer triggers the "null as array offset" deprecation on PHP 8.4. (#1595)declare(strict_types=1) removed to match the rest of the Symfony ecosystem. (#1600)Port of the fixes released on 2.x between 2.9.2 and 2.10.0 (#1574, #1580, #1594, #1595, #1597, #1603, #1604, #1605) and two doc updates (#1571, #1582).
@endelwar, @gnat42, @guillaume-sainthillier, @ousamabenyounes, @sabat24, @Tairesh, @ixarlie, @theredled and @garak.
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/v2.10.0...v3.0.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Modernize Docker test images & fix PHP 8.3 / 8.5 by @endelwar in https://github.com/dustin10/VichUploaderBundle/pull/1596
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/v3.0.0-rc3...v3.0.0-rc4
Leverage PHP 8.2/8.3 features: readonly classes, readonly properties, and Randomizer by @Copilot in https://github.com/dustin10/VichUploaderBundle/pul
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/v3.0.0-rc...v3.0.0-r3
fix the "Non-readonly class PHPUnit\Metadata\DataProvider cannot exte… by @guillaume-sainthillier in https://github.com/dustin10/VichUploaderBundle/pu
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/v2.9.1...v3.0.0-rc2
Remove deprecated Annotation namespace by @endelwar in https://github.com/dustin10/VichUploaderBundle/pull/1556
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/v2.8.1...v3.0.0-rc
Fix built-in namer configuration isolation for 2.10 by @endelwar in https://github.com/dustin10/VichUploaderBundle/pull/1610
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/v2.10.0...v2.10.1
Fix "null as array offset" deprecation in FileExtensionTrait by @endelwar in https://github.com/dustin10/VichUploaderBundle/pull/1595
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/v2.9.4...v2.10.0
This will be the last minor release in branch 2.
Shortly, branch 3 will be merged into master, and the next release will be 3.0.0 (you can already try the next major version right now by requiring ^3.0-rc)
Revert 3.x port leftovers and realign master with 2.9.2 by @endelwar in https://github.com/dustin10/VichUploaderBundle/pull/1593
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/v2.9.3...v2.9.4
This tag was mistakenly not containing all the needed fixes to keep BC. It lasted for a few hours, but if you got it, please upgrade to v2.9.4 as soon
This tag was mistakenly not containing all the needed fixes to keep BC. It lasted for a few hours, but if you got it, please upgrade to v2.9.4 as soon as possible.
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/v2.9.2...v2.9.3
fix the "Non-readonly class PHPUnit\Metadata\DataProvider cannot exte… by @guillaume-sainthillier in https://github.com/dustin10/VichUploaderBundle/pu
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/v2.9.1...v2.9.2
Fix AttributeDriver not using Vich\UploaderBundle\Mapping\Annotation\UploadableField by @andyexeter in https://github.com/dustin10/VichUploaderBundle/
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/v2.9.0...v2.9.1
Deprecate Annotation namespace in favor of Attribute namespace by @endelwar in https://github.com/dustin10/VichUploaderBundle/pull/1555
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/v2.8.1...v2.9.0
Fix directories named "0" being dropped in storage URI resolution by @slashfan in https://github.com/dustin10/VichUploaderBundle/pull/1534
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/v2.8.0...v2.8.1
Add description within the command attribute by @laurentmuller in https://github.com/dustin10/VichUploaderBundle/pull/1514
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/v2.7.0...v2.8.0
use attributes in commands by @garak in https://github.com/dustin10/VichUploaderBundle/pull/1505
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/v2.6.1...v2.7.0
Updated the PropertyMapping to accept array for the getUploadDir() function. by @laurentmuller in https://github.com/dustin10/VichUploaderBundle/pull/
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/v2.6.0...v2.6.1
This release mostly allows for more recent Doctrine libraries, and polishes the tests a bit.
This release mostly allows for more recent Doctrine libraries, and polishes the tests a bit.
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/v2.5.1...v2.6.0
🐛 address extension change in the code and in the docs by @garak in https://github.com/dustin10/VichUploaderBundle/pull/1484
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/v2.5.0...v2.5.1
🎨 deprecate annotations by @garak in https://github.com/dustin10/VichUploaderBundle/pull/1483
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/v2.4.3...v2.5.0
Fix exception handling in FlysystemStorage by @regis-martini in https://github.com/dustin10/VichUploaderBundle/pull/1473
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/v2.4.2...v2.4.3
Ability to remove file for ReplacingFile by @iksmail in https://github.com/dustin10/VichUploaderBundle/pull/1462
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/2.4.1...v2.4.2
✅ remove other phpunit deprecations by @garak in https://github.com/dustin10/VichUploaderBundle/pull/1466
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/2.4.0...2.4.1
💚 fix phpstan CI by @garak in https://github.com/dustin10/VichUploaderBundle/pull/1452
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/2.3.3...2.4.0
Revert changes of #1441 by @sovetski in https://github.com/dustin10/VichUploaderBundle/pull/1444
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/2.3.2...2.3.3
Update usage.md, use 'attribute' not annotation by @tacman in https://github.com/dustin10/VichUploaderBundle/pull/1433
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/2.3.1...2.3.2
fix dev deps to allow sf7 by @garak in https://github.com/dustin10/VichUploaderBundle/pull/1420
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/2.3.0...2.3.1
fix deprecation by @garak in https://github.com/dustin10/VichUploaderBundle/pull/1416
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/2.2.0...2.3.0
Fix icon color according to theme by @feymo in https://github.com/dustin10/VichUploaderBundle/pull/1372
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/2.1.1...2.2.0
fix Twig extension by @garak in https://github.com/dustin10/VichUploaderBundle/pull/1370
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/2.1.0...2.1.1
deprecate: spitNameByExtension, use splitNameByExtension instead by @ockstadt in https://github.com/dustin10/VichUploaderBundle/pull/1338
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/2.0.1...2.1.0
Fix compatibility with Symfony 5
Fix compatibility with Symfony 5
all deprecated features were removed
@final is now finalDateTimeHelper interface has been removed as well.Nothing published for this version
Fix deprecation warning on 1.x by @endelwar in https://github.com/dustin10/VichUploaderBundle/pull/1383
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/1.23.0...1.23.1
backport Twig extension enhancement to 1.x by @garak in https://github.com/dustin10/VichUploaderBundle/pull/1382
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/1.22.0...1.23.0
Fix command and Symfony deprecations by @IonBazan in https://github.com/dustin10/VichUploaderBundle/pull/1328
Full Changelog: https://github.com/dustin10/VichUploaderBundle/compare/1.21.1...1.22.0
Nothing published for this version
fix internal deprecation (thanks to @endelwar)
Allow decorating the UploaderHelper (thanks to @VincentLanglet)
remove some internal annotations
add support for PHP 8 attributes
move symfony/form to suggestions
Nothing published for this version
Nothing published for this version
Nothing published for this version
* add support for PHP 8 * remove support for PHP 7.2 * fix cache warmer * fix Azure
refactor translations (@VincentLanglet & @garak)
remove Symofny 5 event deprecation (@garak)
Nothing published for this version
fix Flysystem manual wiring BC break
remove behat/transliterator in favor of symfony/string
behat/transliterator in favor of symfony/stringsymfony/templatingleague/flysystem-bundle (thanks to @tgalopin)Nothing published for this version
drop support for Symfony < 4.4 (support will continue in older versions)
Add new option to resolve storage in VichImageType
Nothing published for this version
Nothing published for this version
deprecate non-property use of CurrentDateTimeDirectoryNamer (thanks to @garak)
In this release:
Nothing published for this version
Nothing published for this version
allow for jms/metadata version 2. Because of this, we had to drop support for php 7.1
Changes in this release:
jms/metadata version 2. Because of this, we had to drop support for php 7.1One column per quarter.