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

ActiveLibrary[API Development](/categories/api)

signalads/php
=============

A PHP wrapper for SignalAds's API

1.0.1(3y ago)0191MITPHPPHP >=5.4.0

Since Oct 3Pushed 3y ago1 watchersCompare

[ Source](https://github.com/signalads-co/signalads-php)[ Packagist](https://packagist.org/packages/signalads/php)[ Docs](http://github.com/signalads-co/signalads-php)[ RSS](/packages/signalads-php/feed)WikiDiscussions master Synced today

READMEChangelog (2)DependenciesVersions (3)Used By (1)

signalads-PHP
=============

[](#signalads-php)

[![Latest Stable Version](https://camo.githubusercontent.com/840c52ac5190e96a6b64fb8632efb0551086fac7554618bea522636ac1daa215/68747470733a2f2f706f7365722e707567782e6f72672f7369676e616c6164732d636f2f7068702f762f737461626c652e737667)](https://packagist.org/packages/signalads-co/php)[![Total Downloads](https://camo.githubusercontent.com/04229dd285f72ed22e4bf40c3ad101417bb8d2787282dd41b8005bc9d7b5736e/68747470733a2f2f706f7365722e707567782e6f72672f7369676e616c6164732d636f2f7068702f646f776e6c6f6164732e737667)](https://packagist.org/packages/signalads-co/php)

[SignalAds RESTful API Document](https://document.signalads.com)
================================================================

[](#signalads-restful-api-document)

If you need to future information about API document Please visit RESTful Document

Installation
------------

[](#installation)

After that you just need to pick API-KEY up from [My Account](https://panel.signalads.com/Client/setting/index) section.

---

Use in these ways :

```
composer require signalads-co/php
```

or add

```
"signalads/php": "*"
```

And run following command to download extension using **composer**

```
$ composer update
```

Usage
-----

[](#usage)

- Required Autoload

```
require __DIR__ . '/vendor/autoload.php';
```

- Exception Handler

```
try{
	// call SignalAdsApi function
}
catch(\SignalAds\Exceptions\ApiException $e){
	// در صورتی که خروجی وب سرویس 200 نباشد این خطا رخ می دهد
	echo $e->errorMessage();
}
catch(\SignalAds\Exceptions\HttpException $e){
	// در زمانی که مشکلی در برقرای ارتباط با وب سرویس وجود داشته باشد این خطا رخ می دهد
	echo $e->errorMessage();
}
```

- Send Single SMS

```
$api = new \SignalAds\SignalAdsApi( "API Key" );
$sender = "10004346";
$message = "خدمات پیام کوتاه سیگنال";
$receptor = "09123456789";
$api->Send($sender,$receptor,$message);
```

`Sample Output`

```
{
  "data": {
    "message_id": "28561b88-8403-45b8-a114-508abdb9c436",
    "price": 120
  },
  "message": "پیام شما با موفقیت در صف ارسال قرار گرفت",
  "error": {
    "message": null,
    "errors": null
  }
}
```

- Send Multiple SMS With Same Text

```
$api = new \SignalAds\SignalAdsApi( "API Key" );
$sender = "10004346";
$message = "خدمات پیام کوتاه سیگنال";
$receptors = array("09123456789","09367891011");
$api->SendGroup($sender,$receptors,$message);
```

`Sample Output`

```
{
  "data": {
    "message_id": "55800454-fe52-44b3-9c44-43c87d6f29b2",
    "price": 240
  },
  "message": "پیام شما با موفقیت در صف ارسال قرار گرفت",
  "error": {
    "message": null,
    "errors": null
  }
}
```

- Send Sms With Pattern

```
$api = new \SignalAds\SignalAdsApi( "API Key" );
$sender = "10004346";
$pattern_id = "10004346";
$pattern_params = ["param 1", "param 2"];
$receptors = array("09123456789","09367891011");
$api->SendPattern($sender,$pattern_id,$pattern_params,$receptors);
```

`Sample Output`

```
{
  "data": {
    "message_id": "28561b88-8403-45b8-a114-508abdb9c436"
  },
  "message": "پیام شما با موفقیت در صف ارسال قرار گرفت",
  "error": {
    "message": null,
    "errors": null
  }
}
```

- Get Message Status

```
$api = new \SignalAds\SignalAdsApi( "API Key" );
$messageid=123;
$api->Status($messageid);
```

- Get Message Status With Filter

```
$api = new \SignalAds\SignalAdsApi( "API Key" );
$messageid=123;
$limit=10;
$offset=0;
$status=1;
$receptor="09xxxxxxxxx";
$api->Status($messageid, $limit, $offset, $status, $receptor);
```

`Statuses`

```
PENDING = 1
SENDING = 2
BLACKLIST = 3
DELIVERED = 4
NOT_DELIVERED = 5
NOT_SENDING = 6
ERROR = 7
```

`Sample Output`

```
{
  "data": {
    "items": [
      {
        "number": "09xxxxxxxxx",
        "status": 1
      },
      {
        "number": "09xxxxxxxxx",
        "status": 2
      },
      {
        "number": "09xxxxxxxxx",
        "status": 3
      },
      {
        "number": "09xxxxxxxxx",
        "status": 4
      },
      {
        "number": "09xxxxxxxxx",
        "status": 5
      },
      {
        "number": "09xxxxxxxxx",
        "status": 6
      },
      {
        "number": "09xxxxxxxxx",
        "status": 7
      }
    ],
    "count": 7,
    "sum": 0
  },
  "message": null,
  "error": {
    "message": null,
    "errors": null
  }
}
```

- Get account credit

```
$api = new \SignalAds\SignalAdsApi( "API Key" );
$api->GetCredit();
```

`Sample Output`

```
{
  "data": {
    "credit": 12345
  },
  "message": null,
  "error": {
    "message": null,
    "errors": null
  }
}
```

- Get Package Price

```
$api = new \SignalAds\SignalAdsApi( "API Key" );
$api->GetPackagePrice();
```

`Sample Output`

```
{
  "data": {
    "id": 415,
    "gift_charge": "123",
    "price": "123",
    "name": "testsdf",
    "package_prices": [
      {
        "id": 156,
        "english_price": "210",
        "persian_price": "180",
        "operator": {
          "id": 1,
          "title": "همراه اول"
        }
      }
    ]
  },
  "message": null,
  "error": {
    "message": null,
    "errors": null
  }
}
```

###  Health Score

21

—

LowBetter than 18% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community9

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

Every ~117 days

Total

2

Last Release

1252d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/41980998?v=4)[signalads](/maintainers/signalads)[@SignalADS](https://github.com/SignalADS)

---

Top Contributors

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

---

Tags

apismssignalads

### Embed Badge

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

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

###  Alternatives

[smsfactor/smsfactor-php-sdk

SMSFactor client library for PHP

15407.6k2](/packages/smsfactor-smsfactor-php-sdk)[melipayamak/laravel

Laravel Melipayamak Integration

2530.2k1](/packages/melipayamak-laravel)

PHPackages © 2026

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