allow configuring retain_visibility, and pass along its value to Filesystem definitions

Author: rvanlaak

docs/2-cloud-storage-providers.md

@@ -161,7 +161,7 @@ flysystem:
 ## Cloudflare R2
 
 The Cloudflare R2 is compatible with the AWS S3 API, meaning that you can use the same configuration
-as for a AWS storage. For example:
+as for an AWS storage. For example:
 
 ```yaml
 # config/packages/flysystem.yaml

docs/B-configuration-reference.md

@@ -52,6 +52,7 @@ flysystem:
                         private: 0o700
             visibility: ~ # default null. Possible values are 'public' or 'private'
             directory_visibility: ~ # default null. Possible values are 'public' or 'private'
+            retain_visibility: true # default true, will then lead to adapters performing visibility checks (e.g. GetObjectAcl command for S3 adapters)
             case_sensitive: true
             disable_asserts: false
 

src/DependencyInjection/Configuration.php

@@ -42,6 +42,7 @@ public function getConfigTreeBuilder(): TreeBuilder
                             ->end()
                             ->scalarNode('visibility')->defaultNull()->end()
                             ->scalarNode('directory_visibility')->defaultNull()->end()
+                            ->booleanNode('retain_visibility')->defaultTrue()->end()
                             ->booleanNode('case_sensitive')->defaultTrue()->end()
                             ->booleanNode('disable_asserts')->defaultFalse()->end()
                             ->arrayNode('public_url')

src/DependencyInjection/FlysystemExtension.php

@@ -124,6 +124,7 @@ private function createStorageDefinition(string $storageName, Reference $adapter
         $definition->setArgument(1, [
             'visibility' => $config['visibility'],
             'directory_visibility' => $config['directory_visibility'],
+            'retain_visibility' => $config['retain_visibility'],
             'case_sensitive' => $config['case_sensitive'],
             'disable_asserts' => $config['disable_asserts'],
             'public_url' => $publicUrl,