[11.x] Add ListManagementOptions in SES mail transport

[arifszn]

Description

Amazon SES provides a convenient feature allowing the inclusion and management of unsubscribe links and headers in outgoing emails by specifying a contact list name and an optional topic name. When the ListManagementOptions header is passed, it substitutes the {{amazonSESUnsubscribeUrl}} placeholder with a one-click unsubscribe link in the email body.

References:

• https://docs.aws.amazon.com/ses/latest/dg/sending-email-subscription-management.html
• https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-sesv2-2019-09-27.html#sendemail

Similar to symfony/symfony#53901, this PR proposes adding ListManagementOptions in the headers of SesTransport and SesV2Transport.

Usage

• Follow the AWS instructions to create a contact list

• Optional: add a topic to the list

• Add X-SES-LIST-MANAGEMENT-OPTIONS in the header

    /**
     * Get the message headers.
     */
    public function headers(): Headers
    {
        return new Headers(
            text: [
                'X-SES-LIST-MANAGEMENT-OPTIONS' => 'contactListName=MyContactList;topicName=MyTopic',
            ],
        );
    }

Upon merging this PR, a PR for updating doc will be submitted if necessary.

Note

While it's possible to utilize the options array within the ses configuration to include the ListManagementOptions header, it wouldn't offer the same level of dynamism.