feature #47462 [Mime] Simplify adding Parts to an Email (fabpot)

This PR was merged into the 6.2 branch.

Discussion
----------

[Mime] Simplify adding Parts to an Email

| Q             | A
| ------------- | ---
| Branch?       | 6.2
| Bug fix?      | no
| New feature?  | yes <!-- please update src/**/CHANGELOG.md files -->
| Deprecations? | no <!-- please update UPGRADE-*.md and src/**/CHANGELOG.md files -->
| Tickets       | n/a <!-- prefix each issue number with "Fix #", no need to create an issue if none exist, explain below instead -->
| License       | MIT
| Doc PR        |

While fixing some MIME bugs, I realized we have a substantial cyclomatic complexity due to the attach/attachFromPath/embed/embedFromPath/attachPart methods on the Email class.

This PR simplifies all of that and introduces a way to have a file for TextPart as well (via the new `file://` notation) and it keeps the lazy-loading feature which was why those methods were introduced in the first place.

From now, I've kept all the methods, but I'm wondering if we should deprecate all of them and only keep `attachPart()` (which I would like to rename `addPart()`).

Commits
-------

0a29d9703e [Mime] Simplify adding Parts to an Email

Author: fabpot

Tests/Mime/TemplatedEmailTest.php

@@ -74,10 +74,16 @@ public function testSymfonySerialize()
     "htmlCharset": null,
     "attachments": [
         {
+            "filename": "test.txt",
+            "mediaType": "application",
             "body": "Some Text file",
+            "charset": null,
+            "subtype": "octet-stream",
+            "disposition": "attachment",
             "name": "test.txt",
-            "content-type": null,
-            "inline": false
+            "encoding": "base64",
+            "headers": [],
+            "class": "Symfony\\\Component\\\Mime\\\Part\\\DataPart"
         }
     ],
     "headers": {

composer.json

@@ -43,7 +43,7 @@
         "symfony/security-core": "^5.4|^6.0",
         "symfony/security-csrf": "^5.4|^6.0",
         "symfony/security-http": "^5.4|^6.0",
-        "symfony/serializer": "^5.4|^6.0",
+        "symfony/serializer": "^6.2",
         "symfony/stopwatch": "^5.4|^6.0",
         "symfony/console": "^5.4|^6.0",
         "symfony/expression-language": "^5.4|^6.0",