接口类，需要指定入参类型，出参类型

ThinkPHP6 短信发送工厂模式实现方案

根据你的需求，我设计了一套符合 接口规范 + 工厂模式 的短信发送方案，统一方法名和返回格式，支持动态切换腾讯云 / 阿里云接口，结构清晰且易于扩展。

一、目录结构（遵循 TP6 规范）

plaintext

 

 

app/
├── common/
│   └── lib/
│       ├── sms/
│       │   ├── contract/      # 接口契约
│       │   │   └── SmsInterface.php  # 短信接口规范
│       │   ├── dto/           # 数据传输对象（统一返回格式）
│       │   │   └── SmsResult.php     # 短信返回结构体
│       │   ├── impl/          # 第三方实现
│       │   │   ├── AliyunSms.php     # 阿里云短信实现
│       │   │   └── TencentSms.php    # 腾讯云短信实现
│       │   └── SmsFactory.php        # 短信工厂类
├── config/
│   └── sms.php                       # 短信配置文件
└── controller/└── TestController.php            # 测试控制器

 

二、核心实现代码

1. 接口契约（统一方法规范）

app/common/lib/sms/contract/SmsInterface.php

php

 

 

<?php
namespace app\common\lib\sms\contract;use app\common\lib\sms\dto\SmsResult;/*** 短信发送接口规范* 所有第三方短信实现必须遵循此接口*/
interface SmsInterface
{/*** 发送短信* @param string $phone 手机号（支持单个号码）* @param string $templateId 模板ID* @param array $templateParams 模板参数（键值对）* @return SmsResult 统一返回结构体*/public function send(string $phone, string $templateId, array $templateParams): SmsResult;
}

 

2. 统一返回结构体（类似 Go 的 struct）

app/common/lib/sms/dto/SmsResult.php

php

 

 

<?php
namespace app\common\lib\sms\dto;/*** 短信发送统一返回结构体* 规范所有第三方返回格式，便于上层处理*/
class SmsResult
{// 状态码：200=成功，其他=失败private int $code;// 业务消息private string $message;// 第三方原始响应数据（便于调试）private array $raw;// 自定义扩展数据（如短信ID、回执ID等）private array $extra = [];public function __construct(int $code, string $message, array $raw = [], array $extra = []){$this->code = $code;$this->message = $message;$this->raw = $raw;$this->extra = $extra;}// 快捷创建成功结果public static function success(string $message = '发送成功', array $raw = [], array $extra = []): self{return new self(200, $message, $raw, $extra);}// 快捷创建失败结果public static function fail(string $message = '发送失败', array $raw = [], array $extra = []): self{return new self(500, $message, $raw, $extra);}// getter方法（只读，确保数据不可篡改）public function getCode(): int{return $this->code;}public function getMessage(): string{return $this->message;}public function getRaw(): array{return $this->raw;}public function getExtra(): array{return $this->extra;}// 转为数组（便于接口返回）public function toArray(): array{return ['code' => $this->code,'message' => $this->message,'extra' => $this->extra,'raw' => app()->isDebug() ? $this->raw : [], // 调试模式才返回原始数据];}
}

 

3. 第三方实现 - 阿里云短信

app/common/lib/sms/impl/AliyunSms.php

php

 

 

<?php
namespace app\common\lib\sms\impl;use app\common\lib\sms\contract\SmsInterface;
use app\common\lib\sms\dto\SmsResult;
use AlibabaCloud\Client\AlibabaCloud;
use AlibabaCloud\Dyplsapi\Dyplsapi;
use think\facade\Config;class AliyunSms implements SmsInterface
{// 阿里云配置private array $config;public function __construct(){// 从配置文件读取阿里云配置$this->config = Config::get('sms.providers.aliyun', []);// 初始化阿里云客户端AlibabaCloud::accessKeyClient($this->config['access_key_id'],$this->config['access_key_secret'])->regionId($this->config['region_id'])->asDefaultClient();}/*** @inheritDoc*/public function send(string $phone, string $templateId, array $templateParams): SmsResult{try {// 调用阿里云短信API$result = Dyplsapi::v20170525()->sendSms()->withPhoneNumbers($phone)->withSignName($this->config['sign_name'])->withTemplateCode($templateId)->withTemplateParam(json_encode($templateParams, JSON_UNESCAPED_UNICODE))->request();$rawData = $result->toArray();// 解析阿里云返回结果，转为统一格式if ($rawData['Code'] === 'OK') {return SmsResult::success('阿里云短信发送成功', $rawData, ['biz_id' => $rawData['BizId'],'request_id' => $rawData['RequestId']]);} else {return SmsResult::fail("阿里云短信发送失败：{$rawData['Message']}",$rawData,['error_code' => $rawData['Code']]);}} catch (\Exception $e) {return SmsResult::fail("阿里云短信异常：{$e->getMessage()}",['exception' => $e->getMessage(), 'line' => $e->getLine()],['error_code' => $e->getCode()]);}}
}

 

