PHPackages                             altiria/sms-php-client - 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. [HTTP & Networking](/categories/http)
4. /
5. altiria/sms-php-client

ActiveLibrary[HTTP & Networking](/categories/http)

altiria/sms-php-client
======================

Cliente PHP para el envío de SMS con Altiria

1.0.2(4y ago)63974[1 issues](https://github.com/altiria/sms-php-client/issues)MITPHPPHP ^7.0.0

Since Sep 17Pushed 4y ago2 watchersCompare

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

READMEChangelog (3)Dependencies (2)Versions (4)Used By (0)

[![](https://camo.githubusercontent.com/7f7bdb5a68015826d5e53d1bbc999264ca0cca50deb3dd23c2e7014cf1133027/687474703a2f2f7374617469632e616c74697269612e636f6d2f77702d636f6e74656e742f7468656d65732f616c74697269612f696d616765732f6c6f676f2d616c74697269612e706e67)](https://camo.githubusercontent.com/7f7bdb5a68015826d5e53d1bbc999264ca0cca50deb3dd23c2e7014cf1133027/687474703a2f2f7374617469632e616c74697269612e636f6d2f77702d636f6e74656e742f7468656d65732f616c74697269612f696d616765732f6c6f676f2d616c74697269612e706e67)

Altiria, cliente envío de SMS con PHP
=====================================

[](#altiria-cliente-envío-de-sms-con-php)

[![](https://camo.githubusercontent.com/2f97a2b4477732b5b4d663facb8646dad6a0e89db9abdee649d5ef733a65da66/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e302e322d626c75652e737667)](https://camo.githubusercontent.com/2f97a2b4477732b5b4d663facb8646dad6a0e89db9abdee649d5ef733a65da66/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e302e322d626c75652e737667)

Altiria SMS PHP es el cliente de envío de SMS que simplifica al máximo la integración del API SMS para PHP de Altiria.

- **Envíos de SMS individuales**
    - sencillos
    - concatenados
    - confirmación de entrega
    - remitente personalizado
- **Consultas de crédito**

Esta librería hace uso de **composer** y cumple con las especificaciones **PSR-4**.

Uso
---

[](#uso)

Es necesario tener una cuenta de envío con Altiria. Si todavía no tienes una,

[Regístrate para crear una cuenta de prueba](https://www.altiria.com/free-trial/)

[Documentación de la API](https://www.altiria.com/api-envio-sms/)

Requisitos
----------

[](#requisitos)

- php: ^7.0.0
- [composer](https://getcomposer.org/)

Instalación
-----------

[](#instalación)

La forma recomendada de instalar el cliente Altiria para PHP es a través de Composer. Puedes hacerlo de dos maneras:

### A través de línea de comandos

[](#a-través-de-línea-de-comandos)

```
composer require altiria/sms-php-client
```

### Editando el fichero composer.json y actualizando el proyecto

[](#editando-el-fichero-composerjson-y-actualizando-el-proyecto)

En este caso, añadir el siguiente fragmento al fichero composer.json.

```
"require": {
	"altiria/sms-php-client": "1.0.2"
}
```

A continuación, actualizar el proyecto ejecutando la siguiente instrucción por línea de comandos.

```
composer install
```

Ejemplos de uso
---------------

[](#ejemplos-de-uso)

### Envío de SMS

[](#envío-de-sms)

A continuación se describen cada una de las posibilidades de uso de la librería para realizar envíos de SMS.

#### Ejemplo básico

[](#ejemplo-básico)

Se trata de la opción más sencilla para realizar un envío de SMS.

```
use \AltiriaSmsPhpClient\AltiriaClient;
use \AltiriaSmsPhpClient\AltiriaModelTextMessage;
use \AltiriaSmsPhpClient\Exception\GeneralAltiriaException;

try {
    //Personaliza las credenciales de acceso
    $client = new AltiriaClient('user@mydomain.com', 'mypassword');
    $textMessage = new AltiriaModelTextMessage('346XXXXXXXX', 'Mensaje de prueba');
    $client-> sendSms($textMessage);
    echo '¡Mensaje enviado!';
} catch (GeneralAltiriaException $exception) {
    echo 'Mensaje no aceptado:'.$exception->getMessage();
}
```

#### Ejemplo básico con timeout personalizado

[](#ejemplo-básico-con-timeout-personalizado)

Permite fijar el tiempo de respuesta en milisegundos. Si se supera se lanzará una **ConnectionException**. Por defecto el tiempo de respuesta es de 10 segundos, pero puede ser ajustado entre 1 y 30 segundos.

```
use \AltiriaSmsPhpClient\AltiriaClient;
use \AltiriaSmsPhpClient\AltiriaModelTextMessage;

try {
    //Personaliza las credenciales de acceso
    $client = new AltiriaClient('user@mydomain.com', 'mypassword', false, 5000);
    $textMessage = new AltiriaModelTextMessage('346XXXXXXXX', 'Mensaje de prueba');
    $client-> sendSms($textMessage);
    echo '¡Mensaje enviado!';
} catch (\AltiriaSmsPhpClient\Exception\AltiriaGwException $exception) {
    echo 'Mensaje no aceptado:'.$exception->getMessage();
    echo 'Código de error: '.$exception->getStatus();
} catch (\AltiriaSmsPhpClient\Exception\JsonException $exception) {
    echo 'Error en la petición:'.$exception->getMessage();
} catch (\AltiriaSmsPhpClient\Exception\ConnectionException $exception) {
    if ($exception->getMessage().strpos('RESPONSE_TIMEOUT', 0) != -1) {
        echo 'Tiempo de respuesta agotado: '.$exception->getMessage();
    } else {
        echo 'Tiempo de conexión agotado: '.$exception->getMessage();
    }
}
```

#### Ejemplo básico con remitente

[](#ejemplo-básico-con-remitente)

Se trata de la opción más sencilla para realizar un envío de SMS añadiendo remitente. En este caso, se ilustra cómo realizar la autentificación mediante APIKEY, donde "XXXXXXXXXX" es el parámetro **apiKey** y "YYYYYYYYYY" el parámetro **apiSecret**.

```
use \AltiriaSmsPhpClient\AltiriaClient;
use \AltiriaSmsPhpClient\AltiriaModelTextMessage;

try {
    //Personaliza las credenciales de acceso
    $client = new AltiriaClient('XXXXXXXXXX', 'YYYYYYYYYY', true);
    $textMessage = new AltiriaModelTextMessage('346XXXXXXXX', 'Mensaje de prueba', 'miRemitente');
    $client-> sendSms($textMessage);
    echo '¡Mensaje enviado!';
} catch (\AltiriaSmsPhpClient\Exception\AltiriaGwException $exception) {
    echo 'Mensaje no aceptado:'.$exception->getMessage();
    echo 'Código de error: '.$exception->getStatus();
} catch (\AltiriaSmsPhpClient\Exception\JsonException $exception) {
    echo 'Error en la petición:'.$exception->getMessage();
} catch (\AltiriaSmsPhpClient\Exception\ConnectionException $exception) {
    if ($exception->getMessage().strpos('RESPONSE_TIMEOUT', 0) != -1) {
        echo 'Tiempo de respuesta agotado: '.$exception->getMessage();
    } else {
        echo 'Tiempo de conexión agotado: '.$exception->getMessage();
    }
}
```

#### Ejemplo con todos los parámetros

[](#ejemplo-con-todos-los-parámetros)

Se muestra un ejemplo utilizando todo los parámetros mediante setters.

```
use \AltiriaSmsPhpClient\AltiriaClient;
use \AltiriaSmsPhpClient\AltiriaModelTextMessage;

try {
    //Personaliza las credenciales de acceso
    $client = new AltiriaClient('user@mydomain.com', 'mypassword');
    $client->setConnectTimeout(1000);
    $client->setTimeout(5000);
    $client->setDebug(true);
    $textMessage = new AltiriaModelTextMessage('346XXXXXXXX', 'Mensaje de prueba');
    $textMessage->setSenderId('miRemitente');
    $textMessage->setAck(true);
    $textMessage->setIdAck('idAck');
    $textMessage->setConcat(true);
    $textMessage->setEncoding('unicode');
    $textMessage->setCertDelivery(true);
    $client-> sendSms($textMessage);
    echo '¡Mensaje enviado!';
} catch (\AltiriaSmsPhpClient\Exception\AltiriaGwException $exception) {
    echo 'Mensaje no aceptado:'.$exception->getMessage();
    echo 'Código de error: '.$exception->getStatus();
} catch (\AltiriaSmsPhpClient\Exception\JsonException $exception) {
    echo 'Error en la petición:'.$exception->getMessage();
} catch (\AltiriaSmsPhpClient\Exception\ConnectionException $exception) {
    if ($exception->getMessage().strpos('RESPONSE_TIMEOUT', 0) != -1) {
        echo 'Tiempo de respuesta agotado: '.$exception->getMessage();
    } else {
        echo 'Tiempo de conexión agotado: '.$exception->getMessage();
    }
}
```

### Consulta de crédito

[](#consulta-de-crédito)

Ejemplos de consulta del crédito de SMS en la cuenta de Altiria.

#### Ejemplo básico

[](#ejemplo-básico-1)

```
use \AltiriaSmsPhpClient\AltiriaClient;

try {
    //Personaliza las credenciales de acceso
    $client = new AltiriaClient('user@mydomain.com', 'mypassword');
    $credit = $client-> getCredit();
    echo 'Crédito disponible: '.$credit;
} catch (\AltiriaSmsPhpClient\Exception\AltiriaGwException $exception) {
    echo 'Solicitud no aceptada:'.$exception->getMessage();
    echo 'Código de error: '.$exception->getStatus();
} catch (\AltiriaSmsPhpClient\Exception\JsonException $exception) {
    echo 'Error en la petición:'.$exception->getMessage();
} catch (\AltiriaSmsPhpClient\Exception\ConnectionException $exception) {
    if ($exception->getMessage().strpos('RESPONSE_TIMEOUT', 0) != -1) {
        echo 'Tiempo de respuesta agotado: '.$exception->getMessage();
    } else {
        echo 'Tiempo de conexión agotado: '.$exception->getMessage();
    }
}
```

Licencia
--------

[](#licencia)

La licencia de esta librería es de tipo MIT. Para más información consultar el fichero de licencia.

Ayuda
-----

[](#ayuda)

Utilizamos la sección de problemas de GitHub para tratar errores y valorar nuevas funciones. Para cualquier problema durante la intergración contactar a través del email .

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance17

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 97.9% 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 ~94 days

Total

3

Last Release

1515d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/72063afcbf43d12028e01745979098e008d228357e36753c4a32e7a68e1b0b8f?d=identicon)[altiria](/maintainers/altiria)

---

Top Contributors

[![altiria](https://avatars.githubusercontent.com/u/90601711?v=4)](https://github.com/altiria "altiria (47 commits)")[![jpls21](https://avatars.githubusercontent.com/u/90764742?v=4)](https://github.com/jpls21 "jpls21 (1 commits)")

---

Tags

altiriacomposerenviar-smsenvio-de-smsenvio-smshttpclientphppsr-4smssms-apisms-clientsms-gatewaysms-messagessms-notificationssms-pasarelasms-phpsms-transaccionalsmsapiphpcomposersmsPSR-4sms apisms-gatewayhttpclientsmsapisms-clientsms-notificationssms-messagessms-phpaltiriaenviar-smsenvio-de-smsenvio-smssms-transaccionalsms-pasarela

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/altiria-sms-php-client/health.svg)

```
[![Health](https://phpackages.com/badges/altiria-sms-php-client/health.svg)](https://phpackages.com/packages/altiria-sms-php-client)
```

###  Alternatives

[infobip/infobip-api-php-client

PHP library for consuming Infobip's API

921.8M10](/packages/infobip-infobip-api-php-client)[ender/yunpian-sms

A php SDK for yunpian(云片网络短信服务商) sms RESTFULL API

294.9k](/packages/ender-yunpian-sms)

PHPackages © 2026

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