Repolode
Enviar
overtrue

overtrue/easy-sms

Biblioteca PHP para enviar SMS mediante proveedores chinos e internacionales con una API unificada, con estrategias de respaldo y de selección de gateways.

Ver en GitHub
Estrellas
3,334
Forks
565
Issues abiertos
23
Último commit
el mes pasado

¿Qué es?

Easy SMS es un componente PHP para enviar mensajes de texto a través de varios proveedores de SMS con una única convención de llamadas. Los desarrolladores configuran uno o más gateways, como Alibaba Cloud, Tencent Cloud, Huawei Cloud, Yunpian o Twilio, y llaman a un único método de envío, independientemente del proveedor que gestione el mensaje.

Cuando se configuran varios gateways, la biblioteca los prueba en orden o aplica otra estrategia, de modo que puede omitir automáticamente a un proveedor que falle. Cada envío devuelve un array de resultados por gateway con el estado y la respuesta del proveedor, y lanza una excepción específica si fallan todos los gateways. El contenido del mensaje puede proporcionarse como texto sin formato, como un ID de plantilla con variables o como una clase de mensaje; además, se pueden registrar gateways personalizados mediante una closure.

El paquete requiere PHP 8.4 o posterior y Guzzle 7 u 8, y se instala con Composer.

Funciones clave

  • 01API de envío unificada para decenas de proveedores chinos e internacionales de SMS.
  • 02Varios gateways con estrategias ordenadas o personalizadas y failover automático.
  • 03Array de resultados por gateway y una excepción específica cuando fallan todos los gateways.
  • 04Admite contenido en texto sin formato, IDs de plantilla con variables y clases de mensaje reutilizables.
  • 05Se pueden registrar gateways personalizados sin modificar la biblioteca.

Casos de uso

  • Enviar códigos de verificación desde una aplicación web en PHP con un proveedor alternativo.
  • Cambiar de proveedor de SMS sin reescribir el código de la aplicación.
  • Enviar notificaciones basadas en plantillas mediante Alibaba Cloud o Tencent Cloud desde un backend PHP.
  • Registrar los resultados de envío de varios proveedores para supervisarlos.

Inicio rápido

  1. 1

    Instala el paquete con Composer

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

    Crea una instancia de EasySms con la configuración de la pasarela y llama a send()

Antes de usarlo

  • Requiere PHP 8.4 o posterior.
  • Cada proveedor de SMS necesita su propia cuenta y credenciales, así que debes registrarte con los proveedores que utilices.
  • Guzzle 8 requiere que los valores de las opciones de encabezado sean cadenas, por lo que los valores que no sean cadenas en la configuración de la pasarela provocarán un error.

Temas

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

Preguntas frecuentes

¿Qué es easy-sms?
Biblioteca PHP para enviar SMS mediante proveedores chinos e internacionales con una API unificada, con estrategias de respaldo y de selección de gateways. Easy SMS es un componente PHP para enviar mensajes de texto a través de varios proveedores de SMS con una única convención de llamadas. Los desarrolladores configuran uno o más gateways, como Alibaba Cloud, Tencent Cloud, Huawei Cloud, Yunpian o Twilio, y llaman a un único método de envío, independientemente del proveedor que gestione el mensaje.
¿easy-sms es gratuito? ¿Qué licencia tiene?
easy-sms es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿easy-sms sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de easy-sms fue el 4 oct 2026.
¿Para qué puedo usar easy-sms?
Enviar códigos de verificación desde una aplicación web en PHP con un proveedor alternativo. Cambiar de proveedor de SMS sin reescribir el código de la aplicación. Enviar notificaciones basadas en plantillas mediante Alibaba Cloud o Tencent Cloud desde un backend PHP. Registrar los resultados de envío de varios proveedores para supervisarlos.
¿Cómo se instala easy-sms?
Instala el paquete con Composer: composer require "overtrue/easy-sms" Crea una instancia de EasySms con la configuración de la pasarela y llama a send()
¿Dónde consigo easy-sms?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/overtrue/easy-sms

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados