PHPackages                             quickhelper/quicksms - 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. quickhelper/quicksms

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

quickhelper/quicksms
====================

Comprehensive multi-channel SMS package for Laravel

v2.7.0(7mo ago)212MITPHPPHP >=8.2

Since Feb 16Pushed 7mo ago1 watchersCompare

[ Source](https://github.com/yossef-ashraf/QuickSMS)[ Packagist](https://packagist.org/packages/quickhelper/quicksms)[ RSS](/packages/quickhelper-quicksms/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (4)Versions (10)Used By (0)

Laravel QuickSMS Package
========================

[](#laravel-quicksms-package)

📦 Installation
--------------

[](#-installation)

```
composer require quickhelper/quicksms
```

⚙️ Configuration
----------------

[](#️-configuration)

Publish the config file:

```
php artisan vendor:publish --provider="QuickSMS\QuickSMSServiceProvider" --tag="config"
```

🔧 Environment Variables (.env)
------------------------------

[](#-environment-variables-env)

```
# QuickSMS Defaults
QUICKSMS_DEFAULT_PROVIDER=cequens
QUICKSMS_DEFAULT_TYPE=sms

# Cequens Provider
QUICKSMS_CEQUENS_URL=https://apis.cequens.com/sms/v1/messages
QUICKSMS_CEQUENS_TOKEN=your_api_token_here
QUICKSMS_CEQUENS_SENDER=Fabrikar
QUICKSMS_CEQUENS_TIMEOUT=10

# SMSMisr Provider
QUICKSMS_SMSMISR_URL=https://smsmisr.com/api/SMS
QUICKSMS_SMSMISR_OTP_URL=https://smsmisr.com/api/OTP
QUICKSMS_SMSMISR_USERNAME=your_username
QUICKSMS_SMSMISR_PASSWORD=your_password
QUICKSMS_SMSMISR_SENDER=your_sender_id
QUICKSMS_SMSMISR_ENVIRONMENT=1  # 1=live, 2=test
QUICKSMS_SMSMISR_LANGUAGE=1     # 1=English, 2=Arabic

# Viklink Provider
QUICKSMS_VIKLINK_URL=https://smsvas.vlserv.com/VLSMSPlatformResellerAPI/NewSendingAPI/api/SMSSender/SendSMSWithUserSMSIdAndValidity
QUICKSMS_VIKLINK_USERNAME=your_username
QUICKSMS_VIKLINK_PASSWORD=your_password
QUICKSMS_VIKLINK_SENDER=your_sender_id
QUICKSMS_VIKLINK_DEFAULT_LANG=E  # E=English, A=Arabic

# Twilio Provider
TWILIO_SMS_SID=your_twilio_sid
TWILIO_SMS_TOKEN=your_twilio_token
TWILIO_SMS_FROM=+1234567890
TWILIO_SMS_TIMEOUT=10
```

🚀 Basic Usage
-------------

[](#-basic-usage)

### Using SmsService (Multi-Provider)

[](#using-smsservice-multi-provider)

```
use QuickSMS\Services\SmsService;
use QuickSMS\Validators\SmsValidator;

$smsService = new SmsService(new SmsValidator());

// Send SMS via Cequens
$result = $smsService->send([
    'phone' => '+2010000000',
    'message' => 'Test message',
    'provider' => 'cequens',
    'type' => 'sms'
]);

// Send OTP via SMS Misr
$result = $smsService->send([
    'phone' => $phone,
    'message' => $otpCode,
    'type' => 'otp',
    'provider' => 'smsmisr',
    'template' => env('QUICKSMS_SMSMISR_OTP_TEMPLATE')
]);
```

### Using TwilioService (Dedicated)

[](#using-twilioservice-dedicated)

```
use QuickSMS\Services\TwilioService;

$twilioService = new TwilioService();
$result = $twilioService->send([
    'phone' => '+201234567890',
    'message' => 'Hello from Twilio!'
]);

// Response example:
// [
//     'success' => true,
//     'message' => 'Twilio SMS sent successfully',
//     'data' => [
//         'sid' => 'SM1234567890abcdef',
//         'status' => 'queued'
//     ]
// ]
```

### Dependency Injection

[](#dependency-injection)

```
use QuickSMS\Services\TwilioService;

class NotificationController extends Controller
{
    public function __construct(private TwilioService $twilioService)
    {
    }

    public function sendSMS()
    {
        $result = $this->twilioService->send([
            'phone' => '+201234567890',
            'message' => 'Your verification code is: 123456'
        ]);

        if ($result['success']) {
            return response()->json(['message' => 'SMS sent successfully']);
        }

        return response()->json(['error' => $result['message']], 400);
    }
}
```

🔍 Response Structure
--------------------

[](#-response-structure)

All methods return a standardized response array:

```
[
    'success' => true|false,
    'data' => [...], // Provider response data
    'message' => 'Status message',
    'provider' => 'provider_name'
]
```

📜 License
---------

[](#-license)

MIT Licensed

Best regards,
[Yossef Ashraf](https://github.com/yossef-ashraf)

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance65

Regular maintenance activity

Popularity8

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~30 days

Recently: every ~49 days

Total

9

Last Release

212d ago

Major Versions

v1.0.0 → v2.0.02025-04-04

PHP version history (2 changes)v2.1.0PHP ^8.2

v1.0.0PHP >=8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/3c4054a725ba98c7f70895a16ce6e1670cfe249a3dee6417c79513cbc89d4038?d=identicon)[yossef-ashraf](/maintainers/yossef-ashraf)

---

Top Contributors

[![yossef-ashraf](https://avatars.githubusercontent.com/u/82105736?v=4)](https://github.com/yossef-ashraf "yossef-ashraf (37 commits)")

---

Tags

phpsmssms-gatewaylaravelsmstwilio

### Embed Badge

![Health badge](/badges/quickhelper-quicksms/health.svg)

```
[![Health](https://phpackages.com/badges/quickhelper-quicksms/health.svg)](https://phpackages.com/packages/quickhelper-quicksms)
```

###  Alternatives

[grumpydictator/firefly-iii

Firefly III: a personal finances manager.

22.8k69.3k](/packages/grumpydictator-firefly-iii)[gehrisandro/tailwind-merge-laravel

TailwindMerge for Laravel merges multiple Tailwind CSS classes by automatically resolving conflicts between them

341682.2k18](/packages/gehrisandro-tailwind-merge-laravel)[backpack/basset

Dead-simple way to load CSS or JS assets only once per page, when using Laravel 10+.

202832.4k6](/packages/backpack-basset)[tzsk/sms

A robust and unified SMS gateway integration package for Laravel, supporting multiple providers.

320244.3k6](/packages/tzsk-sms)[firefly-iii/data-importer

Firefly III Data Import Tool.

7545.8k](/packages/firefly-iii-data-importer)[nickurt/laravel-akismet

Akismet for Laravel 11.x/12.x/13.x

97139.6k2](/packages/nickurt-laravel-akismet)

PHPackages © 2026

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