首先登陆阿里云平台,点左侧产品与服务菜单找到短信服务,然后点击进去
然后点击AccessKey获取你的accessKeyId和accessKeySecret,这个是调用短信接口重要凭证
这一步获取成功后点击左侧国内短信,在这里面你可以创建你的短信签名和短信模板,这两个东西也是调用短信接口必不可少的
上面几步都搞定了现在就可以下载demo开始来调试短信接口的使用了,点左侧帮助文档,鼠标移至开发指南,然后点击SDK及DEMO下载
选择轻量版下载,前面那个比较大,很多功能使用不到,没必要
解压下载下来的文件,里面有这些东西
把SignatureHelper.php和demo文件夹里面的sendSms.php复制出来放在同一文件夹,sendSms.php需要包含引用SignatureHelper.php这个文件,具体位置可以根据你实际需要来放置,这里我直接把它们两个放在同一文件夹里面,然后开始调试
如图,由于SignatureHelper.php原来是在sendSms.php的上一级目录,现在我们把它放置在同一级目录了,所以先得把这个路径改一下,改成这样
require_once "./SignatureHelper.php";
下面开始配置参数
/**
* 发送短信
*/
function sendSms() {
$params = array ();
// *** 需用户填写部分 ***
// fixme 必填:是否启用https
$security = false;
// fixme 必填: 请参阅 https://ak-console.aliyun.com/ 取得您的AK信息
$accessKeyId = "your access key id"; //你获取到的accessKeyId
$accessKeySecret = "your access key secret"; //你获取到的accessKeySecret
// fixme 必填: 短信接收号码
$params["PhoneNumbers"] = "17000000000";
//必填: 请参考: https://dysms.console.aliyun.com/dysms.htm#/develop/sign
$params["SignName"] = "短信签名";
//必填:请参考: https://dysms.console.aliyun.com/dysms.htm#/develop/template
$params["TemplateCode"] = "SMS_0000001";
// fixme 可选: 设置模板参数, 假如模板中存在变量需要替换则为必填项
//这个数组里面的参数是指你创建的模板里面的参数,比如你模板创建的是这样:欢迎使用${product},你的验证码是${code}。那么你就可以像下面这样配置你的模板参数
$params['TemplateParam'] = Array (
"code" => "12345",
"product" => "阿里通信"
);
// fixme 可选: 设置发送短信流水号
//$params['OutId'] = "12345";
// fixme 可选: 上行短信扩展码, 扩展码字段控制在7位或以下,无特殊需求用户请忽略此字段
//$params['SmsUpExtendCode'] = "1234567";
// *** 需用户填写部分结束, 以下代码若无必要无需更改 ***
if(!empty($params["TemplateParam"]) && is_array($params["TemplateParam"])) {
$params["TemplateParam"] = json_encode($params["TemplateParam"], JSON_UNESCAPED_UNICODE);
}
// 初始化SignatureHelper实例用于设置参数,签名以及发送请求
$helper = new SignatureHelper();
// 此处可能会抛出异常,注意catch
$content = $helper->request(
$accessKeyId,
$accessKeySecret,
"dysmsapi.aliyuncs.com",
array_merge($params, array(
"RegionId" => "cn-hangzhou",
"Action" => "SendSms",
"Version" => "2017-05-25",
)),
$security
);
return $content;
}
上面所有信配置无误后就可以开始发送短信了。直接调用sendSms()方法.
ini_set("display_errors", "on"); // 显示错误提示,仅用于测试时排查问题
set_time_limit(0); // 防止脚本超时,仅用于测试使用,生产环境请按实际情况设置
header("Content-Type: text/plain; charset=utf-8"); // 输出为utf-8的文本格式,仅用于测试
// 验证发送短信(SendSms)接口
print_r(sendSms());
ok,发送成功,如遇发送失败,根据返回的Code对应查看错误原因
错误码对照:
OK | 请求成功 |
isp.RAM_PERMISSION_DENY | RAM权限DENY |
isv.OUT_OF_SERVICE | 业务停机 |
isv.PRODUCT_UN_SUBSCRIPT | 未开通云通信产品的阿里云客户 |
isv.PRODUCT_UNSUBSCRIBE | 产品未开通 |
isv.ACCOUNT_NOT_EXISTS | 账户不存在 |
isv.ACCOUNT_ABNORMAL | 账户异常 |
isv.SMS_TEMPLATE_ILLEGAL | 短信模板不合法 |
isv.SMS_SIGNATURE_ILLEGAL | 短信签名不合法 |
isv.INVALID_PARAMETERS | 参数异常 |
isp.SYSTEM_ERROR | 系统错误 |
isv.MOBILE_NUMBER_ILLEGAL | 非法手机号 |
isv.MOBILE_COUNT_OVER_LIMIT | 手机号码数量超过限制 |
isv.TEMPLATE_MISSING_PARAMETERS | 模板缺少变量 |
isv.BUSINESS_LIMIT_CONTROL | 业务限流 |
isv.INVALID_JSON_PARAM | JSON参数不合法,只接受字符串值 |
isv.BLACK_KEY_CONTROL_LIMIT | 黑名单管控 |
isv.PARAM_LENGTH_LIMIT | 参数超出长度限制 |
isv.PARAM_NOT_SUPPORT_URL | 不支持URL |
isv.AMOUNT_NOT_ENOUGH | 账户余额不足 |