PHPackages                             th3mouk/free-mobile-sms-cli - 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. [Mail & Notifications](/categories/mail)
4. /
5. th3mouk/free-mobile-sms-cli

ActiveLibrary[Mail & Notifications](/categories/mail)

th3mouk/free-mobile-sms-cli
===========================

PHP Client using Free Mobile SMS Notification API to send free messages on your mobile phone.

1.1.1(9y ago)16441MITPHPPHP ^5.6 || ^7.0CI failing

Since Jun 18Pushed 9y ago1 watchersCompare

[ Source](https://github.com/Th3Mouk/Free-Mobile-SMS-Notification-Client)[ Packagist](https://packagist.org/packages/th3mouk/free-mobile-sms-cli)[ RSS](/packages/th3mouk-free-mobile-sms-cli/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (3)Versions (4)Used By (0)

Free Mobile SMS Notifications Client
====================================

[](#free-mobile-sms-notifications-client)

This library provides a client to send SMS notifications on your mobile phone, through the \[Free Mobile\](.free.fr/) API.

[![Latest Stable Version](https://camo.githubusercontent.com/f68891980d13074da112f446b0e496a388ee55fa94a391f8f16e9670ae038b17/68747470733a2f2f706f7365722e707567782e6f72672f7468336d6f756b2f667265652d6d6f62696c652d736d732d636c692f762f737461626c65)](https://packagist.org/packages/th3mouk/free-mobile-sms-cli) [![Latest Unstable Version](https://camo.githubusercontent.com/ff0a6200915dad13f74b869df0e8701a6a247a1980687268e848bb7a5d2ee4fb/68747470733a2f2f706f7365722e707567782e6f72672f7468336d6f756b2f667265652d6d6f62696c652d736d732d636c692f762f756e737461626c65)](https://packagist.org/packages/th3mouk/free-mobile-sms-cli) [![Total Downloads](https://camo.githubusercontent.com/05dd48bb63eb3fc6698be32c6db613f50c98f3fd5594fac61e081f43e101e5c4/68747470733a2f2f706f7365722e707567782e6f72672f7468336d6f756b2f667265652d6d6f62696c652d736d732d636c692f646f776e6c6f616473)](https://packagist.org/packages/th3mouk/free-mobile-sms-cli) [![License](https://camo.githubusercontent.com/b7a25a4e658968ff5cd867a51099355c10d2cfc99f11200a315df63e38798aaa/68747470733a2f2f706f7365722e707567782e6f72672f7468336d6f756b2f667265652d6d6f62696c652d736d732d636c692f6c6963656e7365)](https://packagist.org/packages/th3mouk/free-mobile-sms-cli)

[![SensioLabsInsight](https://camo.githubusercontent.com/80a7b1f939fb2d39a8610ae56ec1a318b86852e5bf83f268a0eab205e98ad0d7/68747470733a2f2f696e73696768742e73656e73696f6c6162732e636f6d2f70726f6a656374732f38623932396634342d653037642d346265312d396136322d6362386430623334343563372f6d696e692e706e67)](https://insight.sensiolabs.com/projects/8b929f44-e07d-4be1-9a62-cb8d0b3445c7) [![Build Status](https://camo.githubusercontent.com/6f6d449413058c0d7d351cfd83463d377d260c6208cb35222d8a7699a1f3f6fa/68747470733a2f2f7472617669732d63692e6f72672f5468334d6f756b2f467265652d4d6f62696c652d534d532d4e6f74696669636174696f6e2d436c69656e742e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/Th3Mouk/Free-Mobile-SMS-Notification-Client) [![Scrutinizer Code Quality](https://camo.githubusercontent.com/5649acd1ddb780e8c229406248619e20f4273b8b509d388f6b523a5d7c79cdcc/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f5468334d6f756b2f467265652d4d6f62696c652d534d532d4e6f74696669636174696f6e2d436c69656e742f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/Th3Mouk/Free-Mobile-SMS-Notification-Client/?branch=master) [![Coverage Status](https://camo.githubusercontent.com/288723c2914ec9574cdcb28066689286adb66be97a2d61ccd368847fca7436d8/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f5468334d6f756b2f467265652d4d6f62696c652d534d532d4e6f74696669636174696f6e2d436c69656e742f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/Th3Mouk/Free-Mobile-SMS-Notification-Client?branch=master)

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

[](#installation)

### Composer

[](#composer)

`composer require th3mouk/free-mobile-sms-cli ^1.0`

### Free Mobile

[](#free-mobile)

Go to your [customer area](https://mobile.free.fr/moncompte/).

Click on: Gérer mon compte > Mes Options > Notifications par SMS > Activer l'option

You got now your authentication key.

Usage
-----

[](#usage)

### Client

[](#client)

```
use Th3Mouk\FreeMobileSMSNotif\Client;

$login = 'test';
$pass = 'test';

$freeMobileClient = new Client($login, $pass);
$response = $freeMobileClient->send('Test Message');
```

### Response Codes

[](#response-codes)

```
$response = $freeMobileClient->sendMessage('Test Message');
$code = $response->getStatusCode();
```

- 200: SMS Sent
- 400: Missing parameter
- 402: Too much SMS send in too little time
- 403: Service isn't active on your customer area, or login/pass incorrect
- 500: Error on servor side. Please retry later.

Please
------

[](#please)

Feel free to improve this library.

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity60

Established project with proven stability

 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 ~34 days

Total

3

Last Release

3545d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5f31e3a808a4f015ebad005caa64866fc90e39475151fc95ef1e11f774d35505?d=identicon)[Th3Mouk](/maintainers/Th3Mouk)

---

Top Contributors

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

---

Tags

notificationphonesmsmobileFreeMobileDomotic

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/th3mouk-free-mobile-sms-cli/health.svg)

```
[![Health](https://phpackages.com/badges/th3mouk-free-mobile-sms-cli/health.svg)](https://phpackages.com/packages/th3mouk-free-mobile-sms-cli)
```

###  Alternatives

[laravel-notification-channels/telegram

Telegram Notifications Channel for Laravel

1.1k3.4M35](/packages/laravel-notification-channels-telegram)[laravel-notification-channels/twilio

Provides Twilio notification channel for Laravel

2587.7M12](/packages/laravel-notification-channels-twilio)[laravel-notification-channels/discord

Laravel notification driver for Discord.

2371.3M11](/packages/laravel-notification-channels-discord)[gr8shivam/laravel-sms-api

A modern, flexible Laravel package for integrating any SMS gateway with REST API support

10138.4k](/packages/gr8shivam-laravel-sms-api)[ghanem/laravel-smsmisr

Send SMS and SMS Notification via SMS Misr for Laravel

194.8k](/packages/ghanem-laravel-smsmisr)[hooman-mirghasemi/laravel-iran-sms

Laravel Sms

241.8k](/packages/hooman-mirghasemi-laravel-iran-sms)

PHPackages © 2026

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