track-any-device/sms-gateway

SMS gateway HTTP client for the Track Any Device platform.

2.0.1 2026-05-23 16:34 UTC

Requires

• php: ^8.3
• illuminate/http: ^11.0|^12.0
• illuminate/log: ^11.0|^12.0
• illuminate/support: ^11.0|^12.0
• nesbot/carbon: ^3.0

MIT

README

Laravel HTTP client package for the Track Any Device SMS gateway device. Wraps the gateway REST API with a typed service class, automatic config merging, and a contract interface for easy mocking in tests.

Requirements

• PHP 8.3+
• Laravel 11, 12, or 13

Installation

composer require track-any-device/sms-gateway

The service provider is auto-discovered. No manual registration needed.

Configuration

Publish the config file:

php artisan vendor:publish --tag=sms-gateway-config

This creates config/sms.php. Add the corresponding values to your .env:

SMS_GATEWAY_URL=http://192.168.1.100:8080
SMS_GATEWAY_API_KEY=your-api-key
SMS_GATEWAY_TIMEOUT=15

Key	Description	Default
SMS_GATEWAY_URL	Base URL of the gateway device	—
SMS_GATEWAY_API_KEY	API key sent as X-API-Key	—
SMS_GATEWAY_TIMEOUT	HTTP timeout in seconds	15

Usage

Inject SmsGatewayContract (or SmsGatewayService) wherever you need it:

use TrackAnyDevice\SmsGateway\Contracts\SmsGatewayContract;

class NotificationController extends Controller
{
    public function __construct(private SmsGatewayContract $sms) {}

    public function notify(string $phone): void
    {
        $this->sms->send($phone, 'Your order has been dispatched.');
    }
}

Send an SMS

$sent = $sms->send('[phone]', 'Hello from TAD!');

if (! $sent) {
    // false is returned on HTTP error, gateway error, or network exception
    // details are logged via Log::error
}

Check gateway health

if ($sms->health()) {
    // gateway is reachable and reports status: ok
}

Read the inbox

$messages = $sms->inbox();

// Each message:
// [
//     'index'   => '1',
//     'sender'  => '[phone]',
//     'message' => 'Reply text',
//     'date'    => '2024/06/01 14:30:00+0100',
// ]

foreach ($messages as $msg) {
    $received = $sms->parseGatewayDate($msg['date']); // CarbonImmutable|null
    echo $msg['sender'].': '.$msg['message'];
}

Delete a message

$deleted = $sms->deleteMessage($msg['index']);

Device status

$status = $sms->status();

// Returns array or null:
// [
//     'signal'   => '-73 dBm',
//     'network'  => '4G',
//     'operator' => 'EE',
//     'sim'      => 'ready',
// ]

Testing

Bind a mock against the contract in your test:

use TrackAnyDevice\SmsGateway\Contracts\SmsGatewayContract;

$this->mock(SmsGatewayContract::class)
    ->shouldReceive('send')
    ->once()
    ->with('[phone]', 'Hello from TAD!')
    ->andReturn(true);

Logging

All failures are logged through Laravel's default logger:

Event	Level
send HTTP error or gateway error	error
send network exception	error
inbox HTTP error	error
inbox network exception	error
parseGatewayDate bad format	warning

Licence

MIT