Download the PHP package satori-com/satori-rtm-sdk-php without Composer

Satori RTM SDK for PHP

Use the PHP SDK for the Satori platform to create applications that use the RTM to publish and subscribe.

Requirements

• PHP 5.4+ (PHP 5.6+ recommended)
• PHP Composer (optional, recommended)

PHP SDK Installation and Usage

Via Composer

To install the PHP SDK from the Central Composer repository use composer:

Highly recommended to use version tag when installing SDK:

Detailed information about the PHP SDK package and a list of available versions can be found here: https://packagist.org/packages/satori-com/satori-rtm-sdk-php

Include the SDK into your PHP file using the Composer autoloader:

Via Source Code

Clone the PHP SDK to your project (or any directory on your computer):

Include the SDK into your PHP file using the SDK autoloader:

Documentation and Examples

https://satori-com.github.io/satori-rtm-sdk-php/

Logging and Debugging

PHP SDK logs information to STDOUT/STDERR. To enable debug level, set DEBUG_SATORI_SDK environment variable to true:

or

Debug level outputs all underlying communication with RTM, in addition to SDK execution info.
Example:

Testing

PHP SDK uses PHPUnit for testing. PHPUnit requires PHP 5.6+. In spite of PHP SDK itself requires PHP 5.4+, you have to upgrade your PHP version to 5.6+.

Tests require a valid RTM endpoint; RTM credentials should be populated in credentials.json.

The credentials.json file must include the following key-value pairs:

• endpoint is your customer-specific DNS name for RTM access.
• appkey is your application key.
• auth_role_name is a role name that permits to publish / subscribe to auth_restricted_channel. Must be not default.
• auth_role_secret_key is a secret key for auth_role_name.
• auth_restricted_channel is a channel with subscribe and publish access for auth_role_name role only.

You must use DevPortal to create role and set channel permissions.

After setting up credentials.json, run SDK tests with the following commands:

To enable testing verbose mode use:

Binary protocol

RTM supports CBOR protocol to work with a binary data.
In order to use CBOR protocol you must to install PHP SDK via Composer: How to install SDK via Composer

See examples/cbor.php to get more information about establishing a connection using CBOR.

Persistent connections

Persistent connections are good solution to reduce execution time by using an already established connection. PHP does not spend additional time establishing a new connection and authorization.

But this solution has a number of limitations:

• You can not subscribe to any channel. This limitation was added in order to avoid a possible situation with an overflow of the incoming buffer after the script is finished;
• There is a possible situation with the PDU collision. The script can do publish with ack, but do not wait for an reply from Satori RTM and finish the work.  Because the connection is not closed, the following script, which will use it, will receive ack, although it has not sent anything yet or it will publish with ack, but when reading reply it gets ack from the previous script;
• PHP SDK guarantee that you will get the same RTM Client instance if you establish a persistent connection to the same host:port from a different places within one script launch;

Usage:

IMPORTANT NOTICE

Persistent connections work only in the environments that support persistent connections, like PHP-FPM mode, FastCGI mode, Apache mod_php, etc.

Troubleshooting

Unable to Connect to a Secure Endpoint

Symptom:

$ php your_app/index.php
[info] 2017/08/03 15:28:22.512700 Client: Connecting to endpoint: wss://<endpoint>.api.satori.com/v2
[erro] 2017/08/03 15:28:22.535000 Failed establish connection to <endpoint>.api.satori.com:443:  (0)

Solution:

• Check if you are able to connect to this endpoint:

  If you fail to connect, check your firewall settings.

• Check PHP SSL settings:

  Make sure that the default_cert_file points to an existing cert file and default_default_cert_area points to the existing directory.

  If your certs are in another location, set environment variables that point to the certs by entering the following in a console window: