https://github.com/instasent/sms-counter-php

SMS Counter and sanitize tools
https://github.com/instasent/sms-counter-php

gsm php sms-counter

Last synced: 2 days ago
JSON representation

SMS Counter and sanitize tools

• Host: GitHub
• URL: https://github.com/instasent/sms-counter-php
• Owner: instasent
• License: mit
• Created: 2015-07-18T03:16:23.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2024-01-10T16:11:33.000Z (10 months ago)
• Last Synced: 2024-11-07T13:06:25.408Z (9 days ago)
• Topics: gsm, php, sms-counter
• Language: PHP
• Size: 53.7 KB
• Stars: 49
• Watchers: 6
• Forks: 28
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-MIT

Awesome Lists containing this project

README

        
# Instasent - SMS Counter for PHP

Character counter for SMS Messages

[![Build Status](https://img.shields.io/travis/instasent/sms-counter-php.svg?style=flat-square)](https://travis-ci.org/instasent/sms-counter-php)

[![SensioLabsInsight](https://img.shields.io/sensiolabs/i/0a2fa87a-0287-46f6-b8b5-818b44a2b9f9.svg?style=flat-square)](https://insight.sensiolabs.com/projects/0a2fa87a-0287-46f6-b8b5-818b44a2b9f9)

## Usage

```php

use Instasent\SMSCounter\SMSCounter;

$smsCounter = new SMSCounter();

$smsCounter->count('some-string-to-be-counted');

$smsCounter->countWithShiftTables('some-string-to-be-counted');

```

which returns

```

stdClass Object

(

[encoding]    => GSM_7BIT

[length]      => 25

[per_message] => 160

[remaining]   => 135

[messages]    => 1

)

```

##### UTF16 notice

When using unicode chars over U+10000 (mainly emoticons 😎) on messages larger than 70 chars the _remaining_ value will actually be the **remaining chars in last message part only**, this is due to how those chars are encoded using two 16bit chars and max part length being an odd number (67)

#### Sanitization

You can sanitize your text to be a valid strict GSM 03.38 charset

```php

use Instasent\SMSCounter\SMSCounter;

$smsCounter = new SMSCounter();

$smsCounter->sanitizeToGSM('dadáó'); //return dadao

```

#### National Language Shift Tables

Starting release 8 of GSM 03.38 some additional charsets are allowed. This is the list of such National Language Shift Tables currently supported

- [Turkish](https://en.wikipedia.org/wiki/GSM_03.38#Turkish_language_(Latin_script))

- [Spanish](https://en.wikipedia.org/wiki/GSM_03.38#Spanish_language_(Latin_script))

- [Portuguese](https://en.wikipedia.org/wiki/GSM_03.38#Portuguese_language_(Latin_script))

## Installation

`sms-counter-php` is available via [composer](http://getcomposer.org) on [packagist](https://packagist.org/packages/instasent/sms-counter-php).

```json

{

    "require": {

       "instasent/sms-counter-php": "^0.4"

    }

}

```

## License

SMS Counter (PHP) is released under the [MIT License](LICENSE-MIT.md)

### Mentions

* Original idea : [danxexe/sms-counter](https://github.com/danxexe/sms-counter)

* Fork Idea from: [acpmasquerade/sms-counter-php](https://github.com/acpmasquerade/sms-counter-php)