PHPackages                             larva/laravel-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. [Utility & Helpers](/categories/utility)
4. /
5. larva/laravel-sms

ActiveLibrary[Utility & Helpers](/categories/utility)

larva/laravel-sms
=================

This is a SMS.

2.0.0(10mo ago)03.8kMITPHPPHP >=8.0CI failing

Since Mar 6Pushed 10mo agoCompare

[ Source](https://github.com/larvatecn/laravel-sms)[ Packagist](https://packagist.org/packages/larva/laravel-sms)[ RSS](/packages/larva-laravel-sms/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (10)Dependencies (3)Versions (11)Used By (0)

laravel-sms
===========

[](#laravel-sms)

This is a sms expansion for the laravel

[![License](https://camo.githubusercontent.com/b7e53c5a5c787a2cc036b3046a0608b4730768df0d189d4e17fe82a5f54dde11/68747470733a2f2f706f7365722e707567782e6f72672f6c617276612f6c61726176656c2d736d732f6c6963656e73652e737667)](https://packagist.org/packages/larva/laravel-sms)[![Latest Stable Version](https://camo.githubusercontent.com/9dc9dd0898701d067e88e2cc9c09b583c79ab3236b4ea2d6180c04d6adad3060/68747470733a2f2f706f7365722e707567782e6f72672f6c617276612f6c61726176656c2d736d732f762f737461626c652e706e67)](https://packagist.org/packages/larva/laravel-sms)[![Total Downloads](https://camo.githubusercontent.com/632801b3931c8ac5cb52701c5a749aa72b2c9d7e2ad8984f246bf516dbfbc760/68747470733a2f2f706f7365722e707567782e6f72672f6c617276612f6c61726176656c2d736d732f646f776e6c6f6164732e706e67)](https://packagist.org/packages/larva/laravel-sms)

特点
--

[](#特点)

1. 支持目前市面多家服务商
2. 一套写法兼容所有平台
3. 简单配置即可灵活增减服务商
4. 内置多种服务商轮询策略、支持自定义轮询策略
5. 统一的返回值格式，便于日志与监控
6. 自动轮询选择可用的服务商
7. 更多等你去发现与改进...

平台支持
----

[](#平台支持)

- [腾讯云 SMS](https://cloud.tencent.com/product/sms)
- [Ucloud](https://www.ucloud.cn)
- [七牛云](https://www.qiniu.com/)
- [SendCloud](http://www.sendcloud.net/)
- [阿里云](https://www.aliyun.com/)
- [云片](https://www.yunpian.com)
- [Submail](https://www.mysubmail.com)
- [螺丝帽](https://luosimao.com/)
- [容联云通讯](http://www.yuntongxun.com)
- [互亿无线](http://www.ihuyi.com)
- [聚合数据](https://www.juhe.cn)
- [百度云](https://cloud.baidu.com/)
- [华信短信平台](http://www.ipyy.com/)
- [253云通讯（创蓝）](https://www.253.com/)
- [融云](http://www.rongcloud.cn)
- [天毅无线](http://www.85hu.com/)
- [阿凡达数据](http://www.avatardata.cn/)
- [华为云](https://www.huaweicloud.com/product/msgsms.html)
- [网易云信](https://yunxin.163.com/sms)
- [云之讯](https://www.ucpaas.com/index.html)
- [凯信通](http://www.kingtto.cn/)
- [UE35.net](http://uesms.ue35.cn/)
- [短信宝](http://www.smsbao.com/)
- [Tiniyo](https://tiniyo.com/)
- [摩杜云](https://www.moduyun.com/)
- [融合云（助通）](https://www.ztinfo.cn/products/sms)
- [蜘蛛云](https://zzyun.com/)
- [融合云信](https://maap.wo.cn/)
- [天瑞云](http://cms.tinree.com/)

环境需求
----

[](#环境需求)

- PHP >= 8.0

Installation
------------

[](#installation)

```
composer require larva/laravel-sms
```

for Laravel
-----------

[](#for-laravel)

This service provider must be registered.

```
// config/app.php

'providers' => [
    '...',
    Larva\Sms\SmsServiceProvider::class,
];
```

add the config file: config/sms.php

add config

```
use Overtrue\EasySms\Strategies\OrderStrategy;

return [
    // HTTP 请求的超时时间（秒）
    'timeout' => 5.0,

    /*
    |--------------------------------------------------------------------------
    | Default Setting
    |--------------------------------------------------------------------------
    |
    | This option defines the default sms gateway that gets used when writing
    | messages to the sms. The name specified in this option should match
    | one of the gateways defined in the "gateways" configuration array.
    |
    */
    'default' => [
        // 网关调用策略，默认：顺序调用
        'strategy' => OrderStrategy::class,

        /*
        |--------------------------------------------------------------------------
        | Default Gateways
        |--------------------------------------------------------------------------
        |
        | This option defines the default sms gateway that gets used when writing
        | messages to the sms. The name specified in this option should match
        | one of the gateways defined in the "gateways" configuration array.
        |
        */
        'gateways' => [

        ],
    ],

    /*
    |--------------------------------------------------------------------------
    | Log Gateways
    |--------------------------------------------------------------------------
    |
    | Here you may configure the sms gateways for your application.  This gives
    | you a variety of powerful log handlers / formatters to utilize.
    |
    | Available Drivers: "aliyun", "alidayu", "yunpian", "submail",
    |                    "errorlog", "luosimao", "yuntongxun", "huyi"
    |                    "juhe", "sendcloud", "baidu", "huaxin", "chuanglan"
    |                    "rongcloud", "tianyiwuxian", "twilio", "qcloud", "avatardata"
    |
    */
    'gateways' => [
        //Doc
        // https://github.com/overtrue/easy-sms
    ],
];
```

Use
---

[](#use)

```
try {
    $res = sms('13800138000', ['content'  => '您的验证码为: 6379','template' => '259734', 'data' => [6379]]);
    print_r($res);
} catch (InvalidArgumentException $e) {
    print_r($e->getMessage());
} catch (NoGatewayAvailableException $e) {
    print_r($e->getMessage());
}
```

//如果要在 系统内使用短信通知通道 在User 模型增加

```
    /**
     * 获取手机号
     * @param \Illuminate\Notifications\Notification|null $notification
     * @return int
     */
    public function routeNotificationForPhone($notification)
    {
        return $this->phone;
    }
```

获取手机号，通知实体类的通知渠道写 phone

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance53

Moderate activity, may be stable

Popularity17

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 75% 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 ~174 days

Recently: every ~297 days

Total

10

Last Release

329d ago

Major Versions

1.0.8 → 2.0.02025-06-24

### Community

Maintainers

![](https://www.gravatar.com/avatar/534cdb651e8c806590fa945c6b5a18f361613848e890db1349f4a9fbcae1a650?d=identicon)[xutongle](/maintainers/xutongle)

---

Top Contributors

[![xutongle](https://avatars.githubusercontent.com/u/46956076?v=4)](https://github.com/xutongle "xutongle (9 commits)")[![xutl](https://avatars.githubusercontent.com/u/20939388?v=4)](https://github.com/xutl "xutl (3 commits)")

---

Tags

laravelphpsmslaravelsmsLarva

### Embed Badge

![Health badge](/badges/larva-laravel-sms/health.svg)

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

###  Alternatives

[laravel-notification-channels/twilio

Provides Twilio notification channel for Laravel

2587.7M12](/packages/laravel-notification-channels-twilio)

PHPackages © 2026

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