在我们的日常开发中，无论是用户注册验证码、订单状态通知，还是营销推广，短信都是与用户沟通最直接有效的方式之一。然而，随着业务的发展，我们很快就遇到了一个让人头疼的问题：如何高效、稳定地集成和管理多个短信服务商？
最初，我们只对接了一家短信服务商。但很快，我们发现这种单一依赖存在巨大的风险：
- 服务商故障：一旦该服务商出现故障或延迟，我们的短信发送功能就会瘫痪，严重影响用户体验和业务流程。
- 成本压力：随着发送量的增加，单一服务商的价格可能不再是最优选择，但切换或增加新的服务商意味着要重新编写大量代码。
-
API差异巨大：每个短信服务商都有自己独特的API接口、参数格式（有的用
content，有的用template+data）、错误码和返回结构。这使得代码变得臃肿且难以维护。 - 缺乏容灾机制：我们希望实现当一个服务商失败时，能自动切换到另一个备用服务商，但手动实现这种复杂的轮询和容错逻辑，无疑是巨大的开发负担。
面对这些挑战，我们一度陷入困境，每次想到要增加或更换短信服务商，都感觉像是一场噩梦。直到我们发现了 overtrue/easy-sms 这个 Composer 包，它为我们带来了曙光！
Overtrue/EasySms：短信发送的终极解决方案
overtrue/easy-sms 正如其名，它是一款让短信发送变得“超级简单”的 PHP 组件。它完美地抽象了各种短信服务商的差异，提供了一套统一的API接口，让我们能够以一致的方式与市面上主流的数十家短信服务商进行交互。
它的核心优势在于：
- 统一的 API 接口：你不再需要为每个服务商编写不同的发送逻辑，只需一套代码，即可兼容所有平台。
- 灵活的配置管理：通过简单的配置，就能轻松增减、切换服务商，甚至为不同的业务场景指定不同的服务商。
- 智能的轮询策略：内置多种轮询策略（如顺序、随机），并支持自定义，确保高可用性和最佳发送效果。
- 自动容灾切换：当某个服务商发送失败时，EasySms 会自动尝试下一个可用的服务商，极大提升了短信的送达率。
- 统一的返回值格式：无论是成功还是失败，所有网关的返回结果都将以统一的格式呈现，便于日志记录、监控和错误处理。
如何使用 EasySms 解决问题？
1. 安装
首先，通过 Composer 轻松安装 overtrue/easy-sms：
composer require "overtrue/easy-sms"
2. 配置
配置是 EasySms 强大功能的基石。你只需在一个数组中定义好你的短信服务商信息和发送策略。
use Overtrue\EasySms\EasySms;
use Overtrue\EasySms\Strategies\OrderStrategy; // 顺序策略
$config = [
// HTTP 请求的超时时间（秒）
'timeout' => 5.0,
// 默认发送配置
'default' => [
// 网关调用策略，默认：顺序调用
'strategy' => OrderStrategy::class,
// 默认可用的发送网关（按顺序尝试）
'gateways' => [
'aliyun', 'yunpian', // 优先使用阿里云，失败则尝试云片
],
],
// 可用的网关配置（根据你的实际情况填写）
'gateways' => [
'aliyun' => [
'access_key_id' => '你的阿里云AccessKeyId',
'access_key_secret' => '你的阿里云AccessKeySecret',
'sign_name' => '你的阿里云签名',
],
'yunpian' => [
'api_key' => '你的云片APIKey',
'signature' => '【你的云片签名】',
],
// ... 还可以配置腾讯云、华为云、百度云等数十家服务商
],
];
$easySms = new EasySms($config);3. 发送短信
配置完成后，发送短信变得异常简单。无论后端是阿里云还是云片，你都使用统一的 send 方法。
try {
$results = $easySms->send('13888888888', [
'content' => '您的验证码为: 6379', // 用于支持纯文本内容的网关
'template' => 'SMS_123456789', // 用于支持模板ID的网关
'data' => [ // 模板变量
'code' => 6379
],
]);
echo "短信发送结果：\n";
print_r($results);
} catch (\Overtrue\EasySms\Exceptions\NoGatewayAvailableException $e) {
echo "所有网关均发送失败！\n";
print_r($e->getResults()); // 获取所有网关的详细失败信息
}亮点：统一内容与模板变量
EasySms 巧妙地通过 content、template 和 data 这三个通用属性来适应不同服务商的发送方式。如果某个网关只支持纯文本，它会使用 content；如果支持模板，则会使用 template 和 data。你甚至可以使用闭包来为特定网关返回不同的内容或模板ID，实现高度定制化：
$easySms->send('13888888888', [
'content' => function($gateway){
if ($gateway->getName() == 'yunpian') {
return '云片专用验证码：6379';
}
return '您的验证码为: 6379';
},
'template' => function($gateway){
if ($gateway->getName() == 'aliyun') {
return 'SMS_AliyunSpecificTemplate';
}
return 'SMS_GenericTemplate';
},
'data' => function($gateway){
return ['code' => 6379];
},
]);4. 自定义短信消息体
对于更复杂的短信场景，你可以继承 Overtrue\EasySms\Message 类来定义自己的短信消息体，将短信内容、模板和策略封装起来，实现一处定义，多处复用。
// 定义一个订单支付成功通知短信
class OrderPaidMessage extends \Overtrue\EasySms\Message
{
protected $orderNo;
protected $strategy = OrderStrategy::class; // 也可以覆盖默认策略
protected $gateways = ['aliyun', 'yunpian']; // 也可以指定本消息使用的网关
public function __construct(string $orderNo)
{
$this->orderNo = $orderNo;
}
public function getContent(\Overtrue\EasySms\Contracts\GatewayInterface $gateway = null)
{
return sprintf('您的订单:%s, 已经完成付款', $this->orderNo);
}
public function getTemplate(\Overtrue\EasySms\Contracts\GatewayInterface $gateway = null)
{
return 'SMS_ORDER_PAID_TEMPLATE_ID';
}
public function getData(\Overtrue\EasySms\Contracts\GatewayInterface $gateway = null)
{
return ['order_no' => $this->orderNo];
}
}
// 发送自定义短信
$orderNo = '20230808123456';
$message = new OrderPaidMessage($orderNo);
$easySms->send('13888888888', $message);总结其优势与实际应用效果
overtrue/easy-sms 彻底改变了我们处理短信发送的方式。
- 开发效率大幅提升：从前需要几天甚至几周才能完成的多个服务商集成工作，现在只需几小时的配置和几行代码就能搞定。
- 系统稳定性增强：自动轮询和容错机制确保了即使某个服务商出现问题，短信也能通过其他渠道成功发送，显著提高了送达率和用户满意度。
- 维护成本降低：统一的API和配置，让代码更清晰、更易于维护和升级。无需担心未来更换服务商带来的巨大重构工作。
- 业务灵活性提高：我们可以根据需求轻松调整服务商的优先级，或者为不同的业务场景（如验证码、通知、营销）分配不同的服务商，实现最佳的成本效益和性能。
- 数据洞察力增强：统一的返回值格式使得日志分析和监控变得更加简单，我们能够清晰地了解每次短信发送的状态和哪个网关成功或失败。
总而言之，overtrue/easy-sms 不仅仅是一个短信发送库，它更是一个为 PHP 开发者量身定制的短信发送管理平台。如果你还在为复杂的短信集成而烦恼，那么我强烈推荐你尝试一下 overtrue/easy-sms，它将是你的得力助手！
