feature #59612 [Mailer] Add attachments support for Sweego Mailer Bridge (welcoMattic)

fabpot · fabpot · commit 728d37170f46 · 2025-01-27T11:39:30.000+01:00
This PR was merged into the 7.3 branch. Discussion ---------- [Mailer] Add attachments support for Sweego Mailer Bridge | Q | A | ------------- | --- | Branch? | 7.3 | Bug fix? | no | New feature? | yes | Deprecations? | no  | Issues | Fix #...  | License | MIT Sweego has added support for attachments on their API. This PR include it in the Bridge. I tested it in a real application with .txt, .pdf and .png files. Mails are delivered with attachments. As no other Bridge has tests for attachments AFAIK, I didn't write them. It could be part of a dedicated PR. Commits ------- b5b76fc feat(sweego): Add attachments support for Sweego Mailer Bridge
diff --git a/src/Symfony/Component/Mailer/Bridge/Sweego/CHANGELOG.md b/src/Symfony/Component/Mailer/Bridge/Sweego/CHANGELOG.md
@@ -1,6 +1,11 @@
 CHANGELOG
 =========
 
+7.3
+---
+
+ * Add support for attachments
+
 7.2
 ---
 
diff --git a/src/Symfony/Component/Mailer/Bridge/Sweego/README.md b/src/Symfony/Component/Mailer/Bridge/Sweego/README.md
@@ -24,6 +24,30 @@ MAILER_DSN=sweego+api://API_KEY@default
 where:
  - `API_KEY` is your Sweego API Key
 
+Features
+--------
+
+### Attachments
+
+The bridge supports both regular attachments and inline attachments (for embedding images in HTML emails):
+
+```php
+use Symfony\Component\Mime\Email;
+
+$email = new Email();
+$email
+    ->to('to@example.com')
+    ->from('from@example.com')
+    ->subject('Email with attachments')
+    ->text('Here is the text version')
+    ->html('<p>Here is the HTML content</p>')
+    // Regular attachment
+    ->attach('Hello world!', 'test.txt', 'text/plain')
+    // Inline attachment (embedded image)
+    ->embed(fopen('image.jpg', 'r'), 'image.jpg', 'image/jpeg')
+;
+```
+
 Webhook
 -------
 
diff --git a/src/Symfony/Component/Mailer/Bridge/Sweego/Transport/SweegoApiTransport.php b/src/Symfony/Component/Mailer/Bridge/Sweego/Transport/SweegoApiTransport.php
@@ -100,6 +100,10 @@ private function getPayload(Email $email, Envelope $envelope): array
             $payload['message-html'] = $email->getHtmlBody();
         }
 
+        if ($email->getAttachments()) {
+            $payload['attachments'] = $this->getAttachments($email);
+        }
+
         if ($payload['headers'] = $this->prepareHeaders($email->getHeaders())) {
             if (\count($payload['headers']) > 5) {
                 throw new InvalidArgumentException('Sweego API supports up to 5 headers.');
@@ -111,6 +115,30 @@ private function getPayload(Email $email, Envelope $envelope): array
         return $payload;
     }
 
+    private function getAttachments(Email $email): array
+    {
+        $attachments = [];
+        foreach ($email->getAttachments() as $attachment) {
+            $headers = $attachment->getPreparedHeaders();
+            $filename = $headers->getHeaderParameter('Content-Disposition', 'filename');
+            $disposition = $headers->getHeaderBody('Content-Disposition');
+
+            $att = [
+                'content' => $attachment->bodyToString(),
+                'filename' => $filename,
+                'disposition' => $disposition,
+            ];
+
+            if ('inline' === $disposition) {
+                $att['content_id'] = $attachment->hasContentId() ? $attachment->getContentId() : $filename;
+            }
+
+            $attachments[] = $att;
+        }
+
+        return $attachments;
+    }
+
     private function prepareHeaders(Headers $headers): array
     {
         $headersPrepared = [];
