本文介绍了如何使用 Amazon SNS 服务通过 PHP SDK 发送 SMS 消息，并重点讲解了如何利用 CloudWatch API 获取 SMS 消息的投递状态，包括成功或失败的信息。通过监控 CloudWatch 日志，开发者可以实时追踪 SMS 消息的发送情况，从而更好地管理和优化短信服务。
Amazon Simple Notification Service (SNS) 是一种快速、灵活、完全托管的推送消息服务，可以用于发送 SMS 消息。然而，直接通过 SNS 获取 SMS 投递状态并非直接可行。本文将介绍如何利用 Amazon CloudWatch API 来间接获取 SMS 消息的投递状态。
使用 Amazon SNS 发送 SMS
首先，我们需要使用 Amazon PHP SDK 来发送 SMS 消息。以下是一个示例代码：
<?php
require 'vendor/autoload.php';
use Aws\Sns\SnsClient;
$sdk = new SnsClient([
'region' => 'eu-west-1', // 替换为你的 AWS 区域
'version' => 'latest',
'credentials' => [
'key' => 'YOUR_AWS_ACCESS_KEY_ID', // 替换为你的 AWS Access Key ID
'secret' => 'YOUR_AWS_SECRET_ACCESS_KEY' // 替换为你的 AWS Secret Access Key
]
]);
$result = $sdk->publish([
'Message' => 'This is a test message.',
'PhoneNumber' => '+123456789', // 替换为你的目标电话号码，包含国家码
'MessageAttributes' => [
'AWS.SNS.SMS.SenderID' => [
'DataType' => 'String',
'StringValue' => 'MySenderID' // 可选，替换为你的自定义 Sender ID
]
]
]);
print_r( $result );
?>代码解释：
- 引入 SDK: require 'vendor/autoload.php'; 引入 Composer 自动加载器，确保可以使用 AWS PHP SDK。
- 创建 SNS 客户端: new Aws\Sns\SnsClient([...]) 创建一个 SNS 客户端实例，需要配置 AWS 区域、版本和凭证。
-
publish() 方法: $sdk->publish([...]) 调用 publish() 方法发送 SMS 消息。
- Message: SMS 消息的内容。
- PhoneNumber: 接收 SMS 消息的电话号码，必须包含国家码。
- MessageAttributes: 可选参数，用于设置消息属性，例如 SenderID。
注意事项：
- 确保已安装 AWS PHP SDK。可以使用 Composer 安装：composer require aws/aws-sdk-php
- 替换 YOUR_AWS_ACCESS_KEY_ID 和 YOUR_AWS_SECRET_ACCESS_KEY 为你的 AWS 凭证。
- 替换 eu-west-1 为你的 AWS 区域。
- 电话号码必须包含国家码，例如 +123456789。
- SenderID 是可选的，但建议设置，以便接收者可以识别消息来源。
获取 SMS 投递状态
虽然 SNS 本身不直接提供投递状态的回调 URL，但我们可以通过 CloudWatch Logs 来获取这些信息。
步骤：
启用 SNS 消息投递状态日志： 在 AWS 控制台中，进入 SNS 服务，选择你的 SNS 主题，找到 "Delivery status logging" 部分，启用 SMS 消息的日志记录。你需要指定一个 IAM 角色，该角色需要具有写入 CloudWatch Logs 的权限。
使用 CloudWatch API 获取日志事件： 使用 CloudWatch API (例如 GetLogEvents) 来读取日志组中的日志。
以下是一个使用 AWS PHP SDK 获取 CloudWatch Logs 的示例代码：
<?php
require 'vendor/autoload.php';
use Aws\CloudWatchLogs\CloudWatchLogsClient;
$client = new CloudWatchLogsClient([
'region' => 'eu-west-1', // 替换为你的 AWS 区域
'version' => 'latest',
'credentials' => [
'key' => 'YOUR_AWS_ACCESS_KEY_ID', // 替换为你的 AWS Access Key ID
'secret' => 'YOUR_AWS_SECRET_ACCESS_KEY' // 替换为你的 AWS Secret Access Key
]
]);
$logGroupName = '/aws/sns/sms-deliveries'; // SNS SMS 投递状态日志组名称
$logStreamName = 'YourLogStreamName'; // 替换为你的日志流名称，可以通过查询CloudWatch Logs找到
$result = $client->getLogEvents([
'logGroupName' => $logGroupName,
'logStreamName' => $logStreamName,
'startFromHead' => true, // 从日志流的开头开始读取
'limit' => 10 // 读取的最大日志事件数量
]);
foreach ($result['events'] as $event) {
echo $event['message'] . "\n";
// 解析日志消息，获取投递状态
// 例如，可以使用 json_decode() 解析 JSON 格式的日志消息
}
?>代码解释：
- 创建 CloudWatch Logs 客户端: new Aws\CloudWatchLogs\CloudWatchLogsClient([...]) 创建一个 CloudWatch Logs 客户端实例，需要配置 AWS 区域、版本和凭证。
-
getLogEvents() 方法: $client->getLogEvents([...]) 调用 getLogEvents() 方法获取日志事件。
- logGroupName: SNS SMS 投递状态日志组的名称，通常为 /aws/sns/sms-deliveries。
- logStreamName: 日志流的名称。你需要在 CloudWatch Logs 中找到对应的日志流名称。 日志流名称通常包含日期信息。
- startFromHead: 设置为 true 表示从日志流的开头开始读取。
- limit: 读取的最大日志事件数量。
- 解析日志消息: 遍历 $result['events']，每个 $event['message'] 包含一个日志消息。你需要解析这些消息来获取投递状态。 SNS SMS 投递状态日志通常是 JSON 格式。
注意事项：
- 确保已安装 AWS PHP SDK。
- 替换 YOUR_AWS_ACCESS_KEY_ID 和 YOUR_AWS_SECRET_ACCESS_KEY 为你的 AWS 凭证。
- 替换 eu-west-1 为你的 AWS 区域。
- 替换 YourLogStreamName 为你的日志流名称。
- 你需要根据 SNS 的日志格式来解析日志消息，提取投递状态信息。
总结
通过以上步骤，你可以使用 Amazon SNS 发送 SMS 消息，并利用 CloudWatch API 获取 SMS 消息的投递状态。 虽然这种方法不如直接的回调 URL 方便，但它是目前获取 SNS SMS 投递状态的主要方式。 你需要定期查询 CloudWatch Logs，并解析日志消息，才能实时监控 SMS 消息的发送情况。 此外，需要注意 IAM 角色权限的配置，确保 SNS 可以写入 CloudWatch Logs，并且你的应用程序可以读取 CloudWatch Logs。
