PHPackages                             phpcode/tp51-sms - 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. phpcode/tp51-sms

ActiveLibrary

phpcode/tp51-sms
================

no Description is good Description!

v1.0.8(4y ago)01711MITPHP

Since Mar 28Pushed 4y ago1 watchersCompare

[ Source](https://github.com/bill-wangwang/tp51-sms)[ Packagist](https://packagist.org/packages/phpcode/tp51-sms)[ RSS](/packages/phpcode-tp51-sms/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependencies (1)Versions (10)Used By (0)

tp51-sms
========

[](#tp51-sms)

thinkphp5.1 聚合短信类

安装
--

[](#安装)

> composer require phpcode/tp51-sms

配置
--

[](#配置)

- 复制`examples/config/sms.php`到项目config配置目录下（`config/sms.php`）
- 修改`.env`文件（可参考文件`examples/.env.example`和`sms.php`）
- 在对应的数据库上执行`sms_table.sql`文件的创建表语句,记得把`{$prefix}`替换为实际的`databases.php`的`prefix`对应的值
- 如果不想把短信模板配置到数据库，可以直接在`sms.php`配置文件中配置 `sms_template_list`

使用
--

[](#使用)

### Controller 控制器中使用

[](#controller-控制器中使用)

```
use tp51\sms\Sms;

$sms = new Sms();
$type = 'register'; //短息模板类型标识 如 register | find_password
$mobile = '13800138000'; //手机号
//系统内置了获取验证码方法，可以配置 验证码的长度，有效期，有效时间内获取的同一个手机号的同一类型的验证码是否一样
$code = $sms->getVerifyCode($type, $mobile);
//发送短信
$out_id = $sms->send($type, $mobile, ['code'=>$code]);

------------------------------------------------------------------------------------------
//验证
$input_code = input('param.code'); //用户输入的验证码
$res = $sms->checkVerifyCode($type, $mobile, $input_code);
if($res){
    //验证成功了
    //这里可以写具体的业务逻辑
    echo 'success';
} else {
    //验证失败了
    echo 'error';
}

```

支持
--

[](#支持)

- 阿里云的阿里大鱼`dysms`
- 腾讯云的`qcloudsms`
- 本地发送`local`（不真实发送短信，配合万能验证码在开发环境调试）
- 创蓝短信`clsms`
- 虹腾短信`htsms`

重要选项
----

[](#重要选项)

- `sms_type` 支持\[ `dysms` 、 `qcloudsms` 、 `local`、`clsms`、`htsms` \]
- `sms_type`设置为`local`时，配合`public_verify_code`可以配置万能验证码以节约短信费用
- 短信模板除了`腾讯云(qcloudsms)`的需要`{1}`, `{2}`这种格式外，其它的都是 `${code}`， `${name}`的形式，因此为了更好的兼容各种短信，建议程序使用可以key的参数 `['code'=>$code, 'name'=>$name]` 而不是`[$code, $name]`

功能
--

[](#功能)

- 灵活的配置（可以参考`Sms.php`的配置项`$_config`）
- 支持自定义验证码长度(`verify_code_length`)或`->setVerifyCodeLength()`
- 支持配置有效时间内获取同种类型的验证码是否变化(`same_as_last_time`)
- 支持自定义允许尝试验证码最大次数(`max_try`)或`->setMaxTry()`
- 支持验证成功后是否立即销毁验证码(`delete`)或`->setDelete()`
- 支持设置发送短信成功后的回调`->setSendCallBack()`
- 支持非数据库设置短信模板（优先级高于数据库配置短信模板）`->setSmsTemplateList()`

注意事项
----

[](#注意事项)

- 生产环境如果把`短信模板`配置到`数据库`建议把 `use_cache`设置为`true`以提高性能
- 如果更改了短信模板的并且使用缓存`use_cache`为`true`时，需要手动调用`clearTemplatesCache()`方法清除短信模板，否则不生效

V1.0.4 更新日志
-----------

[](#v104-更新日志)

- 新增短信类型`虹腾`(`htsms`)
- 修改`创蓝`短信为`变量`模板而非数字作为key的用法
- 修复`examples/config/sms.php`内容

V1.0.5 更新日志
-----------

[](#v105-更新日志)

- 修复虹腾短信 返回参数

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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

Every ~143 days

Recently: every ~269 days

Total

9

Last Release

1463d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/fec3df0815ef02996bc06e57f87a266c1c9345ab51497ace14ff1bda9988de1b?d=identicon)[bill-wangwang](/maintainers/bill-wangwang)

---

Top Contributors

[![bill-wangwang](https://avatars.githubusercontent.com/u/14326461?v=4)](https://github.com/bill-wangwang "bill-wangwang (9 commits)")

### Embed Badge

![Health badge](/badges/phpcode-tp51-sms/health.svg)

```
[![Health](https://phpackages.com/badges/phpcode-tp51-sms/health.svg)](https://phpackages.com/packages/phpcode-tp51-sms)
```

###  Alternatives

[singka/singka-sms

适用于ThinkPHP6.0的各种短信接口集成服务，本项目集成了各大云服务厂商的短信业务平台，支持ThinkPHP5.0、ThinkPHP5.1和ThinkPHP6.0，由宁波晟嘉网络科技有限公司维护，目前支持阿里云、腾讯云、七牛云、又拍云、Ucloud和华为云。

181.7k](/packages/singka-singka-sms)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)