Download the PHP package yasser-elgammal/lara-sms without Composer
On this page you can find all versions of the php package yasser-elgammal/lara-sms. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download yasser-elgammal/lara-sms
More information about yasser-elgammal/lara-sms
Files in yasser-elgammal/lara-sms
Package lara-sms
Short Description A package to sending SMS for laravel projects.
License MIT
Informations about the package lara-sms
Lara SMS Gateway Package
A powerful and flexible Laravel SMS gateway package with support for multiple providers
(MobilySms, Msegat, Dreams, Taqnyat, Jawaly, Infobip, Twilio, Vonage, Unifonic, SMS Misr)
intelligent fallback mechanisms, and a fluent builder pattern for clean message construction.
Features
- ✅ Multiple Gateway Support - Twilio, Vonage, SMS Misr, Jawaly (easily add more)
- ✅ Strategy Pattern - Pluggable gateway architecture
- ✅ Fluent Builder Pattern - Clean, intuitive message construction
- ✅ Fallback Strategies - Try All, Fail Fast, custom ordering
- ✅ Intelligent Retries - Automatic retries for transient failures
- ✅ Error Differentiation - Retryable vs Non-retryable errors
- ✅ Clean DTOs - Structured message and result objects
- ✅ Configuration Driven - All settings in config files
- ✅ Laravel Facade - Easy access from anywhere
- ✅ Comprehensive Logging - Full audit trail of all attempts
- ✅ Metadata Support - Attach custom data to messages
Installation
Step 1: Install via Composer
Step 2: Publish Configuration
Step 3: Add Environment Variables
Add needed sms gateways to your .env file:
Step 4: Clear Cache
Quick Start
Simplest Usage - Quick Send
Usage Guide
Basic Usage
1. Quick Send (One-liner)
2. Builder with Basic Fields
3. Builder with All Fields
Builder Pattern - Complete Reference
The builder provides a fluent interface for constructing SMS messages with full control over sending options.
Setting Recipients and Messages
Adding Metadata
Attach custom data to your SMS:
Controlling Fallback Strategies
Gateway Selection and Ordering
Behavior:
- Stops immediately on non-retryable error (auth, invalid phone, etc.)
- Continues on retryable errors (timeout, server 5xx)
- More cost-effective
- Faster failure response
Custom Gateway Order
Error Handling
Understanding SmsResult
🤝 Contributing
Pull requests are welcome! For major changes, please open an issue first to discuss what you’d like to modify.
⚖️ License
MIT © 2025 Yasser Elgammal