多通道短信【easysms】 · yzncms2.0使用手冊

> 插件說明：支持近三十家服務商的短信服務，所有涉及短信的地方都會調用此插件設置 ***** ![](https://img.kancloud.cn/a8/fe/a8feece33d4793be60a95176c2f96e23_577x707.png) ***** ### 各平臺配置說明 [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E5%90%84%E5%B9%B3%E5%8F%B0%E9%85%8D%E7%BD%AE%E8%AF%B4%E6%98%8E) ### [阿里云](https://www.aliyun.com/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E9%98%BF%E9%87%8C%E4%BA%91) 短信內容使用`template`+`data` ~~~html 'aliyun' => [ 'access_key_id' => '', 'access_key_secret' => '', 'sign_name' => '', ], ~~~ ### [阿里云Rest](https://www.aliyun.com/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E9%98%BF%E9%87%8C%E4%BA%91rest) 短信內容使用`template`+`data` ~~~html 'aliyunrest' => [ 'app_key' => '', 'app_secret_key' => '', 'sign_name' => '', ], ~~~ ### [阿里云國際](https://www.alibabacloud.com/help/zh/doc-detail/160524.html) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E9%98%BF%E9%87%8C%E4%BA%91%E5%9B%BD%E9%99%85) 短信內容使用`template`+`data` ~~~html 'aliyunintl' => [ 'access_key_id' => '', 'access_key_secret' => '', 'sign_name' => '', ], ~~~ 發送示例： ~~~html use Overtrue\EasySms\PhoneNumber; $easySms = new EasySms($config); $phone_number = new PhoneNumber(18888888888, 86); $easySms->send($phone_number, [ 'content' => '您好：先生/女士！您的驗證碼為${code}，有效時間是5分鐘，請及時驗證。', 'template' => 'SMS_00000001', // 模板ID 'data' => [ "code" => 521410, ], ]); ~~~ ### [云片](https://www.yunpian.com/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E4%BA%91%E7%89%87) 短信內容使用`content` ~~~html 'yunpian' => [ 'api_key' => '', 'signature' => '【默認簽名】', // 內容中無簽名時使用 ], ~~~ ### [Submail](https://www.mysubmail.com/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#submail) 短信內容使用`data` ~~~html 'submail' => [ 'app_id' => '', 'app_key' => '', 'project' => '', // 默認 project，可在發送時 data 中指定 ], ~~~ ### [螺絲帽](https://luosimao.com/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E8%9E%BA%E4%B8%9D%E5%B8%BD) 短信內容使用`content` ~~~html 'luosimao' => [ 'api_key' => '', ], ~~~ ### [容聯云通訊](http://www.yuntongxun.com/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E5%AE%B9%E8%81%94%E4%BA%91%E9%80%9A%E8%AE%AF) 短信內容使用`template`+`data` ~~~html 'yuntongxun' => [ 'app_id' => '', 'account_sid' => '', 'account_token' => '', 'is_sub_account' => false, ], ~~~ ### [互億無線](http://www.ihuyi.com/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E4%BA%92%E4%BA%BF%E6%97%A0%E7%BA%BF) 短信內容使用`content` ~~~html 'huyi' => [ 'api_id' => '', 'api_key' => '', 'signature' => '', ], ~~~ ### [聚合數據](https://www.juhe.cn/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E8%81%9A%E5%90%88%E6%95%B0%E6%8D%AE) 短信內容使用`template`+`data` ~~~html 'juhe' => [ 'app_key' => '', ], ~~~ ### [SendCloud](http://www.sendcloud.net/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#sendcloud) 短信內容使用`template`+`data` ~~~html 'sendcloud' => [ 'sms_user' => '', 'sms_key' => '', 'timestamp' => false, // 是否啟用時間戳 ], ~~~ ### [百度云](https://cloud.baidu.com/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E7%99%BE%E5%BA%A6%E4%BA%91) 短信內容使用`template`+`data` ~~~html 'baidu' => [ 'ak' => '', 'sk' => '', 'invoke_id' => '', 'domain' => '', ], ~~~ ### [華信短信平臺](http://www.ipyy.com/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E5%8D%8E%E4%BF%A1%E7%9F%AD%E4%BF%A1%E5%B9%B3%E5%8F%B0) 短信內容使用`content` ~~~html 'huaxin' => [ 'user_id' => '', 'password' => '', 'account' => '', 'ip' => '', 'ext_no' => '', ], ~~~ ### [253云通訊（創藍）](https://www.253.com/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#253%E4%BA%91%E9%80%9A%E8%AE%AF%E5%88%9B%E8%93%9D) 短信內容使用`content` ~~~html 'chuanglan' => [ 'account' => '', 'password' => '', // 國際短信時必填 'intel_account' => '', 'intel_password' => '', // \Overtrue\EasySms\Gateways\ChuanglanGateway::CHANNEL_VALIDATE_CODE => 驗證碼通道（默認） // \Overtrue\EasySms\Gateways\ChuanglanGateway::CHANNEL_PROMOTION_CODE => 會員營銷通道 'channel' => \Overtrue\EasySms\Gateways\ChuanglanGateway::CHANNEL_VALIDATE_CODE, // 會員營銷通道特定參數。創藍規定：api提交營銷短信的時候，需要自己加短信的簽名及退訂信息 'sign' => '【通訊云】', 'unsubscribe' => '回TD退訂', ], ~~~ ### [創藍云智](https://www.chuanglan.com/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E5%88%9B%E8%93%9D%E4%BA%91%E6%99%BA) 普通短信發送內容使用`content` ~~~html 'chuanglanv1' => [ 'account' => '', 'password' => '', 'needstatus' => false, 'channel' => \Overtrue\EasySms\Gateways\Chuanglanv1Gateway::CHANNEL_NORMAL_CODE, ], ~~~ 發送示例： ~~~html $easySms->send(18888888888, [ 'content' => xxxxxxx ]); ~~~ 變量短信發送內容使用`template`+`data` ~~~html 'chuanglanv1' => [ 'account' => '', 'password' => '', 'needstatus' => false, 'channel' => \Overtrue\EasySms\Gateways\Chuanglanv1Gateway::CHANNEL_VARIABLE_CODE, ], ~~~ 發送示例： ~~~html $easySms->send(18888888888, [ 'template' => xxxxxx, // 模板內容 'data' => 'phone":"15800000000,1234；15300000000,4321', ]); ~~~ ### [融云](http://www.rongcloud.cn/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E8%9E%8D%E4%BA%91) 短信分為兩大類，驗證類和通知類短信。發送驗證類短信使用`template`+`data` ~~~html 'rongcloud' => [ 'app_key' => '', 'app_secret' => '', ] ~~~ ### [天毅無線](http://www.85hu.com/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E5%A4%A9%E6%AF%85%E6%97%A0%E7%BA%BF) 短信內容使用`content` ~~~html 'tianyiwuxian' => [ 'username' => '', //用戶名 'password' => '', //密碼 'gwid' => '', //網關ID ] ~~~ ### [twilio](https://www.twilio.com/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#twilio) 短信使用`content`發送對象需要使用`+`添加區號 ~~~html 'twilio' => [ 'account_sid' => '', // sid 'from' => '', // 發送的號碼可以在控制臺購買 'token' => '', // apitoken ], ~~~ ### [tiniyo](https://www.tiniyo.com/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#tiniyo) 短信使用`content`發送對象需要使用`+`添加區號 ~~~html 'tiniyo' => [ 'account_sid' => '', // auth_id from https://tiniyo.com 'from' => '', // 發送的號碼可以在控制臺購買 'token' => '', // auth_secret from https://tiniyo.com ], ~~~ ### [騰訊云 SMS](https://cloud.tencent.com/product/sms) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E8%85%BE%E8%AE%AF%E4%BA%91-sms) 短信內容使用`template`+`data` ~~~html 'qcloud' => [ 'sdk_app_id' => '', // 短信應用的 SDK APP ID 'secret_id' => '', // SECRET ID 'secret_key' => '', // SECRET KEY 'sign_name' => '騰訊CoDesign', // 短信簽名 ], ~~~ 發送示例： ~~~html $easySms->send(18888888888, [ 'template' => 101234, // 模板ID 'data' => [ "a", 'b', 'c', 'd', //按占位順序給值 ], ]); ~~~ ### [華為云 SMS](https://www.huaweicloud.com/product/msgsms.html) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E5%8D%8E%E4%B8%BA%E4%BA%91-sms) 短信內容使用`template`+`data` ~~~html 'huawei' => [ 'endpoint' => '', // APP接入地址 'app_key' => '', // APP KEY 'app_secret' => '', // APP SECRET 'from' => [ 'default' => '1069012345', // 默認使用簽名通道號 'custom' => 'csms12345', // 其他簽名通道號可以在 data 中定義 from 來指定 'abc' => 'csms67890', // 其他簽名通道號 ... ], 'callback' => '' // 短信狀態回調地址 ], ~~~ 使用默認簽名通道`default` ~~~html $easySms->send(13188888888, [ 'template' => 'SMS_001', 'data' => [ 6379 ], ]); ~~~ 使用指定簽名通道 ~~~html $easySms->send(13188888888, [ 'template' => 'SMS_001', 'data' => [ 6379, 'from' => 'custom' // 對應 config 中的 from 數組中 custom ], ]); ~~~ ### [網易云信](https://yunxin.163.com/sms) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E7%BD%91%E6%98%93%E4%BA%91%E4%BF%A1) 短信內容使用`template`+`data` ~~~html 'yunxin' => [ 'app_key' => '', 'app_secret' => '', 'code_length' => 4, // 隨機驗證碼長度，范圍 4～10，默認為 4 'need_up' => false, // 是否需要支持短信上行 ], ~~~ ~~~html $easySms->send(18888888888, [ 'template' => 'SMS_001', // 不填則使用默認模板 'data' => [ 'code' => 8946, // 如果設置了該參數，則 code_length 參數無效 'action' => 'sendCode', // 默認為 `sendCode`，校驗短信驗證碼使用 `verifyCode` ], ]); ~~~ 通知模板短信 ~~~html $easySms->send(18888888888, [ 'template' => 'templateid', // 模板編號(由客戶顧問配置之后告知開發者) 'data' => [ 'action' => 'sendTemplate', // 默認為 `sendCode`，校驗短信驗證碼使用 `verifyCode` 'params' => [1,2,3], //短信參數列表，用于依次填充模板 ], ]); ~~~ ### [云之訊](https://www.ucpaas.com/index.html) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E4%BA%91%E4%B9%8B%E8%AE%AF) 短信內容使用`template`+`data` ~~~html 'yunzhixun' => [ 'sid' => '', 'token' => '', 'app_id' => '', ], ~~~ ~~~html $easySms->send(18888888888, [ 'template' => 'SMS_001', 'data' => [ 'params' => '8946,3', // 模板參數，多個參數使用 `,` 分割，模板無參數時可為空 'uid' => 'hexianghui', // 用戶 ID，隨狀態報告返回，可為空 'mobiles' => '18888888888,188888888889', // 批量發送短信，手機號使用 `,` 分割，不使用批量發送請不要設置該參數 ], ]); ~~~ ### [凱信通](http://www.kingtto.cn/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E5%87%AF%E4%BF%A1%E9%80%9A) 短信內容使用`content` ~~~html 'kingtto' => [ 'userid' => '', 'account' => '', 'password' => '', ], ~~~ ~~~html $easySms->send(18888888888, [ 'content' => '您的驗證碼為: 6379', ]); ~~~ ### [七牛云](https://www.qiniu.com/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E4%B8%83%E7%89%9B%E4%BA%91) 短信內容使用`template`+`data` ~~~html 'qiniu' => [ 'secret_key' => '', 'access_key' => '', ], ~~~ ~~~html $easySms->send(18888888888, [ 'template' => '1231234123412341234', 'data' => [ 'code' => 1234, ], ]); ~~~ ### [Ucloud](https://www.ucloud.cn/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#ucloud) 短信使用`template`+`data` ~~~html 'ucloud' => [ 'private_key' => '', //私鑰 'public_key' => '', //公鑰 'sig_content' => '', // 短信簽名, 'project_id' => '', //項目ID,子賬號才需要該參數 ], ~~~ ~~~html $easySms->send(18888888888, [ 'template' => 'UTAXXXXX', //短信模板 'data' => [ 'code' => 1234, //模板參數，模板沒有參數不用則填寫，有多個參數請用數組，[1111,1111] 'mobiles' =>'', //同時發送多個手機短信，請用數組[xxx,xxx] ], ]); ~~~ ### [短信寶](http://www.smsbao.com/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E7%9F%AD%E4%BF%A1%E5%AE%9D) 短信使用`content` ~~~html 'smsbao' => [ 'user' => '', //賬號 'password' => '' //密碼 ], ~~~ ~~~html $easySms->send(18888888888, [ 'content' => '您的驗證碼為: 6379', //短信模板 ]); ~~~ ### [摩杜云](https://www.moduyun.com/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E6%91%A9%E6%9D%9C%E4%BA%91) 短信使用`template`+`data` ~~~html 'moduyun' => [ 'accesskey' => '', //必填 ACCESS KEY 'secretkey' => '', //必填 SECRET KEY 'signId' => '', //選填短信簽名，如果使用默認簽名，該字段可缺省 'type' => 0, //選填 0:普通短信;1:營銷短信 ], ~~~ ~~~html $easySms->send(18888888888, [ 'template' => '5a95****b953', //短信模板 'data' => [ 1234, //模板參數，對應模板的{1} 30 //模板參數，對應模板的{2} //... ], ]); ~~~ ### [融合云（助通）](https://www.ztinfo.cn/products/sms) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E8%9E%8D%E5%90%88%E4%BA%91%E5%8A%A9%E9%80%9A) 短信使用`template`+`data` ~~~html 'rongheyun' => [ 'username' => '', //必填用戶名 'password' => '', //必填密碼 'signature'=> '', //必填已報備的簽名 ], ~~~ ~~~html $easySms->send(18888888888, [ 'template' => '31874', //短信模板 'data' => [ 'valid_code' => '888888', //模板參數，對應模板的{valid_code} //... ], ]); ~~~ ### [蜘蛛云](https://zzyun.com/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E8%9C%98%E8%9B%9B%E4%BA%91) 短信使用`template`+`data` ~~~html 'zzyun' => [ 'user_id' => '', //必填會員ID 'secret' => '', //必填接口密鑰 'sign_name'=> '', //必填短信簽名 ], ~~~ ~~~html $easySms->send(18888888888, [ 'template' => 'SMS_210317****', //短信模板 'data' => [ 'code' => '888888', //模板參數，對應模板的{code} //... ], ]); ~~~ ### [融合云信](https://maap.wo.cn/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E8%9E%8D%E5%90%88%E4%BA%91%E4%BF%A1) 短信使用`template`+`data` ~~~html 'maap' => [ 'cpcode' => '', //必填商戶編碼 'key' => '', //必填接口密鑰 'excode'=> '', //選填擴展名 ], ~~~ ~~~html $easySms->send(18888888888, [ 'template' => '356120', //短信模板 'data' => [ '123465' ],//模板參數 ]); ~~~ ### [天瑞云](http://cms.tinree.com/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E5%A4%A9%E7%91%9E%E4%BA%91) 短信內容使用`template`+`data` ~~~html 'tinree' => [ 'accesskey' => '', // 平臺分配給用戶的accesskey 'secret' => '', // 平臺分配給用戶的secret 'sign' => '', // 平臺上申請的接口短信簽名或者簽名ID ], ~~~ 發送示例： ~~~html $easySms->send(18888888888, [ 'template' => '123456', // 模板ID 'data' => [ "a", 'b', 'c', //按模板變量占位順序 ], ]); ~~~ ### [時代互聯](https://www.now.cn/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E6%97%B6%E4%BB%A3%E4%BA%92%E8%81%94) 短信使用`content` ~~~html 'nowcn' => [ 'key' => '', //用戶ID 'secret' => '', //開發密鑰 'api_type' => '', // 短信通道, ], ~~~ 發送示例： ~~~html $easySms->send(18888888888, [ 'content' => '您的驗證碼為: 6379', ]); ~~~ ### [火山引擎](https://console.volcengine.com/sms/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E7%81%AB%E5%B1%B1%E5%BC%95%E6%93%8E) 短信內容使用`template`+`data` ~~~html 'volcengine' => [ 'access_key_id' => '', // 平臺分配給用戶的access_key_id 'access_key_secret' => '', // 平臺分配給用戶的access_key_secret 'region_id' => 'cn-north-1', // 國內節點 cn-north-1，國外節點 ap-singapore-1，不填或填錯，默認使用國內節點 'sign_name' => '', // 平臺上申請的接口短信簽名或者簽名ID，可不填，發送短信時data中指定 'sms_account' => '', // 消息組帳號,火山短信頁面右上角，短信應用括號中的字符串，可不填，發送短信時data中指定 ], ~~~ 發送示例1： ~~~html $easySms->send(18888888888, [ 'template' => 'SMS_123456', // 模板ID 'data' => [ "code" => 1234 // 模板變量 ], ]); ~~~ 發送示例2： ~~~html $easySms->send(18888888888, [ 'template' => 'SMS_123456', // 模板ID 'data' => [ "template_param" => ["code" => 1234], // 模板變量參數 "sign_name" => "yoursignname", // 簽名，覆蓋配置文件中的sign_name "sms_account" => "yoursmsaccount", // 消息組帳號，覆蓋配置文件中的sms_account "phone_numbers" => "18888888888,18888888889", // 手機號，批量發送，英文的逗號連接多個手機號，覆蓋發送方法中的填入的手機號 ], ]); ~~~ ### [移動云MAS（黑名單模式）](https://mas.10086.cn/) [](https://github.com/overtrue/easy-sms?tab=readme-ov-file#%E7%A7%BB%E5%8A%A8%E4%BA%91mas%E9%BB%91%E5%90%8D%E5%8D%95%E6%A8%A1%E5%BC%8F) 短信內容使用`template`+`data` ~~~html 'yidongmasblack' => [ 'ecName' => '', // 機構名稱 'secretKey' => '', // 密鑰 'apId' => '', // 應用ID 'sign' => '', // 簽名 'addSerial' => '', // 通道號默認空 ], ~~~ 發送示例： ~~~html $easySms->send(18888888888, [ 'content' => '您的驗證碼為: 6379', ]); ~~~