vich/uploader-bundle

Ease file uploads attached to entities

v2.5.0 2024-12-09 07:56 UTC

Requires

• php: ^8.1
• ext-simplexml: *
• doctrine/persistence: ^3.0
• jms/metadata: ^2.4
• symfony/config: ^5.4 || ^6.0 || ^7.0
• symfony/console: ^5.4 || ^6.0 || ^7.0
• symfony/dependency-injection: ^5.4 || ^6.0 || ^7.0
• symfony/event-dispatcher-contracts: ^3.1
• symfony/http-foundation: ^5.4 || ^6.0 || ^7.0
• symfony/http-kernel: ^5.4 || ^6.0 || ^7.0
• symfony/mime: ^5.4 || ^6.0 || ^7.0
• symfony/property-access: ^5.4 || ^6.0 || ^7.0
• symfony/string: ^5.4 || ^6.0 || ^7.0

Requires (Dev)

• ext-sqlite3: *
• dg/bypass-finals: ^1.8
• doctrine/doctrine-bundle: ^2.7
• doctrine/mongodb-odm: ^2.4
• doctrine/orm: ^2.13
• knplabs/knp-gaufrette-bundle: dev-master
• league/flysystem-bundle: ^2.4 || ^3.0
• league/flysystem-memory: ^2.0 || ^3.0
• matthiasnoback/symfony-dependency-injection-test: ^5.1
• mikey179/vfsstream: ^1.6.11
• phpunit/phpunit: ^9.6
• symfony/asset: ^5.4 || ^6.0 || ^7.0
• symfony/browser-kit: ^5.4 || ^6.0 || ^7.0
• symfony/css-selector: ^5.4 || ^6.0 || ^7.0
• symfony/doctrine-bridge: ^5.4 || ^6.0 || ^7.0
• symfony/dom-crawler: ^5.4 || ^6.0 || ^7.0
• symfony/form: ^5.4 || ^6.0 || ^7.0
• symfony/framework-bundle: ^5.4 || ^6.0 || ^7.0
• symfony/phpunit-bridge: ^7.0
• symfony/security-csrf: ^5.4 || ^6.0 || ^7.0
• symfony/translation: ^5.4 || ^6.0 || ^7.0
• symfony/twig-bridge: ^5.4 || ^6.0 || ^7.0
• symfony/twig-bundle: ^5.4 || ^6.0 || ^7.0
• symfony/validator: ^5.4 || ^6.0 || ^7.0
• symfony/var-dumper: ^5.4 || ^6.0 || ^7.0
• symfony/yaml: ^5.4 || ^6.0 || ^7.0
• yoast/phpunit-polyfills: ^2.0

Suggests

• doctrine/doctrine-bundle: For integration with Doctrine
• doctrine/mongodb-odm-bundle: For integration with Doctrine ODM
• doctrine/orm: For integration with Doctrine ORM
• doctrine/phpcr-odm: For integration with Doctrine PHPCR
• knplabs/knp-gaufrette-bundle: For integration with Gaufrette
• league/flysystem-bundle: For integration with Flysystem
• liip/imagine-bundle: To generate image thumbnails
• oneup/flysystem-bundle: For integration with Flysystem
• symfony/asset: To generate better links
• symfony/form: To handle uploads in forms
• symfony/yaml: To use YAML mapping

Conflicts

• doctrine/annotations: <1.12
• league/flysystem: <2.0

MIT

• Dustin Dobervich

• upload
• file uploads

README

The VichUploaderBundle is a Symfony bundle that attempts to ease file uploads that are attached to ORM entities, MongoDB ODM documents, or PHPCR ODM documents.

• 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.

Documentation

For usage documentation, see:

docs/index.md

If upgrading from a previous version, also check:

UPGRADE.md

Contributing

See the CONTRIBUTING file.

License

See the bundled LICENSE file.