Repolode
overtrue

overtrue/easy-sms

PHP-библиотека для отправки SMS через множество китайских и международных провайдеров с единым API, поддержкой переключения при сбоях и стратегий выбора шлюзов.

Звёзды
3,334
Форки
563
Открытые issues
23
Последний коммит
в прошлом месяце

Что это?

Easy SMS — компонент на PHP для отправки текстовых сообщений через несколько SMS-провайдеров с единым интерфейсом вызова. Разработчик настраивает один или несколько шлюзов, например Alibaba Cloud, Tencent Cloud, Huawei Cloud, Yunpian или Twilio, и вызывает один метод отправки независимо от того, какой провайдер обработает сообщение.

Если настроено несколько шлюзов, библиотека обращается к ним по порядку или использует другую стратегию, автоматически обходя провайдера, который не отвечает. Каждый вызов отправки возвращает массив результатов по шлюзам со статусом и ответом провайдера. Если все шлюзы завершились ошибкой, выбрасывается специальное исключение. Сообщение можно передать обычным текстом, указать ID шаблона с переменными или передать класс сообщения. Пользовательские шлюзы регистрируются с помощью closure.

Для работы пакета требуются PHP 8.4 или новее и Guzzle 7 или 8. Установка выполняется через Composer.

Ключевые возможности

  • 01Единый API отправки для десятков китайских и международных SMS-провайдеров.
  • 02Несколько шлюзов с последовательной или пользовательской стратегией и автоматическим переключением при сбоях.
  • 03Массив результатов по каждому шлюзу и специальное исключение, если все шлюзы завершились ошибкой.
  • 04Поддержка обычного текста, ID шаблонов с переменными и повторно используемых классов сообщений.
  • 05Пользовательские шлюзы можно регистрировать без изменения библиотеки.

Сценарии использования

  • Отправка кодов подтверждения в PHP-приложении с резервным провайдером.
  • Смена SMS-провайдера без переписывания кода приложения.
  • Отправка уведомлений по шаблонам через Alibaba Cloud или Tencent Cloud из серверной части на PHP.
  • Сбор результатов отправки от нескольких провайдеров для мониторинга.

Быстрый старт

  1. 1

    Установите пакет с помощью Composer

    composer require "overtrue/easy-sms"
  2. 2

    Создайте экземпляр EasySms с конфигурацией шлюза и вызовите send()

Что важно знать

  • Требуется PHP 8.4 или новее.
  • Для каждого SMS-провайдера нужны отдельная учетная запись и учетные данные, поэтому необходимо зарегистрироваться у используемых провайдеров.
  • В Guzzle 8 значения параметров заголовков должны быть строками, поэтому нестроковые значения в конфигурации шлюза приведут к ошибке.

Темы

#sms#php#messaging#notification#api-client#verification-code#php-sms#sms-client#sms-gateway

Частые вопросы

Что такое easy-sms?
PHP-библиотека для отправки SMS через множество китайских и международных провайдеров с единым API, поддержкой переключения при сбоях и стратегий выбора шлюзов. Easy SMS — компонент на PHP для отправки текстовых сообщений через несколько SMS-провайдеров с единым интерфейсом вызова. Разработчик настраивает один или несколько шлюзов, например Alibaba Cloud, Tencent Cloud, Huawei Cloud, Yunpian или Twilio, и вызывает один метод отправки независимо от того, какой провайдер обработает сообщение.
easy-sms можно использовать бесплатно? Какая у него лицензия?
easy-sms распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
easy-sms всё ещё поддерживается?
Обновлялся за последние 6 месяцев. Последний коммит в easy-sms — 4 окт. 2026 г..
Для чего можно использовать easy-sms?
Отправка кодов подтверждения в PHP-приложении с резервным провайдером. Смена SMS-провайдера без переписывания кода приложения. Отправка уведомлений по шаблонам через Alibaba Cloud или Tencent Cloud из серверной части на PHP. Сбор результатов отправки от нескольких провайдеров для мониторинга.
Как установить easy-sms?
Установите пакет с помощью Composer: composer require "overtrue/easy-sms" Создайте экземпляр EasySms с конфигурацией шлюза и вызовите send()
Где скачать easy-sms?
Исходный код и инструкции по установке — на GitHub: https://github.com/overtrue/easy-sms

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Превращает Android-телефон в SMS-шлюз, позволяя отправлять и получать сообщения через простой HTTP API.

6,3 тыс.+137 за неделю1,2 тыс.GoAGPL-3.0Обновлён 5 дней назад

Инфраструктура с открытым исходным кодом для уведомлений и общения с агентами: отправка сообщений в Inbox, Email, SMS, Push, Chat и Slack через единый API.

40,3 тыс.+63 за неделю4,5 тыс.TypeScriptOtherАктивно поддерживаетсяОбновлён 22 часа назад

Icinga 2 — сервер мониторинга, который проверяет сетевые ресурсы, сообщает пользователям о сбоях и собирает данные о производительности.

DevOps и облака#monitoring#distributed-monitoring#metrics
2,2 тыс.623C++GPL-3.0Активно поддерживаетсяОбновлён 20 часов назад