[9.x] Ability to attach an array of files in MailMessage (#43080)

* Ability to attach an array of files in MailMessage

Passing a filepath or an array of filepaths will now attach one or multiple files in mail.

* Update Mailable.php

* created attachMany method instead of using attach

The method will take filename, array of filenames or attachable object as input and modify it to pass through current attach method.

* fixed typo

* formatting

* add tests

* formatting

* formatting

Co-authored-by: Tim MacDonald <[email protected]>

Author: Illusionist3886

src/Illuminate/Mail/Mailable.php

@@ -890,6 +890,25 @@ public function attach($file, array $options = [])
         return $this;
     }
 
+    /**
+     * Attach multiple files to the message.
+     *
+     * @param  array  $files
+     * @return $this
+     */
+    public function attachMany($files)
+    {
+        foreach ($files as $file => $options) {
+            if (is_int($file)) {
+                $this->attach($options);
+            } else {
+                $this->attach($file, $options);
+            }
+        }
+
+        return $this;
+    }
+
     /**
      * Attach a file to the message from storage.
      *

tests/Mail/MailMailableTest.php

@@ -497,6 +497,43 @@ public function testMailableTagGetsSent()
         $this->assertStringContainsString('X-Tag: foo', $sentMessage->toString());
     }
 
+    public function testItCanAttachMultipleFiles()
+    {
+        $mailable = new WelcomeMailableStub;
+
+        $mailable->attachMany([
+            '/forge.svg',
+            '/vapor.svg' => ['as' => 'Vapor Logo.svg', 'mime' => 'text/css'],
+            new class() implements Attachable
+            {
+                public function toMailAttachment()
+                {
+                    return Attachment::fromPath('/foo.jpg')->as('bar')->withMime('image/png');
+                }
+            },
+        ]);
+
+        $this->assertCount(3, $mailable->attachments);
+        $this->assertSame([
+            'file' => '/forge.svg',
+            'options' => [],
+        ], $mailable->attachments[0]);
+        $this->assertSame([
+            'file' => '/vapor.svg',
+            'options' => [
+                'as' => 'Vapor Logo.svg',
+                'mime' => 'text/css',
+            ],
+        ], $mailable->attachments[1]);
+        $this->assertSame([
+            'file' => '/foo.jpg',
+            'options' => [
+                'as' => 'bar',
+                'mime' => 'image/png',
+            ],
+        ], $mailable->attachments[2]);
+    }
+
     public function testItAttachesFilesViaAttachableContractFromPath()
     {
         $mailable = new WelcomeMailableStub;