PHPackages                             ersalak/ersalak-laravel-sms - 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. ersalak/ersalak-laravel-sms

ActiveLaravel-package[API Development](/categories/api)

ersalak/ersalak-laravel-sms
===========================

A modern Laravel SMS client for sending and reporting messages via REST API

1.0.0(7mo ago)23MITPHPPHP ^8.0 || ^8.1 || ^8.2

Since Sep 21Pushed 7mo agoCompare

[ Source](https://github.com/RezaKarimpour/ersalak-laravel-sms)[ Packagist](https://packagist.org/packages/ersalak/ersalak-laravel-sms)[ Docs](https://github.com/RezaKarimpour/ersalak-laravel-sms)[ RSS](/packages/ersalak-ersalak-laravel-sms/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

📦 Laravel SMS Client
====================

[](#-laravel-sms-client)

یک پکیج لاراولی برای ارسال پیامک با استفاده از API Ersalak، طراحی شده برای توسعه‌پذیری، خوانایی و تجربه توسعه ساده.

برای ثبت نام و دریافت پنل پیامک:

---

🔧 نصب پکیج
----------

[](#-نصب-پکیج)

ابتدا از طریق Composer نصب کنید:

```
composer require ersalak/ersalak-laravel-sms
```

سپس فایل پیکربندی را publish نمایید:

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

و فایل `.env` پروژه را با مقادیر زیر تکمیل کنید:

```
ERSALAK_SMS_USERNAME=your-username
ERSALAK_SMS_PASSWORD=your-password
ERSALAK_SMS_BASE_URL=https://sms.ersalak.ir
ERSALAK_SMS_LOG=true
```

پکیج به صورت اتوماتیک provider و facade را به اپلیکیشن اضافه می‌کند، نیاز به تعریف دستی نیست.

---

✅ استفاده در پروژه لاراول
-------------------------

[](#-استفاده-در-پروژه-لاراول)

### 1. ارسال پیامک ساده در کنترلر

[](#1-ارسال-پیامک-ساده-در-کنترلر)

```
use Ersalak\Sms\Facade\ErsalakSmsFacade as ErsalakSms;

public function send()
{
    try {
        $data = ErsalakSms::sendSms(
            source: '9821XXXXX',
            destination: '09120000000',
            message: 'کد تایید شما: 123456',
            send_to_black_list: 1
        );
        //Log or save $data as messageIds for get message status report

    } catch (\Throwable $e) {
        echo $e->getMessage();
    }
}
```

### 2. پیامک نظیر به نظیر (P2P)

[](#2-پیامک-نظیر-به-نظیر-p2p)

```
use Ersalak\Sms\Facade\ErsalakSmsFacade as ErsalakSms;

try {
    $data = ErsalakSms::p2p(
        source: ['9821XXX1', '9821XXX2'],
        destination: ['09120000000', '09120000001'],
        message: ['متن اول', 'متن دوم'],
        send_to_black_list: [1, 0]
    );
    $messageIds = array_column($data, 'messageId');
} catch (\Throwable $e) {
    echo $e->getMessage();
}
```

### 3. پیامک OTP با قالب

[](#3-پیامک-otp-با-قالب)

```
use Ersalak\Sms\Facade\ErsalakSmsFacade as ErsalakSms;

try {
    $data = ErsalakSms::template(
        template_id: 1234,
        parameters: ['code' => 67890],
        destination: '09120000000'
    );
    //Log or save $data as messageIds for get message status report
} catch (\Throwable $e) {
    echo $e->getMessage();
}
```

### 4. مشاهده وضعیت پیامک

[](#4-مشاهده-وضعیت-پیامک)

```
use Ersalak\Sms\Facade\ErsalakSmsFacade as ErsalakSms;

try {
    $data = ErsalakSms::msgStatus(['msgid1', 'msgid2']);
} catch (\Throwable $e) {
    echo $e->getMessage();
}
```

### 5. دریافت اعتبار پیامکی

[](#5-دریافت-اعتبار-پیامکی)

```
use Ersalak\Sms\Facade\ErsalakSmsFacade as ErsalakSms;

try {
    $data = ErsalakSms::getCredit();
    $credit = $data['credit'] ?? null;
} catch (\Throwable $e) {
    echo $e->getMessage();
}
```

### 7. مشاهده موجودی اعتبار پیامکی (ریال)

[](#7-مشاهده-موجودی-اعتبار-پیامکی-ریال)

```
use Ersalak\Sms\Facade\ErsalakSmsFacade as ErsalakSms;

try {
    $data = ErsalakSms::getRialCredit();
    $credit = $data['credit'] ?? null;
} catch (\Throwable $e) {
    echo $e->getMessage();
}
```

### 8. دریافت لیست قالب‌های پیامک

[](#8-دریافت-لیست-قالب‌های-پیامک)

```
use Ersalak\Sms\Facade\ErsalakSmsFacade as ErsalakSms;

try {
    $templates = ErsalakSms::getTemplates();
} catch (\Throwable $e) {
    echo $e->getMessage();
}
```

---

🧰 لاگ‌گذاری و مانیتورینگ
------------------------

[](#-لاگ‌گذاری-و-مانیتورینگ)

در صورتی که مقدار `ERSALAK_SMS_LOG` در `.env` برابر `true` باشد، لاگ درخواست‌ها و پاسخ‌ها در `log` لاراول ثبت می‌گردد.

---

🧪 تست پکیج در پروژه واقعی
-------------------------

[](#-تست-پکیج-در-پروژه-واقعی)

پیشنهاد می‌شود برای تست اولیه، از ابزارهایی مانند [Mailtrap](https://mailtrap.io/) یا [Postman](https://postman.com) استفاده نمایید تا عملکرد API و پارامترهای ارسال را بررسی کنید.

---

🙋‍♂️ پشتیبانی
-------------

[](#‍️-پشتیبانی)

📞 تماس: [02191091557](https://ersalak.ir/contact)

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance62

Regular maintenance activity

Popularity6

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity48

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

233d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/098d014326605a1d110050b182fc3bb55ec38840c7df69bf4acf9725b9375234?d=identicon)[RezaKarimpour](/maintainers/RezaKarimpour)

---

Top Contributors

[![RezaKarimpour](https://avatars.githubusercontent.com/u/116279493?v=4)](https://github.com/RezaKarimpour "RezaKarimpour (3 commits)")

---

Tags

apilaravelsmsErsalak

### Embed Badge

![Health badge](/badges/ersalak-ersalak-laravel-sms/health.svg)

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

###  Alternatives

[smodav/mpesa

M-Pesa API implementation

16363.7k1](/packages/smodav-mpesa)[ardakilic/mutlucell

Mutlucell SMS API wrapper for sending sms text messages for Laravel

457.3k](/packages/ardakilic-mutlucell)[gr8shivam/laravel-sms-api

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

10138.4k](/packages/gr8shivam-laravel-sms-api)[dariusiii/tmdb-laravel

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

1821.1k](/packages/dariusiii-tmdb-laravel)[bushlanov-dev/max-bot-api-client-php

Max Bot API Client library

281.6k](/packages/bushlanov-dev-max-bot-api-client-php)

PHPackages © 2026

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