Download the PHP package kambasms/php-sdk without Composer

On this page you can find all versions of the php package kambasms/php-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of kambasms/php-sdk

Informations about the package php-sdk

🇦🇴 KambaSMS PHP SDK

Packagist Version PHP Version

SDK oficial e leve da KambaSMS para integração de envio de mensagens SMS em Angola. Desenvolvido com tipagem forte (PHP 8.0+) e zero dependências externas (utiliza cURL nativo), garantindo máxima compatibilidade e performance.

✨ Funcionalidades

📦 Instalação

Instala o pacote via Composer:

Nota: Requer PHP 8.0 ou superior e a extensão curl ativada (ativada por padrão na maioria dos servidores).

⚡ Início Rápido

1. Inicialização

Obtém a tua chave API no Dashboard da KambaSMS e inicializa o cliente:

2. Enviar um SMS Único

3. Envio em Massa (Bulk)

Ideal para campanhas de marketing ou notificações para múltiplos contactos (máximo de 1000 destinatários por pedido).

4. Agendar um SMS

Ideal para campanhas de marketing ou notificações para múltiplos contactos (máximo de 1000 destinatários por pedido).

5. Consultar Saldo e Histórico

Ideal para campanhas de marketing ou notificações para múltiplos contactos (máximo de 1000 destinatários por pedido).

🔐 Serviço OTP

Serviço gerido de autenticação por SMS. Rate limiting (3 por hora por número), expiração (5 minutos) e validação incluídos.

Enviar OTP

Verificar OTP

⚠️ O endpoint verify é público — não requer API Key. Pode ser chamado diretamente do frontend.

Regras do OTP

Regra Valor
Formato do código 6 dígitos numéricos
Validade 5 minutos
Rate limit (envio) 3 OTPs/hora por número
Rate limit (verificação) 20 tentativas/15min
Custo 1 crédito SMS por envio

🛡️ Regras de Validação (Específicas para Angola)

O SDK faz validações automáticas no lado do cliente para garantir que a tua mensagem não seja bloqueada pelas operadoras (Unitel, Africell, Movicel). Se estas regras forem violadas, o SDK lança uma KambaValidationException sem sequer fazer a chamada à API.

  1. Formato do Número: Deve começar obrigatoriamente com +244 seguido de exatamente 9 dígitos (ex: +244923456789).

  2. Sem URLs: Mensagens contendo http://, https://, www. ou domínios como .com, .ao são rejeitadas (filtradas como spam pelas operadoras).

  3. Sem Emojis: Caracteres emoji não são suportados e podem causar cobrança de múltiplos segmentos ou bloqueio.

  4. Limite de Caracteres: Máximo de 160 caracteres por SMS.

⚠️ Tratamento de Erros Robusto

O SDK exporta classes de exceção específicas para que possas tratar falhas de forma elegante e segura no teu código:

💡 Dica para Laravel

Se estiveres a usar Laravel, podes registar o cliente no teu AppServiceProvider para injeção de dependência:

E depois usar em qualquer Controller: public function __construct(private \KambaSMS\KambaSMS $sms) {}

📚 Documentação Completa

Para mais detalhes sobre endpoints avançados, webhooks de entrega e gestão de conta, consulta a Documentação Oficial da KambaSMS.

🆘 Suporte

Encontraste um bug ou tens uma sugestão?

📄 Licença

Este projeto está licenciado sob a Licença MIT.

All versions of php-sdk with dependencies

PHP Build Version
Package Version
Requires php Version ^8.0
ext-curl Version *
ext-json Version *
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package kambasms/php-sdk contains the following files

Loading the files please wait ...