labsmobile/sms-php

Send SMS messages through the LabsMobile platform and the PHP library.

1.0.2 2025-03-13 17:55 UTC

Requires

• php: >=5.4.0, <=8.3.19
• ext-json: *
• guzzlehttp/guzzle: ^5.0 || ^6.0 || ^7.0 || ^7.2

Requires (Dev)

• phpunit/phpunit: ^4.8 || ^5.7 || ^6.0 || ^7.0 || ^8.0

MIT

• LabsMobile

• php
• composer
• sms
• smsapi
• httpclient
• labsmobile
• sms-api
• sms-client
• sms-notifications
• sms-messages
• sms-php

README

LabsMobile-PHP

Send SMS messages through the LabsMobile platform and the PHP library.

Documentation

• Labsmobile API documentation can be found here.

Features

• Send SMS messages.
• Get account credits
• Get prices by country
• Manage scheduled sendings
• HLR Request (Check mobile)

Requirements

• A user account with LabsMobile. Click on the link to create an account here.
• This library supports php v5.4 and higher versions of php.
• From php v5.4 to php v7.1 it is recommended to use Composer 2.2.22.

Installation

To install the labsmobile/sms-php library, it is recommended to use composer.

Installation command

composer require labsmobile/sms-php

Installation by modifying the composer.json file

"require": {
	"labsmobile/sms-php": "1.0.2"
}

Examples of use cases

Send SMS

Here is an example of using the library to send a SMS:

  public $username = 'myusername';
  public $token = 'mytoken';

  public function testSms()
  { 
    try {
      $message = 'Test SMS';
      $phone = ['34XXXXXXXXX'];
      $labsMobileClient = new LabsMobileClient($this->username, $this->token);
      $bodySms = new LabsMobileModelTextMessage($phone,$message);
      $labsMobileClient = $labsMobileClient->sendSms($bodySms);
      $body = $labsMobileClient->getBody();
      $json = json_decode($body);
      self::assertSame('0',$json->code);
    } catch (RestException $exception) {
      self::assertSame('Error', $exception->getStatus() ." ". $exception->getMessage());
    }
  }

Get account credits

Here is an example to learn credits for an existing account:

  public $username = 'myusername';
  public $token = 'mytoken';

  public function testGetCredits()
  {
    try{
      $labsMobileClient = new LabsMobileClient($this->username, $this->token);
      $response = $labsMobileClient->getCredit();
      $body = $response->getBody();
      $json = json_decode($body);
      self::assertSame(0,$json->code);
    } catch(RestException $exception) {
      self::assertSame('Error', $exception->getStatus() ." ". $exception->getMessage());
    }
  }

Manage scheduled sendings

Here is an example you can cancel or execute the scheduled sendings that are pending for execution:

  public $username = 'myusername';
  public $token = 'mytoken';

  public function testScheduledSendings() 
  {
    try {
      $subid="XXXXXXXXXX";
      $cmd="XXXX";
      $labsMobileClient = new LabsMobileClient($this->username, $this->token);
      $bodyScheduled = new LabsMobileModelScheduledSendings($subid, $cmd);
      $labsMobileClient = $labsMobileClient->scheduledSendings($bodyScheduled);
      $body = $labsMobileClient->getBody();
      $json = json_decode($body);
      self::assertSame(0,$json->code);
    } catch (RestException $exception) {
      self::assertSame('Error', $exception->getStatus() ." ". $exception->getMessage());
    }
  }

Get prices by country

Here is an example to know the credits that a single sending will take depending on the country of delivery:

  public $username = 'myusername';
  public $token = 'mytoken';

  public function testCountryPrice()
  {
    try {
      $countries = ["CO","ES"];
      $labsMobileClient = new LabsMobileClient($this->username, $this->token);
      $bodyContries = new LabsMobileModelCountryPrice($countries);
      $labsMobileClient = $labsMobileClient->getpricesCountry($bodyContries);
      $body = $labsMobileClient->getBody();
      self::assertTrue(true, $body);
    } catch (RestException $exception) {
      self::assertSame('Error', $exception->getStatus() ." ". $exception->getMessage());
    }
    
  }

HLR Request

Here is an example queries the mobile phone status with the related information like current operator, format, active, ported information, subscription country, etc:

public $username = 'myusername';
  public $token = 'mytoken';

  public function testHlr()
  {
    try {
      $numbers = [];//[34XXXXXXXX,34XXXXXXXX]
      $labsMobileClient = new LabsMobileClient($this->username, $this->token);
      $bodyHlr = new LabsMobileModelHlrRequest(json_encode($numbers));
      $labsMobileClient = $labsMobileClient->hlrRequest($bodyHlr);
      $body = $labsMobileClient->getBody();
      $json = json_decode($body);
      self::assertSame('ok', $json->result);
    } catch (RestException $exception) {
      self::assertSame('Error', $exception->getStatus() ." ". $exception->getMessage());
    }
  }

Help

If you have questions, you can contact us through the support chat or through the support email [e-mail].