本文详解如何使用 AWS SDK for PHP 批量将多个手机号（SMS 端点）订阅至同一 SNS 主题，通过循环调用 subscribe() 方法实现高效、可控的批量注册，并附完整可运行代码与关键注意事项。
本文详解如何使用 aws sdk for php 批量将多个手机号（sms 端点）订阅至同一 sns 主题，通过循环调用 `subscribe()` 方法实现高效、可控的批量注册，并附完整可运行代码与关键注意事项。
在 Amazon SNS 中，单次 subscribe() 调用仅支持一个端点（如一个手机号），无法原生批量提交多个 SMS 订阅请求。但实际业务中（例如向运营团队、通知组或客户群发送统一告警/营销短信），常需将数十甚至上百个手机号快速加入同一主题。此时，最直接、可靠且符合 AWS 最佳实践的方式是：将手机号组织为数组，结合 foreach 循环逐个调用 subscribe() —— 既复用官方 SDK 的健壮逻辑，又避免引入复杂异步协调或自定义批处理层。
以下是优化后的完整 PHP 示例代码，已移除冗余注释片段、增强可读性，并添加关键说明：
<?php
require 'vendor/autoload.php';
use Aws\Sns\SnsClient;
use Aws\Exception\AwsException;
// 初始化 SNS 客户端（建议使用 IAM 角色或环境变量管理凭证，而非硬编码 profile）
$snsClient = new SnsClient([
'region' => 'us-east-1', // 请替换为您的主题所在区域
'version' => '2010-03-31',
// 推荐：通过环境变量或 IAM 角色认证，避免 profile 配置
// 'credentials' => [
// 'key' => 'YOUR_ACCESS_KEY',
// 'secret' => 'YOUR_SECRET_KEY',
// ],
]);
$protocol = 'sms';
$topicArn = 'arn:aws:sns:us-east-1:111122223333:MyTopic'; // 替换为您的真实 Topic ARN
// ✅ 批量手机号列表：确保格式为 E.164 标准（含国家代码，无空格/横线）
$phoneNumbers = [
'+1XXX5550100',
'+2XXX5550100',
'+3XXX5550100',
// 可继续追加更多号码...
];
echo "开始批量订阅 {$topicArn} 主题...\n";
$successCount = 0;
$errors = [];
foreach ($phoneNumbers as $index => $phoneNumber) {
try {
$result = $snsClient->subscribe([
'Protocol' => $protocol,
'Endpoint' => $phoneNumber,
'TopicArn' => $topicArn,
'ReturnSubscriptionArn' => true, // 强烈建议启用，便于后续管理
]);
$subscriptionArn = $result['SubscriptionArn'] ?? 'pending confirmation';
echo "[✓] {$phoneNumber} → {$subscriptionArn}\n";
$successCount++;
// ⚠️ AWS 建议：每秒不超过 10 次订阅请求，避免限流
// 如需处理大量号码（>50），可在此处添加 usleep(100000) 实现轻量节流
// usleep(100000); // 暂停 100ms
} catch (AwsException $e) {
$errorCode = $e->getAwsErrorCode() ?: 'Unknown';
$errorMessage = $e->getMessage();
$errors[] = "{$phoneNumber}: [{$errorCode}] {$errorMessage}";
error_log("[SNS Subscribe Error] {$phoneNumber} - {$errorCode}: {$errorMessage}");
}
}
// ? 执行摘要
echo "\n=== 批量订阅完成 ===\n";
echo "成功订阅: {$successCount}/" . count($phoneNumbers) . "\n";
if (!empty($errors)) {
echo "失败详情:\n" . implode("\n", $errors) . "\n";
}关键注意事项：
- E.164 格式强制要求：所有手机号必须以 + 开头，后接国家代码及本地号码（如 +8613800138000），否则 SNS 将返回 InvalidParameter 错误；
- 地域一致性：$topicArn 中的区域（如 us-east-1）必须与 $snsClient 初始化时指定的 region 完全一致；
- 权限配置：执行账号需具备 sns:Subscribe 权限，且策略中明确允许目标 Topic ARN；
- 速率限制：SNS 默认限制每秒最多 10 次 Subscribe 请求。若需处理数百号码，建议添加 usleep() 节流，或改用 SQS + Lambda 异步队列模式；
- 确认机制：SMS 订阅默认为“待确认”状态（PendingConfirmation），用户需回复 YES 至 SNS 短信网关方可激活；可通过 sns:ConfirmSubscription API 或控制台手动确认（不适用于 SMS）；
- 错误处理增强：生产环境应捕获具体错误码（如 AuthorizationError、Throttling、InvalidParameter），并设计重试或告警机制。
该方案简洁、稳定、完全兼容 AWS 官方 SDK，是当前批量管理 SMS 订阅最推荐的工程实践。
