Amazon SES メールトランスポート

Aws.AmazonSesApi は、Amazon SES API v2 の SendEmail オペレーションでメールを送信します。 config/email.php (レガシー構成では app/Config/email.php) で、メールプロファイルのトランスポートとして設定します。

php

class EmailConfig
{
    /**
     * Default email profile values.
     *
     * @var array
     */
    public $default = [
        'transport' => 'Aws.AmazonSesApi',
        'from' => 'example@example.com',
        'charset' => 'utf-8',
        'headerCharset' => 'utf-8',
    ];
}

SES クライアントは Aws の設定で作成されます。メールプロファイルの次のキーは、その設定を上書きします。

キー	説明
`region`	SES の AWS リージョン。
`version`	API バージョン。
`key`、`secret`	アクセスキー ID とシークレットアクセスキー。設定しない場合は、`Aws` の設定の認証情報か、デフォルトの認証情報プロバイダーチェーンが使われます。
`token`	一時的な `key` と `secret` のセッショントークン。
`endpoint`	SES のエンドポイント URL (ローカルのエミュレーター用など)。

トランスポートは、テキストと HTML のパート、To、Cc、Bcc、Reply-To のアドレス、そして添付ファイルを送信します。CakeEmail::send() は SES のメッセージ ID を id として返します。

php

App::uses('CakeEmail', 'Network/Email');

$email = new CakeEmail('default');
$result = $email->to('user@example.com')
    ->subject('Welcome')
    ->send('Hello!');

$messageId = $result['id'];

送信元アドレス (from) は SES で検証済みでなければなりません。

メーラーの DSN

メールプロファイルの 'dsn' キーに対応した pieceofcake2/cakephp 2.12.7 以降では、 Symfony の Amazon Mailer ブリッジの形式の DSN で、たとえば環境変数 MAILER_DSN からトランスポートを設定できます。プラグインを bootstrap とともに読み込むと、CakeEmail::setDsnClassMap() で ses のスキームが登録されます (S3 ストリームラッパーも登録されます)。

php

// config/bootstrap.php
CakePlugin::load('Aws', ['bootstrap' => true]);

php

class EmailConfig
{
    /**
     * Default email profile values.
     *
     * @var array
     */
    public $default = [
        'transport' => 'Mail',
        'from' => 'example@example.com',
        'dsn' => null,
    ];

    /**
     * Reads the transport from MAILER_DSN.
     */
    public function __construct()
    {
        $this->default['dsn'] = env('MAILER_DSN');
    }
}

DSN	設定
`ses+api://ACCESS_KEY:SECRET_KEY@default?region=eu-west-1`	`Aws.AmazonSesApi`、`key`、`secret`、`region`
`ses+https://ACCESS_KEY:SECRET_KEY@default`、`ses://...`	同じ (`Aws.AmazonSesApi`)
`ses+api://default?region=eu-west-1`	`Aws` の設定の認証情報か、デフォルトの認証情報プロバイダーチェーンを使う `Aws.AmazonSesApi`
`ses+smtp://USERNAME:PASSWORD@default?region=eu-west-1`、`ses+smtps://...`	SES の SMTP 認証情報で `ssl://email-smtp.eu-west-1.amazonaws.com` のポート 465 に接続するコアの `Smtp` トランスポート

?session_token=... は、一時的な認証情報のセッショントークン token を設定します。
default 以外のホストはエンドポイントになります (ses+api://KEY:SECRET@localhost:4566 は https://localhost:4566 を使います)。ses+smtp では SMTP のホストになります。
DSN に region がない場合は、プロファイルの region、Aws の設定の region、AWS_REGION、 AWS_DEFAULT_REGION の順に使われ、どれも設定されていなければ eu-west-1 (Symfony のデフォルト) になります。
AWS のシークレットキーにある / と + はそのままでかまいません。% は %25、? は %3F とエンコードしてください。
ses+api と ses+https はどちらも、このトランスポートの SES API v2 の SendEmail オペレーションを使います。 Symfony での区別 (シンプルなメッセージと raw メッセージ) はありません。ses+smtp の ping_threshold は無視されます。
DSN から読み取ったキーはプロファイルの同じキーを置き換え、ほかのキー (from、charset など) はそのまま残ります。 MAILER_DSN が設定されていなければ無視されます。
DSN に対応していない pieceofcake2/cakephp のリリースでは、bootstrap は登録を行わず、'dsn' キーは無視されます。

Amazon SES メールトランスポート ​

メーラーの DSN ​

Amazon SES メールトランスポート

メーラーの DSN