PHPackages                             dilumsadeepa/dev-sms-gateway-laravel-package - 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. [Mail & Notifications](/categories/mail)
4. /
5. dilumsadeepa/dev-sms-gateway-laravel-package

ActiveLibrary[Mail & Notifications](/categories/mail)

dilumsadeepa/dev-sms-gateway-laravel-package
============================================

Laravel package for Puppy SMS Gateway (auth, environments, API keys, SMS send/status)

v1.0.0(4mo ago)011MITPHPPHP ^8.1

Since Feb 23Pushed 4mo agoCompare

[ Source](https://github.com/dilumsadeepa/DEV-SMS-Gateway-Laravel-package)[ Packagist](https://packagist.org/packages/dilumsadeepa/dev-sms-gateway-laravel-package)[ RSS](/packages/dilumsadeepa-dev-sms-gateway-laravel-package/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (3)Versions (2)Used By (0)

DEV SMS Gateway Laravel Package
===============================

[](#dev-sms-gateway-laravel-package)

Laravel package for integrating with `puppy-sms-gateway-server`.

It supports:

- user register/login
- environment creation
- environment API key management
- SMS send via environment API key
- status polling and account logs

Requirements
------------

[](#requirements)

- PHP 8.1+
- Laravel 9/10/11/12
- `guzzlehttp/guzzle` (installed automatically)

Install
-------

[](#install)

### Option 1: Packagist (after publish)

[](#option-1-packagist-after-publish)

```
composer require dilumsadeepa/dev-sms-gateway-laravel-package
```

### Option 2: GitHub VCS (before Packagist)

[](#option-2-github-vcs-before-packagist)

```
composer config repositories.dev-sms-gateway vcs https://github.com/dilumsadeepa/DEV-SMS-Gateway-Laravel-package.git
composer require dilumsadeepa/dev-sms-gateway-laravel-package:dev-main
```

Publish Config
--------------

[](#publish-config)

```
php artisan vendor:publish --tag=puppy-sms-gateway-config
```

Configuration
-------------

[](#configuration)

Set values in your Laravel `.env`:

```
PUPPY_SMS_GATEWAY_BASE_URL=http://127.0.0.1:8090

# Environment API key (used for send/status)
PUPPY_SMS_GATEWAY_API_KEY=

# Auth token (used for account endpoints: /api/auth/me, /api/environments, /api/account/logs)
PUPPY_SMS_GATEWAY_AUTH_TOKEN=

# Optional default pin. Not required when using environment API key.
PUPPY_SMS_GATEWAY_PIN=

PUPPY_SMS_GATEWAY_TIMEOUT=20
PUPPY_SMS_GATEWAY_SEND_ENDPOINT=/api/send-sms
PUPPY_SMS_GATEWAY_HEALTH_ENDPOINT=/health
PUPPY_SMS_GATEWAY_STATUS_ENDPOINT=/api/status
PUPPY_SMS_GATEWAY_LOGS_ENDPOINT=/api/account/logs
PUPPY_SMS_GATEWAY_REGISTER_ENDPOINT=/api/auth/register
PUPPY_SMS_GATEWAY_LOGIN_ENDPOINT=/api/auth/login
PUPPY_SMS_GATEWAY_ME_ENDPOINT=/api/auth/me
PUPPY_SMS_GATEWAY_LOGOUT_ENDPOINT=/api/auth/logout
PUPPY_SMS_GATEWAY_ENVIRONMENTS_ENDPOINT=/api/environments
```

Quick Start (Full Flow)
-----------------------

[](#quick-start-full-flow)

```
use Puppy\SmsGateway\Laravel\Facades\PuppySmsGateway;

// 1) Register (creates account only)
PuppySmsGateway::register('Alice', 'alice@example.com', 'StrongPass123');

// 2) Login
$login = PuppySmsGateway::login('alice@example.com', 'StrongPass123');
$token = $login['token'];
PuppySmsGateway::setAuthToken($token);

// 3) Create environment (returns default environment API key)
$environment = PuppySmsGateway::createEnvironment(
    name: 'Production',
    pin: '1234',
    description: 'Main Android device',
    metadata: ['region' => 'us']
);

$apiKey = $environment['apiKey'];
PuppySmsGateway::setApiKey($apiKey);

// 4) Send SMS with environment API key
$send = PuppySmsGateway::send('+14075551234', 'Hello from Laravel package');

// 5) Poll status (uses API key by default)
$status = PuppySmsGateway::status($send['requestId']);
```

Common Operations
-----------------

[](#common-operations)

```
use Puppy\SmsGateway\Laravel\Facades\PuppySmsGateway;

$health = PuppySmsGateway::health();
$me = PuppySmsGateway::me();
$environments = PuppySmsGateway::environments();
$apiKeys = PuppySmsGateway::listApiKeys('');
$newKey = PuppySmsGateway::createApiKey('', 'backend-service');
$revoke = PuppySmsGateway::revokeApiKey('', '');
$logs = PuppySmsGateway::logs(); // requires auth token
```

Notes
-----

[](#notes)

- `send()` requires an environment API key.
- `status()` accepts either API key or auth token.
- `logs()` uses account endpoint and requires auth token.
- If SMS device acknowledgement times out, `send()` returns a pending-style response from the server.

License
-------

[](#license)

MIT

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance76

Regular maintenance activity

Popularity2

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity43

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

Unknown

Total

1

Last Release

131d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/bdffae56a892e7eb29a94ce1d538015bb60ac3d89487cf521fcd3b6945e1f812?d=identicon)[Dilum Sadeepa](/maintainers/Dilum%20Sadeepa)

---

Top Contributors

[![dilumsadeepa](https://avatars.githubusercontent.com/u/51749100?v=4)](https://github.com/dilumsadeepa "dilumsadeepa (2 commits)")

---

Tags

laravelnotificationsmsgatewayapi-key

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/dilumsadeepa-dev-sms-gateway-laravel-package/health.svg)

```
[![Health](https://phpackages.com/badges/dilumsadeepa-dev-sms-gateway-laravel-package/health.svg)](https://phpackages.com/packages/dilumsadeepa-dev-sms-gateway-laravel-package)
```

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.6M3.1k](/packages/craftcms-cms)[gr8shivam/laravel-sms-api

A modern, flexible Laravel package for integrating any SMS gateway with REST API support

10240.6k](/packages/gr8shivam-laravel-sms-api)[sebdesign/laravel-viva-payments

A Laravel package for integrating the Viva Payments gateway

4851.0k](/packages/sebdesign-laravel-viva-payments)[simplestats-io/laravel-client

Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof.

5021.9k](/packages/simplestats-io-laravel-client)[ghanem/laravel-smsmisr

Send SMS and SMS Notification via SMS Misr for Laravel

205.0k](/packages/ghanem-laravel-smsmisr)

PHPackages © 2026

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