README

This library was made purely from onlinecity/php-smpp 1.2 tag version. It looked more up-to-date and maintained than 1.0.1-namespaced tag (dated 2011).

This is an implementation of SMS SMPP client in PHP, ready for use with PSR autoloading.

Whole documentation below is copied from legacy library.

This library was prepared to work with jazzy/php-smpp-bundle.

Legacy description

This is a simplified SMPP client lib for sending or receiving smses through SMPP v3.4.

In addition to the client, this lib also contains an encoder for converting UTF-8 text to the GSM 03.38 encoding, and a socket wrapper. The socket wrapper provides connection pool, IPv6 and timeout monitoring features on top of PHP's socket extension.

This lib requires the sockets PHP-extension, and is not supported on Windows.

Basic usage example

To send a SMS:

<?php

use PhpSmpp\Client\SMPP;
use PhpSmpp\Client\SmppAddress;
use PhpSmpp\Client\SmppClient;
use PhpSmpp\GsmEncoder;
use PhpSmpp\Transport\SocketTransport;

// Construct transport and client
$transport = new SocketTransport(['smpp.provider.com'], 2775);
$transport->setRecvTimeout(10000);
$smpp = new SmppClient($transport);

// Activate binary hex-output of server interaction
$smpp->debug = true;
$transport->debug = true;

// Open the connection
$transport->open();
$smpp->bindTransmitter('USERNAME', 'PASSWORD');

// Optional connection specific overrides
//SmppClient::$sms_null_terminate_octetstrings = false;
//SmppClient::$csms_method = SmppClient::CSMS_PAYLOAD;
//SmppClient::$sms_registered_delivery_flag = SMPP::REG_DELIVERY_SMSC_BOTH;

// Prepare message
$message = 'H€llo world';
$encodedMessage = GsmEncoder::utf8_to_gsm0338($message);
$from = new SmppAddress('SMPP Test', SMPP::TON_ALPHANUMERIC);
$to = new SmppAddress(4512345678, SMPP::TON_INTERNATIONAL, SMPP::NPI_E164);

// Send
$smpp->sendSMS($from, $to, $encodedMessage);

// Close connection
$smpp->close();

To receive a SMS (or delivery receipt):

<?php

use PhpSmpp\Client\SmppClient;
use PhpSmpp\Transport\SocketTransport;

// Construct transport and client
$transport = new SocketTransport(['smpp.provider.com'], 3600);
$transport->setRecvTimeout(60000); // For this example wait up to 60 seconds for data
$smpp = new SmppClient($transport);

// Activate binary hex-output of server interaction
$smpp->debug = true;
$transport->debug = true;

// Open the connection
$transport->open();
$smpp->bindReceiver('USERNAME', 'PASSWORD');

// Read SMS and output
$sms = $smpp->readSMS();
echo "SMS:\n";
var_dump($sms);

// Close connection
$smpp->close();

Connection pools

You can specify a list of connections to have the SocketTransport attempt each one in succession or randomly. Also if you give it a hostname with multiple A/AAAA-records it will try each one. If you want to monitor the DNS lookups, set defaultDebug to true before constructing the transport.

The (configurable) send timeout governs how long it will wait for each server to timeout. It can take a long time to try a long list of servers, depending on the timeout. You can change the timeout both before and after the connection attempts are made.

The transport supports IPv6 and will prefer IPv6 addresses over IPv4 when available. You can modify this feature by setting forceIpv6 or forceIpv4 to force it to only use IPv6 or IPv4.

In addition to the DNS lookups, it will also look for local IPv4 addresses using gethostbyname(), so "localhost" works for IPv4. For IPv6 localhost specify "::1".

Implementation notes

You can't connect as a transceiver, otherwise supported by SMPP v.3.4
The SUBMIT_MULTI operation of SMPP, which sends a SMS to a list of recipients, is not supported atm. You can easily add it though.
The sockets will return false if the timeout is reached on read() (but not readAll or write). You can use this feature to implement an enquire_link policy. If you need to send enquire_link for every 30 seconds of inactivity, set a timeout of 30 seconds, and send the enquire_link command after readSMS() returns false.
The examples above assume that the SMSC default datacoding is GSM 03.38.
Remember to activate registered delivery if you want delivery receipts (set to SMPP::REG_DELIVERY_SMSC_BOTH / 0x01).
Both the SmppClient and transport components support a debug callback, which defaults to error_log . Use this to redirect debug information.

F.A.Q.

I can't send more than 160 chars
There are three built-in methods to send Concatenated SMS (csms); CSMS_16BIT_TAGS, CSMS_PAYLOAD, CSMS_8BIT_UDH. CSMS_16BIT_TAGS is the default, if it don't work try another.

Why am I not seeing any debug output?
Remember to implement a debug callback for SocketTransport and SmppClient to use. Otherwise they default to error_log which may or may not print to screen.

Why do I get 'res_nsend() failed' or 'Could not connect to any of the specified hosts' errors?
Your provider's DNS server probably has an issue with IPv6 addresses (AAAA records). Try to set `SocketTransport::$forceIpv4=true;`. You can also try specifying an IP-address (or a list of IPs) instead. Setting `SocketTransport:$defaultDebug=true;` before constructing the transport is also useful in resolving connection issues.

I tried forcing IPv4 and/or specifying an IP-address, but I'm still getting 'Could not connect to any of the specified hosts'?
It would be a firewall issue that's preventing your connection, or something else entirely. Make sure debug output is enabled and displayed. If you see something like 'Socket connect to 1.2.3.4:2775 failed; Operation timed out' this means a connection could not be etablished. If this isn't a firewall issue, you might try increasing the connect timeout. The sendTimeout also specifies the connect timeout, call `$transport->setSendTimeout(10000);` to set a 10-second timeout.

Why do I get 'Failed to read reply to command: 0x4', 'Message Length is invalid' or 'Error in optional part' errors?
Most likely your SMPP provider doesn't support NULL-terminating the message field. The specs aren't clear on this issue, so there is a toggle. Set `SmppClient::$sms_null_terminate_octetstrings = false;` and try again.

What does 'Bind Failed' mean?
It typically means your SMPP provider rejected your login credentials, ie. your username or password.

jazzypro / php-smpp

Maintainers

Details