Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

使用版本 3 在 Amazon SNS 中 适用于 PHP 的 Amazon SDK 管理主题

要向亚马逊简单队列服务 (Amazon SQS) Sim URLs ple Queue Service、HTTP/HTTPS Amazon SMS、电子邮件 Amazon Lambda或发送通知，您必须先创建一个主题来管理向该主题的所有订阅者发送消息的情况。

对于观察程序设计模式，此主题 (Topic) 类似于该主题 (Subject)。创建主题后，您可以添加在有消息发布到该主题时将自动通知的订阅者。

要了解有关订阅主题的更多信息，请参阅版本 3 的 Amazon SNS 适用于 PHP 的 Amazon SDK 中的订阅。

以下示例演示如何：

有关使用 Amazon SNS 的更多信息，请参阅用于消息传输状态的 Amazon SNS 主题属性。

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

凭证

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

创建主题

要创建主题，请使用CreateTopic操作。

您的每个主题名称都 Amazon Web Services 账户 必须是唯一的。

导入

require 'vendor/autoload.php';

use Aws\Exception\AwsException;
use Aws\Sns\SnsClient;

示例代码

$SnSclient = new SnsClient([
    'profile' => 'default',
    'region' => 'us-east-1',
    'version' => '2010-03-31'
]);

$topicname = 'myTopic';

try {
    $result = $SnSclient->createTopic([
        'Name' => $topicname,
    ]);
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    error_log($e->getMessage());
}

列出主题

要列出当前 Amazon 区域中最多 100 个现有主题，请使用ListTopics操作。

导入

require 'vendor/autoload.php';

use Aws\Exception\AwsException;
use Aws\Sns\SnsClient;

示例代码

$SnSclient = new SnsClient([
    'profile' => 'default',
    'region' => 'us-east-1',
    'version' => '2010-03-31'
]);

try {
    $result = $SnSclient->listTopics();
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    error_log($e->getMessage());
}

删除主题

要删除现有主题及其所有订阅，请使用DeleteTopic操作。

尚未传送至订阅者的任何消息也将删除。

导入

require 'vendor/autoload.php';

use Aws\Exception\AwsException;
use Aws\Sns\SnsClient;

示例代码

$SnSclient = new SnsClient([
    'profile' => 'default',
    'region' => 'us-east-1',
    'version' => '2010-03-31'
]);

$topic = 'arn:aws:sns:us-east-1:111122223333:MyTopic';

try {
    $result = $SnSclient->deleteTopic([
        'TopicArn' => $topic,
    ]);
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    error_log($e->getMessage());
}

获取主题属性

要检索单个现有主题的属性，请使用GetTopicAttributes操作。

导入

require 'vendor/autoload.php';

use Aws\Exception\AwsException;
use Aws\Sns\SnsClient;

示例代码

$SnSclient = new SnsClient([
    'profile' => 'default',
    'region' => 'us-east-1',
    'version' => '2010-03-31'
]);

$topic = 'arn:aws:sns:us-east-1:111122223333:MyTopic';

try {
    $result = $SnSclient->getTopicAttributes([
        'TopicArn' => $topic,
    ]);
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    error_log($e->getMessage());
}

设置主题属性

要更新单个现有主题的属性，请使用SetTopicAttributes操作。

您只能设置 Policy、DisplayName 和 DeliveryPolicy 属性。

导入

require 'vendor/autoload.php';

use Aws\Exception\AwsException;
use Aws\Sns\SnsClient;

示例代码

$SnSclient = new SnsClient([
    'profile' => 'default',
    'region' => 'us-east-1',
    'version' => '2010-03-31'
]);
$attribute = 'Policy | DisplayName | DeliveryPolicy';
$value = 'First Topic';
$topic = 'arn:aws:sns:us-east-1:111122223333:MyTopic';

try {
    $result = $SnSclient->setTopicAttributes([
        'AttributeName' => $attribute,
        'AttributeValue' => $value,
        'TopicArn' => $topic,
    ]);
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    error_log($e->getMessage());
}