Repolode
Enviar
overtrue

overtrue/easy-sms

Biblioteca PHP para enviar SMS por vários provedores chineses e internacionais com uma API unificada, suporte a failover e estratégias de gateway.

Ver no GitHub
Estrelas
3,334
Forks
565
Issues abertas
23
Último commit
mês passado

O que é?

Easy SMS é um componente PHP para enviar mensagens de texto por vários provedores de SMS usando uma única convenção de chamada. Os desenvolvedores configuram um ou mais gateways, como Alibaba Cloud, Tencent Cloud, Huawei Cloud, Yunpian ou Twilio, e chamam um único método de envio, independentemente do provedor que processa a mensagem.

Quando vários gateways estão configurados, a biblioteca tenta usá-los em ordem ou conforme outra estratégia, permitindo contornar automaticamente um provedor com falha. Cada envio retorna um array de resultados por gateway, com o status e a resposta do provedor, e lança uma exceção específica quando todos os gateways falham. O conteúdo da mensagem pode ser informado como texto simples, ID de template com variáveis ou classe de mensagem; também é possível registrar gateways personalizados com uma closure.

O pacote requer PHP 8.4 ou mais recente e Guzzle 7 ou 8, e é instalado com o Composer.

Recursos principais

  • 01API de envio unificada para dezenas de provedores chineses e internacionais de SMS.
  • 02Vários gateways com estratégias ordenadas ou personalizadas e failover automático.
  • 03Array de resultados por gateway e uma exceção específica quando todos os gateways falham.
  • 04Suporte a conteúdo em texto simples, IDs de template com variáveis e classes de mensagem reutilizáveis.
  • 05É possível registrar gateways personalizados sem modificar a biblioteca.

Casos de uso

  • Enviar códigos de verificação em uma aplicação web PHP com um provedor de fallback.
  • Trocar de fornecedor de SMS sem reescrever o código da aplicação.
  • Enviar notificações baseadas em templates por meio da Alibaba Cloud ou da Tencent Cloud a partir de um backend PHP.
  • Registrar os resultados de envio de vários provedores para monitoramento.

Início rápido

  1. 1

    Instale o pacote com o Composer

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

    Crie uma instância de EasySms com a configuração do gateway e chame send()

Antes de usar

  • Requer PHP 8.4 ou mais recente.
  • Cada provedor de SMS precisa de uma conta e credenciais próprias, então você deve se cadastrar nos provedores que usar.
  • O Guzzle 8 exige que os valores das opções de cabeçalho sejam strings. Portanto, valores que não sejam strings na configuração do gateway causarão um erro.

Tópicos

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

Perguntas frequentes

O que é easy-sms?
Biblioteca PHP para enviar SMS por vários provedores chineses e internacionais com uma API unificada, suporte a failover e estratégias de gateway. Easy SMS é um componente PHP para enviar mensagens de texto por vários provedores de SMS usando uma única convenção de chamada. Os desenvolvedores configuram um ou mais gateways, como Alibaba Cloud, Tencent Cloud, Huawei Cloud, Yunpian ou Twilio, e chamam um único método de envio, independentemente do provedor que processa a mensagem.
easy-sms é gratuito? Qual é a licença?
easy-sms é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
easy-sms ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de easy-sms foi em 4 de out. de 2026.
Para que posso usar easy-sms?
Enviar códigos de verificação em uma aplicação web PHP com um provedor de fallback. Trocar de fornecedor de SMS sem reescrever o código da aplicação. Enviar notificações baseadas em templates por meio da Alibaba Cloud ou da Tencent Cloud a partir de um backend PHP. Registrar os resultados de envio de vários provedores para monitoramento.
Como instalar easy-sms?
Instale o pacote com o Composer: composer require "overtrue/easy-sms" Crie uma instância de EasySms com a configuração do gateway e chame send()
Onde consigo easy-sms?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/overtrue/easy-sms

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados