PHPackages                             sarkhanrasimoghlu/lsim - 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. [API Development](/categories/api)
4. /
5. sarkhanrasimoghlu/lsim

ActiveLibrary[API Development](/categories/api)

sarkhanrasimoghlu/lsim
======================

Laravel package for LSIM SMS gateway integration (send SMS, check balance, delivery reports)

v2.1.0(1mo ago)424MITPHPPHP ^8.3

Since Mar 13Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/Rasimoghlu/laravel-lsim-single-sms-package)[ Packagist](https://packagist.org/packages/sarkhanrasimoghlu/lsim)[ Docs](https://github.com/Rasimoghlu/laravel-lsim-single-sms-package)[ RSS](/packages/sarkhanrasimoghlu-lsim/feed)WikiDiscussions Master Synced 1mo ago

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

LSIM SMS Package for Laravel
============================

[](#lsim-sms-package-for-laravel)

[![Latest Version](https://camo.githubusercontent.com/feefd94aa918199c1c34e316302f322c3deae3d6c568c518324f1eb0d2db7a6d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7361726b68616e726173696d6f67686c752f6c73696d2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sarkhanrasimoghlu/lsim)[![Total Downloads](https://camo.githubusercontent.com/d1805efd7fba5a6955d34cd21cc579bf6e275979f4626b884ba1b3738d656e99/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7361726b68616e726173696d6f67686c752f6c73696d2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sarkhanrasimoghlu/lsim)

Laravel package for LSIM SMS gateway integration. Send SMS, check balance, and track delivery reports.

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

[](#requirements)

DependencyVersionPHP^8.3Laravel^12.0GuzzleHttp^7.8Installation
------------

[](#installation)

```
composer require sarkhanrasimoghlu/lsim
```

The service provider and `SMS` facade are registered automatically via package auto-discovery.

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

[](#configuration)

Publish the config file:

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

Add the following to your `.env` file:

```
LSIM_LOGIN=your_login
LSIM_PASSWORD=your_password
LSIM_SENDER=your_sender_name
```

### All Configuration Options

[](#all-configuration-options)

KeyEnv VariableDefaultDescription`login``LSIM_LOGIN`-API login (required)`password``LSIM_PASSWORD`-API password (required)`sender``LSIM_SENDER`-Sender name (required)`base_url``LSIM_BASE_URL``https://apps.lsim.az/quicksms`API base URL`timeout``LSIM_TIMEOUT``30`HTTP timeout in seconds`verify_ssl``LSIM_VERIFY_SSL``true`Verify SSL certificates`logging.channel``LSIM_LOG_CHANNEL``stack`Log channel`logging.level``LSIM_LOG_LEVEL``info`Log levelUsage
-----

[](#usage)

### Send SMS

[](#send-sms)

```
use Sarkhanrasimoghlu\Lsim\Facades\SMS;

$response = SMS::send('994501234567', 'Hello World');

if ($response->isSuccessful()) {
    echo $response->getMessageId(); // transaction ID
}
```

### Send Unicode SMS

[](#send-unicode-sms)

```
$response = SMS::send('994501234567', 'Salam dunya', unicode: true);
```

### Check Balance

[](#check-balance)

```
$response = SMS::getBalance();

if ($response->isSuccessful()) {
    echo $response->getBalance(); // integer
}
```

### Get Delivery Report

[](#get-delivery-report)

```
$response = SMS::getReport($transactionId);

if ($response->isSuccessful()) {
    echo $response->getStatus()->name; // e.g. "Delivered"
    echo $response->isDelivered();     // true/false
}
```

### Using Dependency Injection

[](#using-dependency-injection)

```
use Sarkhanrasimoghlu\Lsim\Contracts\SmsServiceInterface;

class NotificationService
{
    public function __construct(
        private SmsServiceInterface $sms,
    ) {}

    public function notify(string $phone, string $text): bool
    {
        $response = $this->sms->send($phone, $text);
        return $response->isSuccessful();
    }
}
```

### Error Handling

[](#error-handling)

```
use Sarkhanrasimoghlu\Lsim\Facades\SMS;
use Sarkhanrasimoghlu\Lsim\Exceptions\SmsException;
use Sarkhanrasimoghlu\Lsim\Exceptions\InvalidMessageException;

try {
    $response = SMS::send($phone, $text);

    if ($response->hasError()) {
        $errorCode = $response->getErrorCode(); // ErrorCode enum or null
        $errorMessage = $response->getErrorMessage();
    }
} catch (InvalidMessageException $e) {
    // Invalid phone number or message text
} catch (SmsException $e) {
    // HTTP or other service error
}
```

Error Codes
-----------

[](#error-codes)

CodeEnum CaseDescription-100`InvalidKey`Invalid API key-101`TextTooLong`Message text is too long-102`WrongNumberFormat`Wrong phone number format-103`InvalidSenderName`Invalid sender name-104`InsufficientBalance`Insufficient account balance-105`NumberInBlackList`Phone number is in the blacklist-106`InvalidTransactionId`Invalid transaction ID-107`IpNotAllowed`IP address is not allowed-108`InvalidHash`Invalid hash signature-109`NoHost`No host available-110`ReportingLimitExceeded`Reporting limit exceeded-500`InternalError`Internal server errorDelivery Statuses
-----------------

[](#delivery-statuses)

CodeEnum CaseDescription100`InQueue`Message is in queue101`Delivered`Message delivered successfully102`Undelivered`Message could not be delivered103`Expired`Message expired104`Rejected`Message rejected105`Cancelled`Message cancelled106`Error`Delivery error107`Unknown`Unknown delivery status108`Sent`Message sent to operator109`BlackList`Number is in blacklistAPI Endpoints
-------------

[](#api-endpoints)

All endpoints use GET requests. The package appends these paths to the `base_url`:

EndpointPathDescriptionSend SMS`/v1/send`Send a single SMSBalance`/v1/balance`Check account balanceReport`/v1/report`Get delivery report by transaction IDTesting
-------

[](#testing)

```
composer test
```

Run with coverage:

```
composer test-coverage
```

Exception Hierarchy
-------------------

[](#exception-hierarchy)

```
SmsException (base)
├── InvalidMessageException
├── BalanceException
├── HttpException
└── InvalidConfigurationException

```

License
-------

[](#license)

MIT. See [LICENSE.md](LICENSE.md) for details.

###  Health Score

48

—

FairBetter than 94% of packages

Maintenance88

Actively maintained with recent releases

Popularity11

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity71

Established project with proven stability

 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 ~122 days

Recently: every ~364 days

Total

13

Last Release

58d ago

Major Versions

v1.1.4 → v2.0.02025-12-08

PHP version history (2 changes)v1.0.0PHP ^8.0

v2.0.0PHP ^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/ae61db9af709b6627962b092af645e79d96f56ba9faf4d37df3af02b457c732b?d=identicon)[Rasimoghlu](/maintainers/Rasimoghlu)

---

Top Contributors

[![Rasimoghlu](https://avatars.githubusercontent.com/u/45317065?v=4)](https://github.com/Rasimoghlu "Rasimoghlu (16 commits)")

---

Tags

phplaravelsmslaravel-smssend smsquicksmslsim

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/sarkhanrasimoghlu-lsim/health.svg)

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

###  Alternatives

[openai-php/laravel

OpenAI PHP for Laravel is a supercharged PHP API client that allows you to interact with the Open AI API

3.7k7.6M74](/packages/openai-php-laravel)[mozex/anthropic-laravel

Anthropic PHP for Laravel is a supercharged PHP API client that allows you to interact with the Anthropic API

71226.4k1](/packages/mozex-anthropic-laravel)[nickurt/laravel-postcodeapi

Universal PostcodeApi for Laravel 11.x/12.x/13.x

97221.2k](/packages/nickurt-laravel-postcodeapi)[scriptdevelop/whatsapp-manager

Paquete para manejo de WhatsApp Business API en Laravel

762.6k](/packages/scriptdevelop-whatsapp-manager)

PHPackages © 2026

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