PHPackages benmorel/gsm-charset-converter - 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. benmorel/gsm-charset-converter ActiveLibrary[Utility & Helpers](/categories/utility) benmorel/gsm-charset-converter ============================== Converts GSM 03.38 strings to and from UTF-8 0.3.1(2y ago)16423.5k↓16.7%9[1 PRs](https://github.com/BenMorel/GsmCharsetConverter/pulls)MITPHPPHP ^7.4 || ^8.0 Since Nov 23Pushed 1y ago2 watchersCompare [ Source](https://github.com/BenMorel/GsmCharsetConverter)[ Packagist](https://packagist.org/packages/benmorel/gsm-charset-converter)[ GitHub Sponsors](https://github.com/BenMorel)[ RSS](/packages/benmorel-gsm-charset-converter/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (9)Dependencies (3)Versions (10)Used By (0) GSM Charset Converter ===================== [](#gsm-charset-converter) A PHP library to convert GSM 03.38, the charset used for SMS messaging, to and from UTF-8. [![Build Status](https://github.com/BenMorel/GsmCharsetConverter/workflows/CI/badge.svg)](https://github.com/BenMorel/GsmCharsetConverter/actions)[![Coverage Status](https://camo.githubusercontent.com/c148643f54469dc39117079a8ed3c776e7e3d7837cedce4bfdfaea3a15344487/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f42656e4d6f72656c2f47736d43686172736574436f6e7665727465722f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/BenMorel/GsmCharsetConverter?branch=master)[![Latest Stable Version](https://camo.githubusercontent.com/cd9135333a13fb4c40ceb226f527ecff79f8e33b03eb637e398b298ff5c08dc2/68747470733a2f2f706f7365722e707567782e6f72672f62656e6d6f72656c2f67736d2d636861727365742d636f6e7665727465722f762f737461626c65)](https://packagist.org/packages/benmorel/gsm-charset-converter)[![Total Downloads](https://camo.githubusercontent.com/3a29099b54925baadcebe69ec9db9848c08ab33a1e962ee30955527acb88b615/68747470733a2f2f706f7365722e707567782e6f72672f62656e6d6f72656c2f67736d2d636861727365742d636f6e7665727465722f646f776e6c6f616473)](https://packagist.org/packages/benmorel/gsm-charset-converter)[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](http://opensource.org/licenses/MIT) This library is well tested. The character maps used have been cross-checked against multiple sources, and when in doubt, a test has been performed on a real SMS gateway. The library offers optional transliteration: unsupported characters can be replaced with a close variant. For example, the `ë` character can be replaced with `e`. Known limitations: - Only the default alphabet and extension table are supported at the moment; this is the alphabet that must be supported by every device and network element according to the standard. [Other alphabets exist](https://en.wikipedia.org/wiki/GSM_03.38#National_language_shift_tables) but this project does not currently aim to support them. - Transliteration may not be available for all characters that could have a close equivalent in the GSM charset; this library supports transliteration of LATIN1 chars and several other languages. If you feel like another UTF-8 character could be transliterated, please [open an issue](https://github.com/BenMorel/GsmCharsetConverter/issues)! Installation ------------ [](#installation) This library is installable via [Composer](https://getcomposer.org/): ``` composer require benmorel/gsm-charset-converter ``` Requirements ------------ [](#requirements) This library requires PHP >= 7.4, and the `mbstring` extension. Project status & release process ------------------------------------ [](#project-status--release-process) This library is under development. The current releases are numbered `0.x.y`. When a non-breaking change is introduced (adding new methods, optimizing existing code, etc.), `y` is incremented. **When a breaking change is introduced, a new `0.x` version cycle is always started.** It is therefore safe to lock your project to a given release cycle, such as `0.3.*`. If you need to upgrade to a newer release cycle, check the [release history](https://github.com/BenMorel/GsmCharsetConverter/releases)for a list of changes introduced by each further `0.x.0` version. Usage ----- [](#usage) ### Converting GSM 03.38 strings to UTF-8 [](#converting-gsm-0338-strings-to-utf-8) The `convertGsmToUtf8()` method takes one parameter: ``` use BenMorel\GsmCharsetConverter\Converter; $converter = new Converter(); $utf8 = $converter->convertGsmToUtf8('...'); ``` The input string must be a valid GSM 03.38 string, or an `InvalidArgumentException` is thrown. **The input string is expected to be unpacked**: 7-bit chars in 8-bit bytes with a leading zero bit, just like ASCII chars. ### Converting UTF-8 strings to GSM 03.38 [](#converting-utf-8-strings-to-gsm-0338) The `convertUtf8ToGsm()` method accepts 3 parameters: - a valid UTF-8 input string; - whether or not to attempt to transliterate incompatible chars; - an optional string to replace unknown characters with. If the input string is not valid UTF-8, an `InvalidArgumentException` is thrown. The output is an unpacked GSM 03.38 string. #### Without transliteration [](#without-transliteration) ``` $gsm = $converter->convertUtf8ToGsm('Helló', false, '?'); // Hell? ``` If the third parameter is not provided, and the string contains characters incompatible with GSM 03.38, an `InvalidArgumentException` is thrown. #### With transliteration [](#with-transliteration) ``` $gsm = $converter->convertUtf8ToGsm('Helló', true, '?'); // Hello ``` If the third parameter is not provided, and the string contains characters incompatible with GSM 03.38 and not transliterable, an `InvalidArgumentException` is thrown. ### Cleaning up UTF-8 strings to ensure that a message is sent in the GSM charset [](#cleaning-up-utf-8-strings-to-ensure-that-a-message-is-sent-in-the-gsm-charset) Nowadays, most online SMS gateways accept UTF-8 as input; however, some of them do not provide a way to force a message to be sent in the GSM charset. As a result, you may end up with extra charges caused by your SMS being sent in Unicode (UCS-2) format, causing the segmentation of messages in multiple parts, just because your SMS message contains an unforeseen accented character or emoji. The library provides a method, `cleanUpUtf8String()`, that prevents these bad surprises, by returning a UTF-8 string that contains only characters that can be safely converted to the GSM charset. This method accepts the same parameters as `convertUtf8ToGsm()`: ``` $utf8 = $converter->cleanUpUtf8String('Helló', false, '?'); // Hell? $utf8 = $converter->cleanUpUtf8String('Helló', true, '?'); // Hello ``` ### Packing 7-bit strings into 8-bit binary strings [](#packing-7-bit-strings-into-8-bit-binary-strings) To fit 160 7-bit characters into a 140 bytes SMS, the characters have to be packed into a binary, 8-bit string. The `Packer` class provides functionality to pack and unpack strings in this format: ``` use BenMorel\GsmCharsetConverter\Packer; $packer = new Packer(); $packed = $packer->pack('ABC'); // the binary string 41E110 $string = $packer->unpack("\x41\xE1\x10"); // ABC ``` Note that `pack()` throws an `InvalidArgumentException` if the input string contains 8-bit chars (i.e. chars with the leading bit set). ### Health Score 42 — FairBetter than 90% of packages Maintenance29 Infrequent updates — may be unmaintained Popularity46 Moderate usage in the ecosystem Community17 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor1 Top contributor holds 91.4% 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 ~246 days Recently: every ~225 days Total 9 Last Release 762d ago PHP version history (3 changes)0.1.0PHP >=7.1 0.2.0PHP ^7.2 || ^8.0 0.3.0PHP ^7.4 || ^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/57189121968030f0770811b461cc92f9c19c08f5c4767292f2ede48b7277cfad?d=identicon)[BenMorel](/maintainers/BenMorel) --- Top Contributors [![BenMorel](https://avatars.githubusercontent.com/u/1952838?v=4)](https://github.com/BenMorel "BenMorel (53 commits)")[![nrbrttth](https://avatars.githubusercontent.com/u/23727847?v=4)](https://github.com/nrbrttth "nrbrttth (2 commits)")[![black-viking](https://avatars.githubusercontent.com/u/5479576?v=4)](https://github.com/black-viking "black-viking (1 commits)")[![crebier-corentin](https://avatars.githubusercontent.com/u/17709887?v=4)](https://github.com/crebier-corentin "crebier-corentin (1 commits)")[![neovmt](https://avatars.githubusercontent.com/u/2440601?v=4)](https://github.com/neovmt "neovmt (1 commits)") --- Tags smsgsmGSM 03.38 ### Code Quality TestsPHPUnit Static AnalysisPsalm Type Coverage Yes ### Embed Badge ![Health badge](/badges/benmorel-gsm-charset-converter/health.svg) ``` [![Health](https://phpackages.com/badges/benmorel-gsm-charset-converter/health.svg)](https://phpackages.com/packages/benmorel-gsm-charset-converter) ``` ### Alternatives [php-smpp/php-smpp PHP-based SMPP client lib 234197.5k8](/packages/php-smpp-php-smpp)[instasent/sms-counter-php SMS Counter PHP Class Library which detects encoding of an SMS message text, counts the characters as per the encoding and gives page limit information. 491.3M4](/packages/instasent-sms-counter-php)[alexandr-mironov/php-smpp PHP SMPP client lib, fork of onlinecity/php-smpp 4864.3k](/packages/alexandr-mironov-php-smpp)[php8-smpp/php8-smpp PHP8 SMPP client lib, based on fork of alexandr-mironov/php-smpp which is fork of onlinecity/php-smpp 128.1k](/packages/php8-smpp-php8-smpp)[matthewbdaly/sms-client A generic SMS client library. Supports multiple swappable drivers. 2291.2k2](/packages/matthewbdaly-sms-client)[midnite81/geolocation A laravel package which wraps the IP Info DB and IP2Location Services 3624.1k](/packages/midnite81-geolocation) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)