在项目开发中,短信发送功能是必不可少的一部分。无论是验证码发送、通知推送还是营销信息,短信都扮演着关键的角色。然而,面对多种短信服务提供商,每个提供商都有不同的 API 接口和认证机制,这无疑增加了开发的复杂度和维护的难度。
jakharbek/yii2-sms 是一个专门为 Yii2 框架设计的短信发送扩展,通过 Composer 可以轻松集成到项目中。它的主要优势在于支持多种短信服务提供商,并且提供了统一的接口,简化了开发过程。
安装与配置
使用 Composer 安装 jakharbek/yii2-sms 非常简单,只需运行以下命令:
php composer.phar require --prefer-dist jakharbek/yii2-sms "*"
或者在你的 composer.json 文件的 require 部分添加:
"jakharbek/yii2-sms": "*"
使用方法
安装完成后,你可以直接在代码中使用该扩展。以下是两个使用示例:
示例 1:直接实例化
use jakharbek\sms\providers\playmobile\PlaymobileConnectionDTO;
use jakharbek\sms\providers\playmobile\PlaymobileDriver;
$dto = new PlaymobileConnectionDTO();
$dto->username = getenv("PLAYMOBILE_USERNAME");
$dto->password = getenv("PLAYMOBILE_PASSWORD");
$dto->originator = getenv("PLAYMOBILE_ORIGINATOR");
$playmobile = new PlaymobileDriver($dto);
$playmobile->sendSms($phone, $sms);示例 2:使用依赖注入
首先,在容器中设置单例:
$container->setSingleton(SmsSenderInterface::class, function () {
$dto = new PlaymobileConnectionDTO();
$dto->originator = getenv("PLAYMOBILE_ORIGINATOR");
$dto->username = getenv("PLAYMOBILE_USERNAME");
$dto->password = getenv("PLAYMOBILE_PASSWORD");
return new PlaymobileDriver($dto);
});然后,可以在代码中使用:
use jakharbek\sms\interfaces\SmsSenderInterface; /** * @var $smsSender SmsSenderInterface */ $smsSender = Yii::$container->get(SmsSenderInterface::class); $smsSender->sendSms($phone, $sms);
日志与调试
为了查看所有的短信发送日志,你需要应用扩展包中的迁移文件:
yii migrate --migrationPath=@vendor/jakharbek/yii2-sms/migrations
之后,配置控制器以查看日志:
[
// 配置文件中的控制器映射
'controllerMap' => [
'sms' => \jakharbek\sms\controllers\SmsController::class,
],
]扩展与自定义
jakharbek/yii2-sms 提供了灵活的扩展机制,你可以通过实现 SmsSenderInterface 接口来添加新的短信服务提供商。目前,扩展包支持的唯一提供商是 Playmobile,但你可以根据需要添加其他提供商。
总结
使用 jakharbek/yii2-sms 扩展大大简化了我的短信发送功能的开发和维护。通过 Composer 进行安装和更新非常方便,并且其统一的接口设计使得扩展和维护变得更加简单。无论是小型项目还是大型应用,这个扩展都能满足短信发送的需求,极大地提高了开发效率和系统的可靠性。










