PHPackages                             calisero/calisero-php - 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. [API Development](/categories/api)
4. /
5. calisero/calisero-php

ActiveLibrary[API Development](/categories/api)

calisero/calisero-php
=====================

Official PHP library for Calisero SMS API

2.1.1(6mo ago)1504↓50%1MITPHPPHP ^7.4 || ^8.0CI passing

Since Sep 18Pushed 6mo agoCompare

[ Source](https://github.com/calisero/calisero-php)[ Packagist](https://packagist.org/packages/calisero/calisero-php)[ RSS](/packages/calisero-calisero-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (8)Dependencies (3)Versions (10)Used By (1)

Calisero PHP SMS API Library
============================

[](#calisero-php-sms-api-library)

[![Latest Version on Packagist](https://camo.githubusercontent.com/1984ecdecc46a99aea3eb0491c89a20decf9262c34b497c8a95fbaf200ff4d9c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f63616c697365726f2f63616c697365726f2d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/calisero/calisero-php)[![tests](https://github.com/calisero/calisero-php/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/calisero/calisero-php/actions/workflows/ci.yml)[![PHPStan](https://camo.githubusercontent.com/fa7d257d0c5c1cf237ac3490ef3a5561626b17fcb0a8547c01b0bb8746554e60/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c253230392d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](https://phpstan.org)[![License](https://camo.githubusercontent.com/ba2fe6dcce981f7b957380a261ebf989b34d23d2088ba9ec9487c28e1928d760/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f63616c697365726f2f63616c697365726f2d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/calisero/calisero-php)[![Tests](https://camo.githubusercontent.com/30e9c2ee522b57bc2d8a94b361f103109cbc89cd1877ba2719f689ae54d7fd5d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f63616c697365726f2f63616c697365726f2d7068702f63692e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/calisero/calisero-php/actions/workflows/ci.yml)[![Total Downloads](https://camo.githubusercontent.com/a8744e586910debde10876cfd22f26e0302669342a2f7a0a25743602d51774ed/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f63616c697365726f2f63616c697365726f2d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/calisero/calisero-php)

**Official PHP library for the [Calisero](https://calisero.ro) transactional SMS API.**

Send SMS messages, manage opt-outs for GDPR compliance, and monitor your account—all with a simple, type-safe PHP library that just works.

Features
--------

[](#features)

- 🚀 **Simple & Intuitive**: Easy-to-use API with clean factory methods
- 🔒 **Type Safe**: Full PHP type declarations and PHPStan level 9 compliance
- 🌐 **Self-Contained**: Built-in HTTP client using cURL, no external dependencies
- 🔄 **Idempotency**: Built-in idempotency key generation for safe retries
- 📱 **Complete API Coverage**: All Calisero SMS API endpoints supported
- 🛡️ **Error Handling**: Comprehensive exception hierarchy for different error types
- 📖 **Rich Examples**: 14+ working examples covering every use case
- ⚡ **Zero Configuration**: Works immediately after installation
- 🏗️ **Production Ready**: Used in production by businesses worldwide
- � **Minimal Dependencies**: Only requires PHP and basic extensions
- 🎯 **Laravel Integration**: Official Laravel wrapper `calisero/laravel-sms` available

Requirements
------------

[](#requirements)

- PHP 7.4 or higher
- `ext-json` extension
- `ext-curl` extension

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

[](#installation)

Install the library via Composer:

```
composer require calisero/calisero-php
```

That's it! The library includes its own HTTP client implementation and requires no additional dependencies.

Getting Your API Key
--------------------

[](#getting-your-api-key)

To use this library, you'll need an API key from your Calisero account:

1. **Log in to your Calisero account** at
2. **Navigate to the dashboard** and go to the **"API Keys"** section
3. **Click "Add Key"** to create a new API key
4. **Configure your key:**
    - Give it a descriptive name (e.g., "Production App", "Development")
    - Set IP filters if needed for additional security
    - Choose appropriate permissions
5. **Copy your API key** and store it securely

### API Key Management

[](#api-key-management)

From the API Keys section in your dashboard, you can:

- ✅ **Add new keys** for different applications or environments
- ✏️ **Edit existing keys** to update names or permissions
- 🗑️ **Delete keys** that are no longer needed
- 🛡️ **Add IP filters** to restrict key usage to specific IP addresses
- 📊 **Monitor key usage** and activity logs

> **Security Note**: Never commit API keys to version control. Use environment variables or secure configuration files.

Quick Start
-----------

[](#quick-start)

### Basic SMS Sending

[](#basic-sms-sending)

```