Connect PHP SDK

, _(*1)

, _(*2)

The Connect PHP SDK allows you to push events to Connect from PHP., _(*3)

If you don’t already have a Connect account, sign up here - it’s free!, _(*4)

Installation

The easiest way to install the Connect SDK is to use Composer., _(*5)

Add connect/connect-client as a dependency and run composer update., _(*6)

"require": {
    …
    "connect/connect-client" : "0.*"
    …
}

Usage

Initializing a client

use Connect\Connect;

Connect::initialize('your-project-id', 'your-push-api-key');

Pushing events

Once you have initialized Connect, you can push events easily:, _(*7)

$purchase = [
    'customer' => [
       'firstName' => 'Tom',
       'lastName' => 'Smith'
    ],
    'product' => '12 red roses',
    'purchasePrice' => 34.95
];

Connect::push('purchases', $purchase);

You can also push events in batches:, _(*8)

$batch = [
    'purchases' => [
        [
            'customer' => [
                'firstName' => 'Tom',
                'lastName' => 'Smith'
            ],
            'product' => '12 red roses',
            'purchasePrice' => 34.95
        ],
        [
            'customer' => [
                'firstName' => 'Fred',
                'lastName' => 'Jones'
            ],
            'product' => '12 pink roses',
            'purchasePrice' => 38.95
        ]
    ]
];

Connect::push($batch);

Generating filtered keys

To generate a filtered key, _(*9)

$masterKey = 'YOUR_MASTER_KEY';
$keyDefinition = [
    'filters' => [
        'type' => 'cycling'
    ],
    'canQuery' => True,
    'canPush' => True
];

$filteredKey = Connect::generateFilteredKey($keyDefinition, $masterKey);
print $filteredKey;