Download the PHP package devriyad/giosms without Composer

GioSMS PHP SDK

The official PHP SDK for GioSMS — a fast, reliable SMS gateway for Bangladesh. Works with Laravel 9+ (zero config, auto-discovery) and any standalone PHP 8.1+ project.

Table of Contents

• Requirements
• Installation
• Setup — Laravel
• Setup — Standalone PHP (Without Laravel)
• Usage
  • Send Single SMS
  • Send OTP (High Priority)
  • Send Bulk SMS
  • Send to Contacts
  • Send to Groups
  • Check Delivery Status
  • Check Balance & Cost Estimate
  • Batch Tracking
  • Health Check
• Error Handling
• Laravel Dependency Injection
• Reference
  • All Methods at a Glance
  • SMS Types & Priority
  • Encoding & Character Limits
  • HTTP Status Codes & Exceptions
• License

Requirements

• PHP 8.1 or higher
• Guzzle 7.x (installed automatically via Composer)
• A GioSMS account and API token from api.giosms.com

Installation

That's it. Guzzle is pulled in automatically if you don't already have it.

Setup — Laravel

Zero config. The service provider and facade are auto-discovered. No need to edit config/app.php.

Step 1: Add credentials to .env

Step 2 (Optional): Publish the config file

This creates config/giosms.php if you need to customize anything beyond .env variables.

Step 3: Start sending

Setup — Standalone PHP (Without Laravel)

For any PHP project that doesn't use Laravel — plain PHP, Symfony, CodeIgniter, Slim, etc.

Option A: Pass config directly

Option B: Use a .env file (recommended for production)

If you want to keep secrets out of your code, use the popular vlucas/phpdotenv package:

Create a .env file in your project root:

Then load it in your code:

Note: Add .env to your .gitignore so your API token is never committed to version control.

Constructor Parameters

Usage

All examples below use the Laravel Facade syntax. For standalone PHP, replace GioSMS::method(...) with $sms->method(...) where $sms is your new GioSMS([...]) instance.

Send Single SMS

Parameters

Send OTP (High Priority)

OTP messages are processed in the highest priority queue for the fastest possible delivery.

The type is automatically set to otp — you don't need to specify it.

Send Bulk SMS

Send the same message to multiple phone numbers at once. Pass to as an array — the SDK handles the comma-separated conversion.

Send to Contacts

Send to contacts stored in your GioSMS account by their IDs.

Send to Groups

Send to all contacts in one or more groups. Duplicate phone numbers across groups are automatically deduplicated by the API.

Provide either message or template_id, not both.

Check Delivery Status

Status flow: queued → submitted → delivered or failed

Check Balance & Cost Estimate

Batch Tracking

Health Check

Check if the GioSMS API is up. This endpoint requires no authentication.

Error Handling

The SDK throws specific exceptions for each error type. All exceptions extend GioSMSException, so you can catch them broadly or specifically.

Standalone PHP — same approach:

Laravel Dependency Injection

Instead of using the Facade, you can type-hint GioSMS anywhere Laravel resolves dependencies — controllers, jobs, commands, etc.

In a queued job:

Reference

All Methods at a Glance

SMS Types & Priority

Default type is transactional for send(), otp(), and toContacts(), and promotional for bulk() and toGroups().

Encoding & Character Limits

Encoding is detected automatically by the API based on your message content. No configuration needed.

HTTP Status Codes & Exceptions

License

MIT — see LICENSE for details.

Built with ❤️ by Riyad Munauwar