feat: add S3 resolver path_style, credentials config + relativePath in Twig macros

Add path_style and credentials options to S3ResolverFactory for
LocalStack/MinIO compatibility. Update Twig image macros to prefer
relativePath over uri for correct image filter resolution with S3.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: dev

src/DependencyInjection/Factory/Resolver/S3ResolverFactory.php

@@ -38,6 +38,19 @@ public function create(ContainerBuilder $container, string $name, array $config)
             $clientArgs['endpoint'] = $config['endpoint'];
         }
 
+        if ($config['path_style'] ?? false) {
+            $clientArgs['use_path_style_endpoint'] = true;
+        }
+
+        if (isset($config['credentials'])) {
+            /** @var array{key: string, secret: string} $credentials */
+            $credentials = $config['credentials'];
+            $clientArgs['credentials'] = [
+                'key' => $credentials['key'],
+                'secret' => $credentials['secret'],
+            ];
+        }
+
         $clientDefinition = new Definition(S3Client::class, [$clientArgs]);
         $clientId = \sprintf('chamber_orchestra_image.cache.resolver.%s.client', $name);
         $container->setDefinition($clientId, $clientDefinition);
@@ -92,6 +105,17 @@ public function addConfiguration(ArrayNodeDefinition $builder): void
                     ->defaultNull()
                     ->info('ACL for stored objects (e.g. "public-read"). Null to omit.')
                 ->end()
+                ->booleanNode('path_style')
+                    ->defaultFalse()
+                    ->info('Use path-style addressing (required for LocalStack/MinIO).')
+                ->end()
+                ->arrayNode('credentials')
+                    ->children()
+                        ->scalarNode('key')->isRequired()->end()
+                        ->scalarNode('secret')->isRequired()->end()
+                    ->end()
+                    ->info('Explicit AWS credentials. Omit to use default credential chain.')
+                ->end()
             ->end()
         ;
     }

src/Resources/views/macro/image.html.twig

@@ -13,8 +13,8 @@
 {%- endmacro -%}
 
 {%- macro fit(src, width, height, attr, picture_attr = {}) -%}
-    {# add support of ChamberOrchestra\FileBundle\Model\File #}
-    {%- set src = src.uri|default(src) -%}
+    {# add support of ChamberOrchestra\FileBundle\Model\File — use relativePath for image filters, falls back to uri #}
+    {%- set src = src.relativePath|default(src.uri|default(src)) -%}
     {%- set attr = attr|default({})|merge({width: attr.width|default(width), height: attr.height|default(height), style: 'height: auto', loading: 'lazy', decoding: 'async'}) -%}
     <picture {{ _self.attributes(picture_attr) -}}>
             <source {#
@@ -36,8 +36,8 @@
 {%- endmacro -%}
 
 {%- macro fill(src, width, height, attr, picture_attr = {}) -%}
-    {# add support of ChamberOrchestra\FileBundle\Model\File #}
-    {%- set src = src.uri|default(src) -%}
+    {# add support of ChamberOrchestra\FileBundle\Model\File — use relativePath for image filters, falls back to uri #}
+    {%- set src = src.relativePath|default(src.uri|default(src)) -%}
     {%- set attr = attr|default({})|merge({width: attr.width|default(width), height: attr.height|default(height), style: 'height: auto', loading: 'lazy', decoding: 'async'}) -%}
 
     <picture {{ _self.attributes(picture_attr) -}}>
@@ -61,8 +61,8 @@
 
 {%- macro css_fit(src, width, height, use2x = true) -%}
 
-    {# add support of ChamberOrchestra\FileBundle\Model\File #}
-    {%- set src = src.uri|default(src) -%}
+    {# add support of ChamberOrchestra\FileBundle\Model\File — use relativePath for image filters, falls back to uri #}
+    {%- set src = src.relativePath|default(src.uri|default(src)) -%}
     {%- set url = (src|default('')|fit(width, height)) -%}
     {%- set webp = (src|default('')|fit(width, height, {output: {format: 'webp'}})) -%}
     {%- set avif = (src|default('')|fit(width, height, {output: {format: 'avif'}})) -%}
@@ -104,8 +104,8 @@
 
 {%- macro css_fill(src, width, height, use2x = true) -%}
 
-    {# add support of ChamberOrchestra\FileBundle\Model\File #}
-    {%- set src = src.uri|default(src) -%}
+    {# add support of ChamberOrchestra\FileBundle\Model\File — use relativePath for image filters, falls back to uri #}
+    {%- set src = src.relativePath|default(src.uri|default(src)) -%}
 
     {%- set url = (src|default('')|fill(width, height)) -%}
     {%- set webp = (src|default('')|fill(width, height, {output: {format: 'webp'}})) -%}