Amazon SES API と AWS SDK for PHP バージョン 3 を使用したカスタムメールテンプレートの作成 - AWS SDK for PHP

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon SES API と AWS SDK for PHP バージョン 3 を使用したカスタムメールテンプレートの作成

Amazon Simple Email Service (Amazon SES) では、テンプレートを使用して受取人ごとにパーソナライズされた E メールを送信できます。テンプレートには、件名、E メール本文のテキストパートと HTML パートが含まれています。件名および本文セクションには、受取人ごとにパーソナライズされたユニークな値を含めることもできます。

詳細については、「Amazon Simple Email Service デベロッパーガイド」の「Amazon SES を使用してパーソナライズされた E メールを送信する」を参照してください。

以下の例では、次の方法を示しています。

  • を使用して E メールテンプレートを作成しますCreateTemplate

  • を使用してすべての E メールテンプレートを一覧表示しますListTemplates

  • を使用して E メールテンプレートを取得しますGetTemplate

  • を使用して E メールテンプレートを更新しますUpdateTemplate

  • を使用して E メールテンプレートを削除しますDeleteTemplate

  • を使用してテンプレート化された E メールを送信しますSendTemplatedEmail

のすべてのサンプルコードAWS SDK for PHPは、 にあります GitHub

認証情報

サンプルコードを実行する前に、AWS の認証情報を設定します (認証情報 を参照)。AWS SDK for PHP からのインポート (基本的な使用法 を参照)。

Amazon SES の使用の詳細については、「Amazon SES デベロッパーガイド」を参照してください。

E メールテンプレートを作成する

パーソナライズされた E メールメッセージを送信するテンプレートを作成するには、 CreateTemplateオペレーションを使用します。このテンプレートは、テンプレートが追加された AWS リージョンでのメッセージの送信が承認されたどのアカウントでも使用できます。

注記

Amazon SES は HTML を検証しないため、E メールを送信する前に HtmlPart が有効であることを確認してください。

インポート

require 'vendor/autoload.php'; use Aws\Exception\AwsException;

サンプルコード

$SesClient = new Aws\Ses\SesClient([ 'profile' => 'default', 'version' => '2010-12-01', 'region' => 'us-east-2' ]); $name = 'Template_Name'; $html_body = '<h1>AWS Amazon Simple Email Service Test Email</h1>' . '<p>This email was sent with <a href="https://aws.amazon.com/ses/">' . 'Amazon SES</a> using the <a href="https://aws.amazon.com/sdk-for-php/">' . 'AWS SDK for PHP</a>.</p>'; $subject = 'Amazon SES test (AWS SDK for PHP)'; $plaintext_body = 'This email was send with Amazon SES using the AWS SDK for PHP.'; try { $result = $SesClient->createTemplate([ 'Template' => [ 'HtmlPart' => $html_body, 'SubjectPart' => $subject, 'TemplateName' => $name, 'TextPart' => $plaintext_body, ], ]); var_dump($result); } catch (AwsException $e) { // output error message if fails echo $e->getMessage(); echo "\n"; }

E メールテンプレートを取得する

件名、HTML 本文、プレーンテキストを含む既存の E メールテンプレートの内容を表示するには、 GetTemplateオペレーションを使用します。のみ必須 TemplateName です。

インポート

require 'vendor/autoload.php'; use Aws\Exception\AwsException;

サンプルコード

$SesClient = new Aws\Ses\SesClient([ 'profile' => 'default', 'version' => '2010-12-01', 'region' => 'us-east-2' ]); $name = 'Template_Name'; try { $result = $SesClient->getTemplate([ 'TemplateName' => $name, ]); var_dump($result); } catch (AwsException $e) { // output error message if fails echo $e->getMessage(); echo "\n"; }

すべての E メールテンプレートをリストする

現在のAWSリージョンAWS アカウントで に関連付けられているすべての E メールテンプレートのリストを取得するには、 ListTemplatesオペレーションを使用します。

インポート

require 'vendor/autoload.php'; use Aws\Exception\AwsException;

サンプルコード

$SesClient = new Aws\Ses\SesClient([ 'profile' => 'default', 'version' => '2010-12-01', 'region' => 'us-east-2' ]); try { $result = $SesClient->listTemplates([ 'MaxItems' => 10, ]); var_dump($result); } catch (AwsException $e) { // output error message if fails echo $e->getMessage(); echo "\n"; }

E メールテンプレートを更新する

件名、HTML 本文、プレーンテキストなど、特定の E メールテンプレートの内容を変更するには、 UpdateTemplateオペレーションを使用します。

インポート

require 'vendor/autoload.php'; use Aws\Exception\AwsException;

サンプルコード

$SesClient = new Aws\Ses\SesClient([ 'profile' => 'default', 'version' => '2010-12-01', 'region' => 'us-east-2' ]); $name = 'Template_Name'; $html_body = '<h1>AWS Amazon Simple Email Service Test Email</h1>' . '<p>This email was sent with <a href="https://aws.amazon.com/ses/">' . 'Amazon SES</a> using the <a href="https://aws.amazon.com/sdk-for-php/">' . 'AWS SDK for PHP</a>.</p>'; $subject = 'Amazon SES test (AWS SDK for PHP)'; $plaintext_body = 'This email was send with Amazon SES using the AWS SDK for PHP.'; try { $result = $SesClient->updateTemplate([ 'Template' => [ 'HtmlPart' => $html_body, 'SubjectPart' => $subject, 'TemplateName' => $name, 'TextPart' => $plaintext_body, ], ]); var_dump($result); } catch (AwsException $e) { // output error message if fails echo $e->getMessage(); echo "\n"; }

E メールテンプレートを削除する

特定の E メールテンプレートを削除するには、 DeleteTemplateオペレーションを使用します。必要なのは だけです TemplateName。

インポート

require 'vendor/autoload.php'; use Aws\Exception\AwsException;

サンプルコード

$SesClient = new Aws\Ses\SesClient([ 'profile' => 'default', 'version' => '2010-12-01', 'region' => 'us-east-2' ]); $name = 'Template_Name'; try { $result = $SesClient->deleteTemplate([ 'TemplateName' => $name, ]); var_dump($result); } catch (AwsException $e) { // output error message if fails echo $e->getMessage(); echo "\n"; }

テンプレートを使用して E メールを送信する

テンプレートを使用して受信者に E メールを送信するには、 SendTemplatedEmailオペレーションを使用します。

インポート

require 'vendor/autoload.php'; use Aws\Exception\AwsException;

サンプルコード

$SesClient = new Aws\Ses\SesClient([ 'profile' => 'default', 'version' => '2010-12-01', 'region' => 'us-east-2' ]); $template_name = 'Template_Name'; $sender_email = 'email_address'; $recipient_emails = ['email_address']; try { $result = $SesClient->sendTemplatedEmail([ 'Destination' => [ 'ToAddresses' => $recipient_emails, ], 'ReplyToAddresses' => [$sender_email], 'Source' => $sender_email, 'Template' => $template_name, 'TemplateData' => '{ }' ]); var_dump($result); } catch (AwsException $e) { // output error message if fails echo $e->getMessage(); echo "\n"; }