4. 第三方实现 - 腾讯云短信

app/common/lib/sms/impl/TencentSms.php

php

 

 

<?php
namespace app\common\lib\sms\impl;use app\common\lib\sms\contract\SmsInterface;
use app\common\lib\sms\dto\SmsResult;
use Qcloud\Sms\SmsSingleSender;
use think\facade\Config;class TencentSms implements SmsInterface
{// 腾讯云配置private array $config;public function __construct(){// 从配置文件读取腾讯云配置$this->config = Config::get('sms.providers.tencent', []);}/*** @inheritDoc*/public function send(string $phone, string $templateId, array $templateParams): SmsResult{try {// 腾讯云短信要求参数为数组格式（按模板顺序）$params = array_values($templateParams);// 初始化腾讯云短信客户端$sender = new SmsSingleSender($this->config['app_id'],$this->config['app_key']);// 调用腾讯云短信API$result = $sender->sendWithParam($this->config['nation_code'], // 国家码（如86）$phone,$templateId,$params,$this->config['sign_name'], // 签名'', // 扩展码（可选）''  // 延伸码（可选）);$rawData = json_decode($result, true) ?: [];// 解析腾讯云返回结果，转为统一格式if ($rawData['result'] === 0) {return SmsResult::success('腾讯云短信发送成功', $rawData, ['sid' => $rawData['sid'],'fee' => $rawData['fee']]);} else {return SmsResult::fail("腾讯云短信发送失败：{$rawData['errmsg']}",$rawData,['error_code' => $rawData['result']]);}} catch (\Exception $e) {return SmsResult::fail("腾讯云短信异常：{$e->getMessage()}",['exception' => $e->getMessage(), 'line' => $e->getLine()],['error_code' => $e->getCode()]);}}
}

 

5. 短信工厂类（动态创建实例）

app/common/lib/sms/SmsFactory.php

php

 

 

