使用 Amazon SES API 和 适用于 PHP 的 Amazon SDK 版本 3 创建和管理电子邮件规则 - 适用于 PHP 的 Amazon SDK
凭证创建接收规则集创建接收规则描述接收规则集描述接收规则列出所有接收规则集更新接收规则删除接收规则集删除接收规则
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用 Amazon SES API 和 适用于 PHP 的 Amazon SDK 版本 3 创建和管理电子邮件规则

除了发送电子邮件外，您还可以使用 Amazon Simple Email Service (Amazon SES) 来接收电子邮件。您可以通过接收规则来指定 Amazon SES 在为您拥有的电子邮件地址或域接收电子邮件后，将对这些邮件执行哪些操作。规则可以向其他 Amazon 服务发送电子邮件，包括但不限于 Amazon S3、Amazon SNS 或。 Amazon Lambda

有关更多信息，请参阅为 Amazon SES 电子邮件接收管理接收规则集和为 Amazon SES 电子邮件接收管理接收规则。

以下示例演示如何：

的所有示例代码都可以在此 适用于 PHP 的 Amazon SDK 处找到 GitHub。

凭证

在运行示例代码之前，请配置您的 Amazon 证书，如中所述凭证。然后导入 适用于 PHP 的 Amazon SDK，如中所述基本用法。

有关使用 Amazon SES 的更多信息，请参阅 Amazon SES 开发人员指南。

创建接收规则集

接收规则集包含接收规则的集合。您必须至少有一个接收规则集与您的账户关联，然后才能创建接收规则。要创建收据规则集，请提供唯一规则集 RuleSetName 并使用CreateReceiptRuleSet操作。

导入 


require 'vendor/autoload.php';

use Aws\Exception\AwsException;

示例代码 

$SesClient = new Aws\Ses\SesClient([
    'profile' => 'default',
    'version' => '2010-12-01',
    'region' => 'us-east-2'
]);

$name = 'Rule_Set_Name';

try {
    $result = $SesClient->createReceiptRuleSet([
        'RuleSetName' => $name,
    ]);
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    echo $e->getMessage();
    echo "\n";
}

创建接收规则

通过添加接收规则到现有接收规则集，控制传入电子邮件。此示例展示了如何创建将传入消息发送到 Amazon S3 存储桶的接收规则，不过您也可以将消息发送到 Amazon SNS 和 Amazon Lambda。要创建接收规则， RuleSetName 请为CreateReceiptRule操作提供规则和。

导入 


require 'vendor/autoload.php';

use Aws\Exception\AwsException;

示例代码 

$SesClient = new Aws\Ses\SesClient([
    'profile' => 'default',
    'version' => '2010-12-01',
    'region' => 'us-east-2'
]);

$rule_name = 'Rule_Name';
$rule_set_name = 'Rule_Set_Name';
$s3_bucket = 'Bucket_Name';

try {
    $result = $SesClient->createReceiptRule([
        'Rule' => [
            'Actions' => [
                [
                    'S3Action' => [
                        'BucketName' => $s3_bucket,
                    ],
                ],
            ],
            'Name' => $rule_name,
            'ScanEnabled' => true,
            'TlsPolicy' => 'Optional',
            'Recipients' => ['<string>']
        ],
        'RuleSetName' =>  $rule_set_name,

     ]);
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    echo $e->getMessage();
    echo "\n";
}

描述接收规则集

每秒一次，返回指定接收规则集的详细信息。要使用该DescribeReceiptRuleSet操作，请提供 RuleSetName。

导入 


require 'vendor/autoload.php';

use Aws\Exception\AwsException;

示例代码 

$SesClient = new Aws\Ses\SesClient([
    'profile' => 'default',
    'version' => '2010-12-01',
    'region' => 'us-east-2'
]);

$name = 'Rule_Set_Name';

try {
    $result = $SesClient->describeReceiptRuleSet([
        'RuleSetName' => $name,
    ]);
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    echo $e->getMessage();
    echo "\n";
}

描述接收规则

返回指定接收规则的详细信息。要使用该DescribeReceiptRule操作，请提供 RuleName 和 RuleSetName。

导入 


require 'vendor/autoload.php';

use Aws\Exception\AwsException;

示例代码 

$SesClient = new Aws\Ses\SesClient([
    'profile' => 'default',
    'version' => '2010-12-01',
    'region' => 'us-east-2'
]);

$rule_name = 'Rule_Name';
$rule_set_name = 'Rule_Set_Name';

try {
    $result = $SesClient->describeReceiptRule([
        'RuleName' => $rule_name,
        'RuleSetName' => $rule_set_name,
    ]);
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    echo $e->getMessage();
    echo "\n";
}

列出所有接收规则集

要列出当前 Amazon 区域 Amazon Web Services 账户 中存在的接收规则集，请使用ListReceiptRuleSets操作。

导入 


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->listReceiptRuleSets();
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    echo $e->getMessage();
    echo "\n";
}

更新接收规则

此示例向您展示如何更新向 Amazon Lambda 函数发送传入消息的接收规则，但您也可以向 Amazon SNS 和 Amazon S3 发送消息。要使用该UpdateReceiptRule操作，请提供新的接收规则和 RuleSetName。

导入 


require 'vendor/autoload.php';

use Aws\Exception\AwsException;

示例代码 

$SesClient = new Aws\Ses\SesClient([
    'profile' => 'default',
    'version' => '2010-12-01',
    'region' => 'us-east-2'
]);

$rule_name = 'Rule_Name';
$rule_set_name = 'Rule_Set_Name';
$lambda_arn = 'Amazon Resource Name (ARN) of the AWS Lambda function';
$sns_topic_arn = 'Amazon Resource Name (ARN) of the Amazon SNS topic';

try {
    $result = $SesClient->updateReceiptRule([
        'Rule' => [
            'Actions' => [
                'LambdaAction' => [
                    'FunctionArn' => $lambda_arn,
                    'TopicArn' => $sns_topic_arn,
                ],
            ],
            'Enabled' => true,
            'Name' => $rule_name,
            'ScanEnabled' => false,
            'TlsPolicy' => 'Require',
        ],
        'RuleSetName' => $rule_set_name,
    ]);
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    echo $e->getMessage();
    echo "\n";
}

删除接收规则集

删除当前未禁用的指定接收规则集。这还会删除其中包含的所有接收规则。要删除接收规则集， RuleSetName 请向DeleteReceiptRuleSet操作提供。

导入 


require 'vendor/autoload.php';

use Aws\Exception\AwsException;

示例代码 

$SesClient = new Aws\Ses\SesClient([
    'profile' => 'default',
    'version' => '2010-12-01',
    'region' => 'us-east-2'
]);

$name = 'Rule_Set_Name';

try {
    $result = $SesClient->deleteReceiptRuleSet([
        'RuleSetName' => $name,
    ]);
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    echo $e->getMessage();
    echo "\n";
}

删除接收规则

要删除指定的接收规则，请为DeleteReceiptRule操作提供 RuleName 和 RuleSetName 。

导入 


require 'vendor/autoload.php';

use Aws\Exception\AwsException;

示例代码 

$SesClient = new Aws\Ses\SesClient([
    'profile' => 'default',
    'version' => '2010-12-01',
    'region' => 'us-east-2'
]);

$rule_name = 'Rule_Name';
$rule_set_name = 'Rule_Set_Name';

try {
    $result = $SesClient->deleteReceiptRule([
        'RuleName' => $rule_name,
        'RuleSetName' => $rule_set_name,
    ]);
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    echo $e->getMessage();
    echo "\n";
}