如何解决多短信服务商集成难题？Overtrue/EasySms助你轻松搞定！-composer-PHP中文网

如何解决多短信服务商集成难题？Overtrue/EasySms助你轻松搞定！

霞舞

发布： 2025-11-23 18:26:02

原创

670人浏览过

如何解决多短信服务商集成难题？overtrue/easysms助你轻松搞定！

可以通过一下地址学习composer：学习地址

在我们的日常开发中，无论是用户注册验证码、订单状态通知，还是营销推广，短信都是与用户沟通最直接有效的方式之一。然而，随着业务的发展，我们很快就遇到了一个让人头疼的问题：如何高效、稳定地集成和管理多个短信服务商？

最初，我们只对接了一家短信服务商。但很快，我们发现这种单一依赖存在巨大的风险：

服务商故障：一旦该服务商出现故障或延迟，我们的短信发送功能就会瘫痪，严重影响用户体验和业务流程。
成本压力：随着发送量的增加，单一服务商的价格可能不再是最优选择，但切换或增加新的服务商意味着要重新编写大量代码。
API差异巨大：每个短信服务商都有自己独特的API接口、参数格式（有的用 content，有的用 template + data）、错误码和返回结构。这使得代码变得臃肿且难以维护。
缺乏容灾机制：我们希望实现当一个服务商失败时，能自动切换到另一个备用服务商，但手动实现这种复杂的轮询和容错逻辑，无疑是巨大的开发负担。

面对这些挑战，我们一度陷入困境，每次想到要增加或更换短信服务商，都感觉像是一场噩梦。直到我们发现了 overtrue/easy-sms 这个 Composer 包，它为我们带来了曙光！

Overtrue/EasySms：短信发送的终极解决方案

overtrue/easy-sms 正如其名，它是一款让短信发送变得“超级简单”的 PHP 组件。它完美地抽象了各种短信服务商的差异，提供了一套统一的API接口，让我们能够以一致的方式与市面上主流的数十家短信服务商进行交互。

它的核心优势在于：

统一的 API 接口：你不再需要为每个服务商编写不同的发送逻辑，只需一套代码，即可兼容所有平台。
灵活的配置管理：通过简单的配置，就能轻松增减、切换服务商，甚至为不同的业务场景指定不同的服务商。
智能的轮询策略：内置多种轮询策略（如顺序、随机），并支持自定义，确保高可用性和最佳发送效果。
自动容灾切换：当某个服务商发送失败时，EasySms 会自动尝试下一个可用的服务商，极大提升了短信的送达率。
统一的返回值格式：无论是成功还是失败，所有网关的返回结果都将以统一的格式呈现，便于日志记录、监控和错误处理。

如何使用 EasySms 解决问题？

1. 安装

首先，通过 Composer 轻松安装 overtrue/easy-sms：

<code class="bash">composer require "overtrue/easy-sms"</code>

登录后复制

2. 配置

配置是 EasySms 强大功能的基石。你只需在一个数组中定义好你的短信服务商信息和发送策略。

ChatsNow

ChatsNow是一款免费的AI写作类浏览器插件，提供智能聊天机器人、智能翻译、智能搜索等工具

253

查看详情

<pre class="brush:php;toolbar:false;">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 方法。

<pre class="brush:php;toolbar:false;">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，实现高度定制化：

<pre class="brush:php;toolbar:false;">$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 类来定义自己的短信消息体，将短信内容、模板和策略封装起来，实现一处定义，多处复用。

<pre class="brush:php;toolbar:false;">// 定义一个订单支付成功通知短信
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);

登录后复制