PHPackages                             topface/smsonline - 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. topface/smsonline

ActiveLibrary[API Development](/categories/api)

topface/smsonline
=================

Client for SmsOnline APIs

v1.1.0(10y ago)1321Apache-2.0PHP

Since Jul 16Pushed 10y ago6 watchersCompare

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

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

SmsOnlineClient
===============

[](#smsonlineclient)

[🇬🇧](/README.en.md)

[![License](https://camo.githubusercontent.com/a549a7a30bacba7bfceebdc207a8e86c3f2c02995a2527640dca30048fd2b64e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d417061636865253230322e302d626c75652e737667)](http://www.apache.org/licenses/LICENSE-2.0)[![Build Status](https://camo.githubusercontent.com/54fd8dc011bd8bd8e45d55e98ce3cc428ac136a6f84740c67e41836c532f6f22/68747470733a2f2f7472617669732d63692e6f72672f546f70666163652f536d734f6e6c696e652e7376673f6272616e63683d76312e302e30)](https://travis-ci.org/Topface/SmsOnline)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/76659296b60969e5b325b22889ca1bd24e11bd7f00d229721a2eb76da75dfff3/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f546f70666163652f536d734f6e6c696e652f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/Topface/SmsOnline/?branch=master)[![Code Coverage](https://camo.githubusercontent.com/b292309b7f52c2fcd5122b106a4e9655673f9812b860a2868ab68f8fcc2db040/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f546f70666163652f536d734f6e6c696e652f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/Topface/SmsOnline/?branch=master)

PHP библиотека, реализующая [SMS Bulk API v2.2](http://ru.sms-online.com/doc/smsonline_sms_bulk_v2.2_ru.pdf) компании [SmsOnline](sms-online.com)

Достоинства
-----------

[](#достоинства)

1. Простота. Для отправления смс доступно всего 3 класса: [клиента API](/source/Bulk/Client.php), [сообщение](/source/Bulk/Message.php) и [ответ](/source/Bulk/Response.php)
2. Полная фукнциональность. Вы можете создавать один экзепляр сообщения для нескольких получателей
3. Реализован в виде `composer`-пакета, что позволяет подклчить библиотеку в одну строчку
4. Для быстрой отправки смс можно использовать [утилиту](/bin/send.php) командной строки

Установка
---------

[](#установка)

Для простого использования получите пакет через `composer`

```
    $ composer require topface/smsonline

```

При использовании в стороннем проекте, измените `composer.json` следующим образом

```
    "topface/smsonline": "*"

```

Затем выполните команду `composer update`

Использование
-------------

[](#использование)

Для начала необходимо создать сущность клиента, определив его логин, секретный ключ и наименование отправителя

```
    use TopfaceLibrary\SmsOnline\Bulk\Client;

    $Client = new Client(, , );

```

Затем создайте экземпляр сообщения и просто отправьте его

```
    use TopfaceLibrary\SmsOnline\Bulk\Message;

    $Message = new Message('hello');
    $Message->addPhone(79031234567);
    $Message->addPhone(79165557755);
    $Result = $Client->send($Message);

```

Использование командной строки
------------------------------

[](#использование-командной-строки)

Можно использовать скрипт `send.php` для вызова Sms Bulk API напрямую

```
    $ php bin/send.php -h
    Using: /usr/local/bin/php bin/send.php [-h|--help] -f|--from -p|--phone -s|--secret -t|--text -u|--user
    -h, --help  - show help
    -f, --from  - sender alpha-name
    -p, --phone  - receiver phone or phones (comma-separated)
    -s, --secret  - secret key
    -t, --text  - message text
    -u, --user  - sender login

```

Просто вызовите скрипт, указав требуемые параметры: наименование отправителя, секретный ключ, логин, телефон получателя и текст сообщения

```
    $ php bin/send.php -f='Company' -p='79031234567,79165557755' -s='secRet' -t='hello' -u='userlogin'
        code:    0
        message: OK
        ids:
            79031234567: 45678901-2222-1111-4466-aabbcc556677
            79165557755: 56789012-2222-1111-4466-aabbcc556677

```

Если случится что-нибудь плохое, скрипт вернет код ошибки возврата и ее описание

```
    $ php bin/send.php -f='Company' -p='79031234567,79165557755' -s='wr0NGsecRet' -t='hello' -u='userlogin'
        code:    -2
        message: AUTH ERROR (sign)
        ids:

```

Тестирование
------------

[](#тестирование)

Для запуска тестов воспользуйтесь командой `phpunit`

```
    $ phpunit
    PHPUnit 4.7.5 by Sebastian Bergmann and contributors.

    Runtime:	PHP 5.5.23

    ......

    Time: 111 ms, Memory: 6.00Mb

    OK (6 tests, 47 assertions)

```

Содействие
----------

[](#содействие)

Мы будем рады любой помощи в развитии проекта. Исправления принимаются в виде пул-реквестов. Искренне просим вас добавлять тесты и документировать все присылаемые изменения

Лицензия
--------

[](#лицензия)

Авторское право © 2015 ООО "Топфейс" Лицензировано Apache License, Version 2.0. С полным текстом лицензии можно ознакомиться по ссылке

```
http://www.apache.org/licenses/LICENSE-2.0

```

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 80% 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 ~42 days

Recently: every ~63 days

Total

7

Last Release

3703d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/762010?v=4)[Renat Akhmedyanov](/maintainers/r3nat)[@r3nat](https://github.com/r3nat)

---

Top Contributors

[![alxmsl](https://avatars.githubusercontent.com/u/950057?v=4)](https://github.com/alxmsl "alxmsl (16 commits)")[![realmfoo](https://avatars.githubusercontent.com/u/719682?v=4)](https://github.com/realmfoo "realmfoo (2 commits)")[![edementiev](https://avatars.githubusercontent.com/u/944249?v=4)](https://github.com/edementiev "edementiev (1 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (1 commits)")

---

Tags

apismssmsonlinesms online

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/topface-smsonline/health.svg)

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

###  Alternatives

[smsfactor/smsfactor-php-sdk

SMSFactor client library for PHP

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

Laravel Melipayamak Integration

2528.9k1](/packages/melipayamak-laravel)

PHPackages © 2026

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