PHPackages                             ipe/smsir-php - 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. ipe/smsir-php

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

ipe/smsir-php
=============

A package for sending SMS.

v1.0.1(1y ago)1113.3k↓30.3%21MITPHPPHP ^7.3|^8.0

Since Oct 14Pushed 1y ago1 watchersCompare

[ Source](https://github.com/IPeCompany/smsir-php)[ Packagist](https://packagist.org/packages/ipe/smsir-php)[ RSS](/packages/ipe-smsir-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (1)Versions (6)Used By (1)

پکیج PHP پنل پیامکی [SMS.IR](https://www.sms.ir)
================================================

[](#پکیج-php-پنل-پیامکی-smsir)

پکیج پنل پیامکی [SMS.ir](https://www.sms.ir)، ابزاری کارآمد است که به شما این امکان را می‌دهد تا به سادگی از سرویس ارسال پیامک [SMS.ir](https://www.sms.ir) در پروژه‌های PHP و Laravel خود بهره‌برداری کنید. با استفاده از این پکیج، می‌توانید پیامک‌های تکی، گروهی و زمان‌بندی‌شده را به راحتی ارسال و مدیریت کنید. این ابزار طراحی شده تا فرآیند ارسال پیامک را برای شما آسان و سریع کند.

ویژگی‌ها
--------

[](#ویژگی‌ها)

- ارسال پیامک‌های تکی و گروهی
- ارسال پیامک‌های نظیر به نظیر
- ارسال پیامک‌های تایید (VERIFY)
- امکان زمان‌بندی ارسال پیامک
- گزارش‌گیری از وضعیت پیامک‌های ارسال شده
- مشاهده پیامک‌های دریافت شده
- دریافت اعتبار فعلی و مدیریت خطوط

نصب
---

[](#نصب)

برای نصب این پکیج می‌توانید از Composer استفاده کنید:

```
composer require ipe/smsir-php
```

پس از نصب موفقیت‌آمیز پکیج، شما می‌توانید از آن در پروژه‌های PHP خود استفاده کنید.

تنظیمات
-------

[](#تنظیمات)

برای دریافت کلید وب سرویس، وارد پنل کاربری [SMS.ir](https://www.sms.ir) خود شوید و از بخش "برنامه‌نویسان" اقدام به ایجاد کلید کنید. سپس از همان کلید در تنظیمات پکیج استفاده نمایید.

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

```
SMSIR_API_KEY= your_api_key_here
```

استفاده از متدها
----------------

[](#استفاده-از-متدها)

### 1. دریافت اعتبار فعلی

[](#1-دریافت-اعتبار-فعلی)

این متد به شما این امکان را می‌دهد تا مقدار اعتبار فعلی خود را از پنل پیامکی دریافت کنید.

```
use Ipe\Sdk\Facades\SmsIr;

$response = SmsIr::getCredit();
```

### 2. دریافت لیست خطوط پیامکی

[](#2-دریافت-لیست-خطوط-پیامکی)

این متد به شما امکان می‌دهد تا لیست خطوط پیامکی فعال خود را از پنل پیامکی دریافت کنید.

```
use Ipe\Sdk\Facades\SmsIr;

$response = SmsIr::getLines();
```

### 3. دریافت آخرین پیام‌های دریافتی

[](#3-دریافت-آخرین-پیام‌های-دریافتی)

این متد به شما امکان می‌دهد تا آخرین پیام‌های دریافتی را از پنل پیامکی بازیابی کنید.

```
use Ipe\Sdk\Facades\SmsIr;

// دریافت 100 پیام آخر (مقدار پیش‌فرض)
$response = SmsIr::getLatestReceives();

// یا دریافت تعداد مشخصی از آخرین پیام‌ها (مثلاً 50 پیام)
// $response = SmsIr::getLatestReceives(50);
```

### 4. دریافت پیام‌های دریافتی امروز

[](#4-دریافت-پیام‌های-دریافتی-امروز)

این متد به شما امکان می‌دهد تا پیام‌های دریافتی امروز را از پنل پیامکی با قابلیت صفحه‌بندی و مرتب‌سازی بازیابی کنید.

```
use Ipe\Sdk\Facades\SmsIr;

// دریافت پیام‌های دریافتی امروز با تنظیمات پیش‌فرض
$response = SmsIr::getLiveReceives();

// یا با تنظیمات سفارشی
// $response = SmsIr::getLiveReceives(2, 50, true);
```

### 5. دریافت پیام‌های دریافتی آرشیو شده

[](#5-دریافت-پیام‌های-دریافتی-آرشیو-شده)

این متد به شما امکان می‌دهد تا پیام‌های دریافتی آرشیو شده را بر اساس بازه زمانی مشخص از پنل پیامکی بازیابی کنید.

```
use Ipe\Sdk\Facades\SmsIr;

// دریافت پیام‌های آرشیو شده با تنظیمات پیش‌فرض
$response = SmsIr::getArchivedReceives();

// یا با تنظیمات سفارشی
$pageNumber = 1;
$pageSize = 50;
$fromDate = 1672531200; // 2023-01-01 00:00:00 UTC
$toDate = 1704067199;   // 2023-12-31 23:59:59 UTC
$response = SmsIr::getArchivedReceives($pageNumber, $pageSize, $fromDate, $toDate);
```

### 6. ارسال پیامک‌های گروهی

[](#6-ارسال-پیامک‌های-گروهی)

این متد به شما این امکان را می‌دهد تا پیامک‌های گروهی را به چندین شماره موبایل ارسال کنید.

```
use Ipe\Sdk\Facades\SmsIr;

$lineNumber = "1234567890"; // شماره خط فرستنده
$messageText = "این یک پیام آزمایشی است.";
$mobiles = ["09123456789", "09198765432"]; // لیست شماره‌های گیرنده
$sendDateTime = null;   // برای ارسال آنی، مقدار را نال قرار دهید

$response = SmsIr::bulkSend($lineNumber, $messageText, $mobiles, $sendDateTime);
```

### 7. ارسال پیامک‌های نظیر به نظیر

[](#7-ارسال-پیامک‌های-نظیر-به-نظیر)

این متد به شما این امکان را می‌دهد تا پیامک‌هایی ارسال کنید که در آن هر شماره موبایل پیام منحصر به فرد خود را دریافت می‌کند.

```
use Ipe\Sdk\Facades\SmsIr;

$lineNumber = "1234567890"; // شماره خط فرستنده
$messageTexts = [
    "پیام 1 برای شماره 1",
    "پیام 2 برای شماره 2"
];
$mobiles = ["09123456789", "09198765432"]; // لیست شماره‌های گیرنده
$sendDateTime = null;   // برای ارسال آنی، مقدار را نال قرار دهید

$response = SmsIr::likeToLikeSend($lineNumber, $messageTexts, $mobiles, $sendDateTime);
```

### 8. ارسال پیامک با استفاده از الگو

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

این متد به شما این امکان را می‌دهد تا پیامک‌های تأییدیه (مانند کدهای OTP) را به شماره موبایل ارسال کنید، با استفاده از یک الگوی از پیش تعریف شده. الگو شامل پارامترهای دینامیکی است که با مقادیر ارائه‌شده جایگزین می‌شوند.

```
use Ipe\Sdk\Facades\SmsIr;

$mobile = "09120000000"; // شماره موبایل گیرنده
$templateId = 100000; // شناسه الگو
$parameters = [
    [
        "name" => "Code",
        "value" => "12345"
    ]
];

$response = SmsIr::verifySend($mobile, $templateId, $parameters);
```

### 9. حذف یک پیام زمان‌بندی‌شده

[](#9-حذف-یک-پیام-زمان‌بندی‌شده)

این متد برای حذف یک پیام زمان‌بندی‌شده که هنوز ارسال نشده است، استفاده می‌شود. پیام زمان‌بندی‌شده با استفاده از شناسه بسته (pack ID) شناسایی می‌شود.

```
use Ipe\Sdk\Facades\SmsIr;

$packId = "your_pack_id"; // شناسه بسته پیام زمان‌بندی‌شده

$response = SmsIr::removeScheduledMessages($packId);
```

### 10. دریافت گزارش یک پیام ارسال شده بر اساس شناسه پیام

[](#10-دریافت-گزارش-یک-پیام-ارسال-شده-بر-اساس-شناسه-پیام)

این متد برای دریافت گزارش تحویل یک پیام خاص که قبلاً ارسال شده است، استفاده می‌شود. پیام با استفاده از شناسه پیام (message ID) شناسایی می‌شود.

```
use Ipe\Sdk\Facades\SmsIr;

$messageId = "your_message_id"; // شناسه پیام ارسال‌شده

$response = SmsIr::getReportByMessageId($messageId);
```

### 11. دریافت گزارش پیام‌های ارسال‌شده بر اساس شناسه بسته

[](#11-دریافت-گزارش-پیام‌های-ارسال‌شده-بر-اساس-شناسه-بسته)

این متد برای دریافت گزارش تحویل پیام‌هایی که به صورت دسته‌ای ارسال شده‌اند، استفاده می‌شود. بسته پیام‌ها با استفاده از شناسه بسته (pack ID) شناسایی می‌شود.

```
use Ipe\Sdk\Facades\SmsIr;

$packId = "your_pack_id"; // شناسه بسته پیام

$response = SmsIr::getReportByPackId($packId);
```

### 12. دریافت گزارش زنده پیام‌های ارسال‌شده در روز جاری

[](#12-دریافت-گزارش-زنده-پیام‌های-ارسال‌شده-در-روز-جاری)

این متد برای دریافت گزارش‌های زنده از پیام‌هایی که به تازگی ارسال شده‌اند، استفاده می‌شود. این متد قابلیت پشتیبانی از صفحه‌بندی را دارد و می‌تواند گزارش‌ها را بر اساس جدیدترین یا قدیمی‌ترین مرتب‌سازی کند.

```
use Ipe\Sdk\Facades\SmsIr;

$pageNumber = 1; // شماره صفحه
$pageSize = 100; // تعداد گزارش‌ها در هر صفحه
$sortByNewest = true; // مرتب‌سازی بر اساس جدیدترین

$response = SmsIr::getLiveReport($pageNumber, $pageSize, $sortByNewest);
```

### 13. دریافت گزارش‌های آرشیو شده پیام‌های ارسال‌شده

[](#13-دریافت-گزارش‌های-آرشیو-شده-پیام‌های-ارسال‌شده)

این متد برای دریافت گزارش‌های آرشیو شده پیام‌هایی که در گذشته ارسال شده‌اند، استفاده می‌شود. این متد قابلیت پشتیبانی از صفحه‌بندی، فیلتر بر اساس بازه زمانی و مرتب‌سازی به ترتیب جدیدترین یا قدیمی‌ترین را دارد.

```
use Ipe\Sdk\Facades\SmsIr;

$pageNumber = 1; // شماره صفحه
$pageSize = 100; // تعداد گزارش‌ها در هر صفحه
$fromDate = 1609459200; // تاریخ شروع
$toDate = 1612137600; // تاریخ پایان
$sortByNewest = true; // مرتب‌سازی بر اساس جدیدترین

$response = SmsIr::getArchivedReport($pageNumber, $pageSize, $fromDate, $toDate, $sortByNewest);
```

### 14. دریافت لیست پک‌های پیام‌های ارسال‌شده

[](#14-دریافت-لیست-پک‌های-پیام‌های-ارسال‌شده)

این متد برای دریافت لیستی از پک‌های پیام‌هایی که ارسال شده‌اند، استفاده می‌شود. هر پک ممکن است شامل چندین پیام باشد و این متد قابلیت پشتیبانی از صفحه‌بندی را دارد.

```
use Ipe\Sdk\Facades\SmsIr;

$pageNumber = 1; // شماره صفحه
$pageSize = 100; // تعداد پک‌ها در هر صفحه

$response = SmsIr::getSendPacks($pageNumber, $pageSize);
```

---

با استفاده از پکیج پنل پیامکی [SMS.ir](https://www.sms.ir)، شما می‌توانید به راحتی و با کمترین تلاش، پیامک‌های مختلف را به صورت آنی یا زمان‌بندی شده ارسال کنید. این پکیج با ارائه متدهای متعدد برای ارسال پیامک‌های تکی، گروهی و نظیر به نظیر، به شما این امکان را می‌دهد که ارتباطات خود را بهبود بخشید و پیام‌های خود را به مخاطبان هدف برسانید. همچنین، از طریق متدهای گزارش‌گیری، می‌توانید وضعیت پیامک‌های ارسال‌شده را پیگیری کنید و با استفاده از متدهای مربوط به اعتبار و خطوط، مدیریت بهتری بر روی حساب کاربری خود داشته باشید.

اگر سوالی دارید یا به راهنمایی بیشتری نیاز دارید، لطفاً به مستندات رسمی وب‌سرویس سامانه پیامکی [SMS.ir](https://www.sms.ir) مراجعه کنید یا با تیم پشتیبانی ما در تماس باشید.

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance37

Infrequent updates — may be unmaintained

Popularity33

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 85.7% 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 ~1 days

Total

5

Last Release

577d ago

Major Versions

v0.0.3 → v1.0.02024-10-15

### Community

Maintainers

![](https://www.gravatar.com/avatar/6b0cd8e8081a318eed6507ccd5642760cf7f1c9c89fb96954e046469947b841b?d=identicon)[idehpardazan](/maintainers/idehpardazan)

---

Top Contributors

[![amiralibarasoud](https://avatars.githubusercontent.com/u/107747112?v=4)](https://github.com/amiralibarasoud "amiralibarasoud (12 commits)")[![ErfanBahramali](https://avatars.githubusercontent.com/u/77061285?v=4)](https://github.com/ErfanBahramali "ErfanBahramali (1 commits)")[![IPeCompany](https://avatars.githubusercontent.com/u/43531439?v=4)](https://github.com/IPeCompany "IPeCompany (1 commits)")

### Embed Badge

![Health badge](/badges/ipe-smsir-php/health.svg)

```
[![Health](https://phpackages.com/badges/ipe-smsir-php/health.svg)](https://phpackages.com/packages/ipe-smsir-php)
```

###  Alternatives

[shlinkio/shlink

A self-hosted and PHP-based URL shortener application with CLI and REST interfaces

4.8k4.3k](/packages/shlinkio-shlink)[ralphjsmit/laravel-helpers

A package containing handy helpers for your Laravel-application.

13704.6k2](/packages/ralphjsmit-laravel-helpers)[dhlparcel/magento2-plugin

DHL Parcel plugin for Magento 2

11180.5k2](/packages/dhlparcel-magento2-plugin)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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