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

ActiveLibrary[API Development](/categories/api)

ridvanbaluyos/sms
=================

A PHP Library built for making SMS sending easier.

0(9y ago)445MITPHPPHP >=5.3.3

Since Dec 8Pushed 8y ago1 watchersCompare

[ Source](https://github.com/ridvanbaluyos/sms)[ Packagist](https://packagist.org/packages/ridvanbaluyos/sms)[ RSS](/packages/ridvanbaluyos-sms/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (6)DependenciesVersions (7)Used By (0)

ridvanbaluyos/sms
=================

[](#ridvanbaluyossms)

An SMS Provider Library for PHP

[![Actively Maintained](https://camo.githubusercontent.com/7904a78e053b215ef92caa8957fba8956752edc6d65763230398179b7bcbab5b/68747470733a2f2f6d61696e7461696e65642e746563682f62616467652e737667)](https://maintained.tech/)[![Latest Stable Version](https://camo.githubusercontent.com/1f683ee71241f56fe03355e8fdb9083a2f0e9a725eab30fda432e52e76d11231/68747470733a2f2f706f7365722e707567782e6f72672f72696476616e62616c75796f732f736d732f762f737461626c65)](https://packagist.org/packages/ridvanbaluyos/sms) [![Total Downloads](https://camo.githubusercontent.com/43b06ca2eaa877305ae4bb8fc617a9637d77a69a7ff9a174e579e5cc6f9e0b26/68747470733a2f2f706f7365722e707567782e6f72672f72696476616e62616c75796f732f736d732f646f776e6c6f616473)](https://packagist.org/packages/ridvanbaluyos/sms) [![Scrutinizer Code Quality](https://camo.githubusercontent.com/a0d41acb6eafd9806bb136f01f64a8ab1bd1e0e44e65b5efab1725e637239925/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f72696476616e62616c75796f732f736d732d70726f7669646572732f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/ridvanbaluyos/sms-providers/?branch=master) [![Build Status](https://camo.githubusercontent.com/c1fa7dc419b69d731b319396dba70261805a8ae7faa8d73b09e15a7815ea2ee0/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f72696476616e62616c75796f732f736d732d70726f7669646572732f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/ridvanbaluyos/sms-providers/build-status/master) [![Codacy Badge](https://camo.githubusercontent.com/8efb37d5e2ab729ee66dff6dd9e55ea455664ca2cd4cf4dd1403f8161e6d9e49/68747470733a2f2f6170692e636f646163792e636f6d2f70726f6a6563742f62616467652f47726164652f6566313732626164336565363436613562633236653938616164666661643266)](https://www.codacy.com/app/ridvanbaluyos/sms?utm_source=github.com&utm_medium=referral&utm_content=ridvanbaluyos/sms&utm_campaign=badger) [![License](https://camo.githubusercontent.com/9d014d822f3bd3285d53b33cebed32461d0d2673c9e172112c40ba6386736e56/68747470733a2f2f706f7365722e707567782e6f72672f72696476616e62616c75796f732f736d732f6c6963656e7365)](https://packagist.org/packages/ridvanbaluyos/sms)

- [Installation](#installation)
- [Configuration](#configuration)
- [Usage](#usage)
    - [Sending SMS (with Provider)](#sending-sms-with-provider)
    - [Sending SMS (with No Provider)](#sending-sms-with-no-provider)
    - [Account Balance](#account-balance)
- [Supported SMS Providers](#supported-sms-providers)
- [To Follow](#to-follow)

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

[](#installation)

Open your `composer.json` file and add the following to the `require` key:

```
"ridvanbaluyos/sms": "v0.6-alpha"

```

After adding the key, run composer update from the command line to install the package

```
composer update
```

Or simply add:

```
composer require ridvanbaluyos/sms
```

Make sure you register for an account and load up your balance.

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

[](#configuration)

1. Go to `src/ridvanbaluyos/sms/config` folder.
2. Rename `default.providers.json` to `providers.json`.
3. Fill-up the necessary fields. You need not fill up all providers, only those that you are using.

```
  "Semaphore" : {
    "url" : "http://api.semaphore.co/api/sms",
    "from" : "Justin Bieber",
    "api" : "1$1++0074+3n0w+0$4ychUR1-cHUr1'x"
  },

```

4. In the same folder, open `distributions.json` and fill up the weights. The total value should be 1.0.

```
{
  "PromoTexter" : "0.5",
  "Semaphore" : "",
  "RisingTide" : "0.5",
  "Chikka" : ""
}

```

Usage
-----

[](#usage)

### Sending SMS with Provider

[](#sending-sms-with-provider)

```
use ridvanbaluyos\sms\Sms as Sms;
use ridvanbaluyos\sms\providers\PromoTexter as PromoTexter;

$message = 'this is a test message';
$phoneNumber = '639123456789';

$provider = new PromoTexter();
$sms = new Sms($provider);
$sms->send($phoneNumber, $message);
```

### Sending SMS with No Provider

[](#sending-sms-with-no-provider)

```
use ridvanbaluyos\sms\Sms as Sms;

$message = 'this is a test message';
$phoneNumber = '639123456789';

$sms = new Sms();
$sms->send($phoneNumber, $message);
```

> When no SMS provider is specified, it will be randomized based on the weights that you defined in the `distribution.json` file (eg. 0.25 is 25% chance).

### Account Balance

[](#account-balance)

```
use ridvanbaluyos\sms\Sms as Sms;

$provider = new PromoTexter();
$sms = new Sms($provider);
$sms->balance();
```

Supported SMS Providers
-----------------------

[](#supported-sms-providers)

1. [Semaphore](http://semaphore.co/)
2. [PromoTexter](http://www.promotexter.com/)
3. [RisingTide](http://www.risingtide.ph/)
4. [Chikka](http://api.chikka.com/)
5. [Nexmo](https://www.nexmo.com)
6. [Twilio](https://www.twilio.com)

To Follow
---------

[](#to-follow)

1. More SMS Providers!

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 97.8% 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 ~2 days

Total

6

Last Release

3427d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/793aa0a7d1ec9bd2f9ea22d20b370cff689b6e2a488511af8dde299e66a7136a?d=identicon)[ridvanbaluyos](/maintainers/ridvanbaluyos)

---

Top Contributors

[![ridvanbaluyos](https://avatars.githubusercontent.com/u/156903?v=4)](https://github.com/ridvanbaluyos "ridvanbaluyos (45 commits)")[![codacy-badger](https://avatars.githubusercontent.com/u/23704769?v=4)](https://github.com/codacy-badger "codacy-badger (1 commits)")

---

Tags

chikkanexmophppromotexterrisingtidesemaphoresmssms-providersms-servicetwilioapisms

### Embed Badge

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

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

###  Alternatives

[plivo/plivo-php

A PHP SDK to make voice calls & send SMS using Plivo and to generate Plivo XML

1102.8M18](/packages/plivo-plivo-php)[plivo/php-sdk

A PHP SDK to make voice calls & send SMS using Plivo and to generate Plivo XML

1101.9M5](/packages/plivo-php-sdk)[melipayamak/php

A PHP wrapper for melipayamak's web services

3294.4k5](/packages/melipayamak-php)[smsfactor/smsfactor-php-sdk

SMSFactor client library for PHP

15382.5k2](/packages/smsfactor-smsfactor-php-sdk)

PHPackages © 2026

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