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

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

asanak/laravel-sms-client
=========================

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

1.0.0(1y ago)010MITPHPPHP ^8.0 || ^8.1 || ^8.2

Since Jun 29Pushed 1y agoCompare

[ Source](https://github.com/Asanak-Team/laravel-sms-client)[ Packagist](https://packagist.org/packages/asanak/laravel-sms-client)[ Docs](https://github.com/Asanak-Team/laravel-sms-client)[ RSS](/packages/asanak-laravel-sms-client/feed)WikiDiscussions main Synced today

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

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

[](#-laravel-sms-client)

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

---

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

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

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

```
composer require asanak/laravel-sms-client
```

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

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

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

```
ASANAK_SMS_USERNAME=your-username
ASANAK_SMS_PASSWORD=your-password
ASANAK_SMS_BASE_URL=https://sms.asanak.ir
ASANAK_SMS_LOG=true
```

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

---

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

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

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

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

```
use Asanak\Sms\Facade\AsanakSmsFacade as AsanakSms;

public function send()
{
    try {
        $data = AsanakSms::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 Asanak\Sms\Facade\AsanakSmsFacade as AsanakSms;

try {
    $data = AsanakSms::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 Asanak\Sms\Facade\AsanakSmsFacade as AsanakSms;

try {
    $data = AsanakSms::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 Asanak\Sms\Facade\AsanakSmsFacade as AsanakSms;

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

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

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

```
use Asanak\Sms\Facade\AsanakSmsFacade as AsanakSms;

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

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

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

```
use Asanak\Sms\Facade\AsanakSmsFacade as AsanakSms;

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

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

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

```
use Asanak\Sms\Facade\AsanakSmsFacade as AsanakSms;

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

---

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

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

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

---

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

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

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

---

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

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

📞 تماس: [۰۲١۶۴۰۶۳۱۸۰](https://asanak.com/call_to_asanak)📨 ایمیل:

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance49

Moderate activity, may be stable

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity49

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

369d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/37311674185ae67dc0345f044fe572a30f1d9194476af991bdc449512ea7d65a?d=identicon)[Asanak-Paykasa](/maintainers/Asanak-Paykasa)

---

Top Contributors

[![FarzadForuozanfar](https://avatars.githubusercontent.com/u/91725214?v=4)](https://github.com/FarzadForuozanfar "FarzadForuozanfar (1 commits)")

---

Tags

apiasanakasanak-apilaravelsmssms-apiapilaravelsmsasanak

### Embed Badge

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

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

###  Alternatives

[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k15](/packages/tempest-framework)[avalara/avataxclient

Client library for Avalara's AvaTax suite of business tax calculation and processing services. Uses the REST v2 API.

528.5M7](/packages/avalara-avataxclient)[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)[smodav/mpesa

M-Pesa API implementation

16467.9k1](/packages/smodav-mpesa)[bushlanov-dev/max-bot-api-client-php

Max Bot API Client library

486.3k](/packages/bushlanov-dev-max-bot-api-client-php)[jasara/php-amzn-selling-partner-api

A fluent interface for Amazon's Selling Partner API in PHP

1348.7k1](/packages/jasara-php-amzn-selling-partner-api)

PHPackages © 2026

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