First PR for #1526.

Author: laurentmuller

docs/usage.md

@@ -41,6 +41,11 @@ vich_uploader:
 This is the minimal amount of configuration needed in order to describe a
 working mapping.
 
+**Note:**
+
+> If the `upload_destination` parameter is missing, it this concatenated with
+> the `%kernel.project_dir%/public` prefix and the `uri_prefix`.
+
 ## Step 2: link the upload mapping to an entity
 
 The final step is to create a link between the filesystem and the entity you

src/DependencyInjection/Configuration.php

@@ -103,7 +103,7 @@ private function addMappingsSection(ArrayNodeDefinition $node): void
                     ->prototype('array')
                         ->children()
                             ->scalarNode('uri_prefix')->defaultValue('/uploads')->end()
-                            ->scalarNode('upload_destination')->isRequired()->end()
+                            ->scalarNode('upload_destination')->end()
                             ->arrayNode('namer')
                                 ->addDefaultsIfNotSet()
                                 ->beforeNormalization()

src/Mapping/PropertyMappingResolver.php

@@ -33,6 +33,10 @@ public function resolve(object|array $obj, string $fieldName, array $mappingData
         }
 
         $config = $this->mappings[$mappingData['mapping']];
+        if (!\array_key_exists('upload_destination', $config)) {
+            $prefix = $this->container->getParameter('kernel.project_dir') ?? '';
+            $config['upload_destination'] = $prefix . '/public/' . $config['uri_prefix'];
+        }
         $fileProperty = $mappingData['propertyName'] ?? $fieldName;
         $fileNameProperty = empty($mappingData['fileNameProperty']) ? $fileProperty.$this->defaultFilenameAttributeSuffix : $mappingData['fileNameProperty'];