短信
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 短信

PHP SDK 2.0

最近更新时间：2020-09-23 17:12:05

我的收藏

本页目录：

SDK 功能简介

目前腾讯云短信为客户提供国内短信和国际/港澳台短信服务，腾讯云短信 SDK 支持以下操作：
国内短信
国际/港澳台短信
指定模板单发短信
指定模板群发短信
拉取短信回执和短信回复状态
指定模板单发短信
指定模板群发短信
拉取短信回执
说明
群发短信 一次群发请求最多支持200个号码，如对号码数量有特殊需求请联系腾讯云短信技术支持（QQ：3012203387）。
拉取短信回执 该功能默认关闭。您可以根据实际需求联系腾讯云短信技术支持（QQ：3012203387）开通，实现批量拉取短信回执。

SDK 使用指南

相关资料

各个接口及其参数的详情介绍请参见 API 指南 、SDK 文档 和 错误码。

前提条件

在使用 SDK 前，您需要准备以下信息：
获取 SDKAppID 和 AppKey 云短信应用 SDKAppID 和 AppKey 可在 短信控制台 的应用信息里获取。如您尚未添加应用，请登录 短信控制台 添加应用。
申请签名并确认审核通过 一个完整的短信由短信签名和短信正文内容两部分组成，短信签名需申请和审核，签名可在 短信控制台 的相应服务模块【内容配置】中进行申请，详细申请操作请参见 创建签名。发送国际/港澳台短信时，允许不携带签名。
申请模板并确认审核通过 短信正文内容模板需申请和审核，模板可在 短信控制台 的相应服务模块【内容配置】中进行申请，详细申请操作请参见 创建正文模板。

配置 SDK

Composer 配置： qcloudsms_php 采用 composer 进行安装，要使用 qcloudsms 功能，只需要在 composer.json 中添加如下依赖：
{
  "require": {
      "qcloudsms/qcloudsms_php": "0.1.*"
  }
}
说明
Composer 的使用可以参考 demo 目录下面的示例。
手动配置：
1.1 手动下载或 clone 最新版本 qcloudsms_php 代码。
1.2 把 qcloudsms_php src 目录下的代码放入 Autoloading 目录。
1.3 引入 require qcloudsms_php src 目录下面的 index.php 即可使用，如把 qcloudsms 放在当前目录下，只需要执行以下命令：
require __DIR__ . "/qcloudsms_php/src/index.php";

示例代码

说明
所有示例代码仅作参考，无法直接编译和运行，需根据实际情况进行修改。
准备必要参数
// 短信应用 SDK AppID
$appid = 1400009099; // SDK AppID 以1400开头
// 短信应用 SDK AppKey
$appkey = "9ff91d87c2cd7cd0ea762f141975d1df37481d48700d70ac37470aefc60f9bad";
// 需要发送短信的手机号码
$phoneNumbers = ["21212313123", "12345678902", "12345678903"];
// 短信模板 ID，需要在短信控制台中申请
$templateId = 7839;  // NOTE: 这里的模板 ID`7839`只是示例，真实的模板 ID 需要在短信控制台中申请
$smsSign = "腾讯云"; // NOTE: 签名参数使用的是`签名内容`，而不是`签名ID`。这里的签名"腾讯云"只是示例，真实的签名需要在短信控制台申请

指定模板 ID 单发短信

use Qcloud\\Sms\\SmsSingleSender;
try {
  $ssender = new SmsSingleSender($appid, $appkey);
  $params = ["5678"];
  $result = $ssender->sendWithParam("86", $phoneNumbers[0], $templateId,
      $params, $smsSign, "", "");
  $rsp = json_decode($result);
  echo $result;
} catch(\\Exception $e) {
  echo var_dump($e);
}

指定模板 ID 群发短信

use Qcloud\\Sms\\SmsMultiSender;
try {
  $msender = new SmsMultiSender($appid, $appkey);
  $params = ["5678"];
  $result = $msender->sendWithParam("86", $phoneNumbers,
      $templateId, $params, $smsSign, "", "");
  $rsp = json_decode($result);
  echo $result;
} catch(\\Exception $e) {
  echo var_dump($e);
}

拉取短信回执以及回复

use Qcloud\\Sms\\SmsStatusPuller;
try {
  $spuller = new SmsStatusPuller($appid, $appkey);

  // 拉取短信回执
  $callbackResult = $spuller->pullCallback(10);
  $callbackRsp = json_decode($callbackResult);
  echo $callbackResult;

  // 拉取回复（国际/港澳台短信不支持回复功能）
  $replyResult = $spuller->pullReply(10);
  $replyRsp = json_decode($replyResult);
  echo $replyResult;
} catch (\\Exception $e) {
  echo var_dump($e);
}
拉取单个手机短信状态
use Qcloud\\Sms\\SmsMobileStatusPuller;
try {
  $beginTime = 1511125600;  // 开始时间（UNIX timestamp）
  $endTime = 1511841600;    // 结束时间（UNIX timestamp）
  $maxNum = 10;             // 单次拉取最大量
  $mspuller = new SmsMobileStatusPuller($appid, $appkey);

  // 拉取短信回执
  $callbackResult = $mspuller->pullCallback("86", $phoneNumbers[0],
      $beginTime, $endTime, $maxNum);
  $callbackRsp = json_decode($callbackResult);
  echo $callbackResult;

  // 拉取回复，国际/港澳台短信不支持回复功能
  $replyResult = $mspuller->pullReply("86", $phoneNumbers[0],
      $beginTime, $endTime, $maxNum);
  $replyRsp = json_decode($replyResult);
  echo $replyResult;
} catch (\\Exception $e) {
  echo var_dump($e);
}
发送国际/港澳台短信 发送国际/港澳台短信与发送国内短信类似，只需替换相应的国家码或地区码。详细示例请参考：
指定模板单发短信
指定模板群发短信
拉取短信回执
中国站