PHPackages weijiajia/qcloudsms\_php - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. weijiajia/qcloudsms\_php ActiveLibrary[Utility & Helpers](/categories/utility) weijiajia/qcloudsms\_php ======================== qcloud sms php sdk 1.0.0(2y ago)04MITPHP Since Nov 14Pushed 2y agoCompare [ Source](https://github.com/jackchang1025/qcloudsms_php)[ Packagist](https://packagist.org/packages/weijiajia/qcloudsms_php)[ RSS](/packages/weijiajia-qcloudsms-php/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (1)Versions (2)Used By (0) 腾讯云短信 PHP SDK ============= [](#腾讯云短信-php-sdk) 腾讯短信服务 ------ [](#腾讯短信服务) 目前`腾讯云短信`为客户提供`国内短信`、`国内语音`和`海外短信`三大服务，腾讯云短信SDK支持以下操作： ### 国内短信 [](#国内短信) 国内短信支持操作： - 指定模板单发短信 - 指定模板群发短信 - 拉取短信回执和短信回复状态 > `Note` 短信拉取功能需要联系腾讯云短信技术支持(QQ:3012203387)开通权限，量大客户可以使用此功能批量拉取，其他客户不建议使用。 ### 海外短信 [](#海外短信) 海外短信支持操作： - 指定模板单发短信 - 指定模板群发短信 - 拉取短信回执和短信回复状态 > `Note` 海外短信和国内短信使用同一接口，只需替换相应的国家码与手机号码，每次请求群发接口手机号码需全部为国内或者海外手机号码。 ### 语音通知 [](#语音通知) 语音通知支持操作： - 发送语音验证码 - 发送语音通知 - 上传语音文件 - 按语音文件fid发送语音通知 - 指定模板发送语音通知类 开发 -- [](#开发) ### 准备 [](#准备) 在开始开发云短信应用之前，需要准备如下信息: - 获取SDK AppID和AppKey 云短信应用SDK `AppID`和`AppKey`可在[短信控制台](https://console.cloud.tencent.com/sms)的应用信息里获取，如您尚未添加应用，请到[短信控制台](https://console.cloud.tencent.com/sms)中添加应用。 - 申请签名 一个完整的短信由短信`签名`和短信正文内容两部分组成，短信`签名`须申请和审核，`签名`可在[短信控制台](https://console.cloud.tencent.com/sms)的相应服务模块`内容配置`中进行申请。 - 申请模板 同样短信或语音正文内容`模板`须申请和审核，`模板`可在[短信控制台](https://console.cloud.tencent.com/sms)的相应服务模块`内容配置`中进行申请。 安装 -- [](#安装) ### Composer [](#composer) qcloudsms\_php采用composer进行安装，要使用qcloudsms功能，只需要在composer.json中添加如下依赖： ``` { "require": { "qcloudsms/qcloudsms_php": "0.1.*" } } ``` > `Note` Composer的使用可以参考demo目录下面的示例。 ### 手动 [](#手动) 1. 手动下载或clone最新版本qcloudsms\_php代码 2. 把qcloudsms\_php放入项目目录 3. `require` qcloudsms\_php src目录下面的index.php，即可使用，如把qcloudsms放在当前目录下，只需要: ``` require __DIR__ . "/qcloudsms_php/src/index.php"; ``` 用法 -- [](#用法) 若您对接口存在疑问，可以查阅 [API文档](https://cloud.tencent.com/document/product/382/13297) 、[SDK文档](https://qcloudsms.github.io/qcloudsms_php/) 和 [错误码](https://cloud.tencent.com/document/product/382/3771)。 - **准备必要参数** ``` // 短信应用SDK AppID $appid = 1400009099; // 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); } ``` > `Note` 无论单发/群发短信还是指定模板ID单发/群发短信都需要从控制台中申请模板并且模板已经审核通过，才可能下发成功，否则返回失败。 - **指定模板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); } ``` > `Note` 群发一次请求最多支持200个号码，如有对号码数量有特殊需求请联系腾讯云短信技术支持(QQ:3012203387)。 `Note` 无论单发/群发短信还是指定模板ID单发/群发短信都需要从控制台中申请模板并且模板已经审核通过，才可能下发成功，否则返回失败。 - **发送语音验证码** ``` use Qcloud\Sms\SmsVoiceVerifyCodeSender; try { $vvcsender = new SmsVoiceVerifyCodeSender($appid, $appkey); $result = $vvcsender->send("86", $phoneNumbers[0], "5678"); $rsp = json_decode($result); echo $result; } catch (\Exception $e) { echo var_dump($e); } ``` > `Note` 语音验证码发送只需提供验证码数字，例如当msg=“5678”时，您收到的语音通知为“您的语音验证码是5678”，如需自定义内容，可以使用语音通知。 - **发送语音通知** ``` use Qcloud\Sms\SmsVoicePromptSender; try { $vpsender = new SmsVoicePromptSender($appid, $appkey); $result = $vpsender->send("86", $phoneNumbers[0], 2, "5678"); $rsp = json_decode($result); echo $result; } catch (\Exception $e) { echo var_dump($e); } ``` - **拉取短信回执以及回复** ``` use Qcloud\Sms\SmsStatusPuller; try { $sspuller = 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); } ``` > `Note` 短信拉取功能需要联系腾讯云短信技术支持(QQ:3012203387)，量大客户可以使用此功能批量拉取，其他客户不建议使用。 - **拉取单个手机短信状态** ``` 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); } ``` > `Note` 短信拉取功能需要联系腾讯云短信技术支持(QQ:3012203387)，量大客户可以使用此功能批量拉取，其他客户不建议使用。 - **发送海外短信** 海外短信与国内短信发送类似, 发送海外短信只需替换相应国家码。 - **上传语音文件** ``` use Qcloud\Sms\VoiceFileUploader; try { // Note: 语音文件大小上传限制400K字节 $filepath = "path/to/example.mp3"; $fileContent = file_get_contents($filepath); if ($fileContent == false) { throw new \Exception("can not read file " . $filepath); } $contentType = VoiceFileUploader::MP3; $uploader = new VoiceFileUploader($appid, $appkey); $result = $uploader->upload($fileContent, $contentType); // 上传成功后，$rsp里会带有语音文件的fid $rsp = json_decode($result); echo $result; } catch (\Exception $e) { echo var_dump($e); } ``` > `Note` '语音文件上传'功能需要联系腾讯云短信技术支持(QQ:3012203387)才能开通 - **按语音文件fid发送语音通知** ``` use Qcloud\Sms\FileVoiceSender; try { // Note：这里$fid来自`上传语音文件`接口返回的响应，要按语音 // 文件fid发送语音通知，需要先上传语音文件获取$fid $fid = "73844bb649ca38f37e596ec2781ce6a56a2a3a1b.mp3"; $fvsender = new FileVoiceSender($appid, $appkey); $result = $fvsender->send("86", $phoneNumbers[0], $fid); $rsp = json_decode($result); echo $result; } catch (\Exception $e) { echo var_dump($e); } ``` > `Note` 按'语音文件fid发送语音通知'功能需要联系腾讯云短信技术支持(QQ:3012203387)才能开通 - **指定模板发送语音通知** ``` use Qcloud\Sms\TtsVoiceSender; try { $templateId = 1013; $params = ["54321"]; $tvsender = new TtsVoiceSender($appid, $appkey); $result = $tvsender->send("86", $phoneNumbers[0], $templateId, $params); $rsp = json_decode($result); echo $result; } catch (\Exception $e) { echo var_dump($e); } ``` ### Health Score 20 — LowBetter than 14% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity3 Limited adoption so far Community12 Small or concentrated contributor base Maturity42 Maturing project, gaining track record Bus Factor1 Top contributor holds 75% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 908d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/636557533fde1107bb301eca908de1c17c9ea7073d5c9c0fbad725ccd0800bde?d=identicon)[jackchang1025](/maintainers/jackchang1025) --- Top Contributors [![qcloudsms](https://avatars.githubusercontent.com/u/20947692?v=4)](https://github.com/qcloudsms "qcloudsms (21 commits)")[![abiner](https://avatars.githubusercontent.com/u/32297459?v=4)](https://github.com/abiner "abiner (2 commits)")[![jackchang1025](https://avatars.githubusercontent.com/u/71494064?v=4)](https://github.com/jackchang1025 "jackchang1025 (2 commits)")[![AaronJan](https://avatars.githubusercontent.com/u/4630940?v=4)](https://github.com/AaronJan "AaronJan (1 commits)")[![Hisssy](https://avatars.githubusercontent.com/u/20365878?v=4)](https://github.com/Hisssy "Hisssy (1 commits)")[![weijunyi](https://avatars.githubusercontent.com/u/20080172?v=4)](https://github.com/weijunyi "weijunyi (1 commits)") --- Tags phpsdksmsqcloud ### Embed Badge ![Health badge](/badges/weijiajia-qcloudsms-php/health.svg) ``` [![Health](https://phpackages.com/badges/weijiajia-qcloudsms-php/health.svg)](https://phpackages.com/packages/weijiajia-qcloudsms-php) ``` ### Alternatives [qcloudsms/qcloudsms_php qcloud sms php sdk 116262.3k20](/packages/qcloudsms-qcloudsms-php)[saviorlv/yii2-dysms Aliyun SMS SDK for Yii2 1316.5k1](/packages/saviorlv-yii2-dysms)[amirbagh75/smsir-php Unofficial sms.ir PHP Package 181.2k](/packages/amirbagh75-smsir-php) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)