[Twig Bridge][Mime] Allow attachment name to be set for inline images

aleho · aleho · commit 67a84c1faefe · 2025-04-07T09:34:34.000+02:00
Using a recommended Twig setup this would normally result in attachment
names like '@assets/img/file.png' which might not be a good file name
to expose to email clients. This allows the name to be specified,
analogous to `attach`.
diff --git a/src/Symfony/Bridge/Twig/Mime/WrappedTemplatedEmail.php b/src/Symfony/Bridge/Twig/Mime/WrappedTemplatedEmail.php
@@ -39,14 +39,16 @@ public function toName(): string
      *                                 some Twig namespace for email images (e.g. '@email/images/logo.png').
      * @param string|null $contentType The media type (i.e. MIME type) of the image file (e.g. 'image/png').
      *                                 Some email clients require this to display embedded images.
+     * @param string|null $name        A custom file name that overrides the original name (filepath) of the image
      */
-    public function image(string $image, ?string $contentType = null): string
+    public function image(string $image, ?string $contentType = null, ?string $name = null): string
     {
         $file = $this->twig->getLoader()->getSourceContext($image);
         $body = $file->getPath() ? new File($file->getPath()) : $file->getCode();
-        $this->message->addPart((new DataPart($body, $image, $contentType))->asInline());
+        $name = $name ?: $image;
+        $this->message->addPart((new DataPart($body, $name, $contentType))->asInline());
 
-        return 'cid:'.$image;
+        return 'cid:'.$name;
     }
 
     /**