<?php
namespace app\common\lib\sms;use app\common\lib\sms\contract\SmsInterface;
use think\facade\Config;
use InvalidArgumentException;class SmsFactory
{/*** 动态创建短信实例* @param string $driver 驱动名称（aliyun/tencent）* @return SmsInterface* @throws InvalidArgumentException*/public static function make(string $driver = ''): SmsInterface{// 若未指定驱动，使用配置文件中的默认驱动$driver = $driver ?: Config::get('sms.default', 'aliyun');// 映射驱动到具体实现类$driverMap = ['aliyun' => \app\common\lib\sms\impl\AliyunSms::class,'tencent' => \app\common\lib\sms\impl\TencentSms::class,];// 验证驱动是否支持if (!isset($driverMap[$driver])) {throw new InvalidArgumentException("不支持的短信驱动：{$driver}");}$className = $driverMap[$driver];// 检查类是否存在并实现接口if (!class_exists($className) || !is_subclass_of($className, SmsInterface::class)) {throw new InvalidArgumentException("短信驱动类 {$className} 未实现 SmsInterface 接口");}// 创建实例（支持依赖注入）return app()->make($className);}
}

 

6. 配置文件

config/sms.php

php

 

 

<?php
return [// 默认短信驱动（aliyun/tencent）'default' => env('SMS_DEFAULT', 'aliyun'),// 第三方短信配置'providers' => [// 阿里云短信配置'aliyun' => ['access_key_id' => env('ALIYUN_SMS_ACCESS_KEY_ID', ''),'access_key_secret' => env('ALIYUN_SMS_ACCESS_KEY_SECRET', ''),'region_id' => env('ALIYUN_SMS_REGION_ID', 'cn-hangzhou'),'sign_name' => env('ALIYUN_SMS_SIGN_NAME', ''), // 短信签名],// 腾讯云短信配置'tencent' => ['app_id' => env('TENCENT_SMS_APP_ID', ''),'app_key' => env('TENCENT_SMS_APP_KEY', ''),'nation_code' => env('TENCENT_SMS_NATION_CODE', '86'), // 国家码'sign_name' => env('TENCENT_SMS_SIGN_NAME', ''), // 短信签名],],
];

 

7. 环境变量配置（.env）

env

 

 

# 短信配置
SMS_DEFAULT=aliyun # 默认驱动# 阿里云短信
ALIYUN_SMS_ACCESS_KEY_ID=your_access_key_id
ALIYUN_SMS_ACCESS_KEY_SECRET=your_access_key_secret
ALIYUN_SMS_SIGN_NAME=你的短信签名# 腾讯云短信
TENCENT_SMS_APP_ID=your_app_id
TENCENT_SMS_APP_KEY=your_app_key
TENCENT_SMS_SIGN_NAME=你的短信签名

 

三、使用示例（控制器调用）

app/controller/TestController.php

php

 

 

<?php
namespace app\controller;use app\common\lib\sms\SmsFactory;
use app\common\lib\sms\dto\SmsResult;
use think\facade\Log;
use think\response\Json;class TestController
{/*** 发送短信示例* @return Json*/public function sendSms(): Json{try {// 1. 通过工厂类创建短信实例（动态切换驱动）// $sms = SmsFactory::make('tencent'); // 手动指定腾讯云$sms = SmsFactory::make(); // 使用默认驱动// 2. 调用统一的send方法发送短信$phone = '13800138000'; // 接收手机号$templateId = 'SMS_123456789'; // 短信模板ID$templateParams = ['code' => rand(100000, 999999), // 验证码'expire' => '5' // 有效期（分钟）];/** @var SmsResult $result */$result = $sms->send($phone, $templateId, $templateParams);// 3. 统一处理返回结果if ($result->getCode() === 200) {Log::info("短信发送成功：手机号={$phone}，回执ID={$result->getExtra()['biz_id'] ?? ''}");return json($result->toArray(), 200);} else {Log::error("短信发送失败：手机号={$phone}，错误信息={$result->getMessage()}，原始数据=" . json_encode($result->getRaw()));return json($result->toArray(), 500);}} catch (\Exception $e) {Log::error("短信发送异常：{$e->getMessage()}", ['trace' => $e->getTraceAsString()]);return json(['code' => 500,'message' => '短信发送异常：' . $e->getMessage()], 500);}}
}

 

四、依赖安装

需要安装对应第三方 SDK：

bash

 

 

# 阿里云SDK
composer require alibabacloud/dyplsapi-20170525# 腾讯云SDK
composer require qcloudsms/qcloudsms_php

 

五、核心特性说明

1. 接口规范约束：所有第三方实现必须遵循 SmsInterface，确保方法名（send）和参数格式统一
2. 统一返回格式：通过 SmsResult DTO 类，规范返回结构（类似 Go 的 struct），上层无需关心第三方差异
3. 工厂模式动态切换：通过 SmsFactory::make() 可快速切换驱动，无需修改业务代码
4. 配置分离：敏感配置放在环境变量，支持多环境部署
5. 调试友好：调试模式下返回第三方原始响应，便于问题排查
6. 扩展性强：新增短信服务商（如华为云、极光短信）时，只需：
   • 新建实现类并实现 SmsInterface
   • 在工厂类的 driverMap 中添加映射
   • 在配置文件中添加对应配置

六、注意事项

1. 需先在对应云服务商控制台完成短信签名和模板的审核
2. 确保环境变量中配置了正确的 AccessKey、AppID 等敏感信息
3. 生产环境建议关闭调试模式（app_debug=false），避免泄露原始响应数据
4. 可根据实际需求扩展 SmsInterface（如添加批量发送、短信回执查询等方法）