kingsquare/communibase-connector-php

This is the Communibase connector for PHP.

Thursday, October 19, 2017
by Reggino
Repository
6 Watchers
1 Stars
927 Installations

PHP
0 Dependents
0 Suggesters
1 Forks
0 Open issues
25 Versions
1 % Grown

The README.md

, _(*1)

, _(*2)

A general-purpose Communibase client for PHP projects, compatible with composer packaging-projects., _(*3)

A connector may be constructed to do REST-calls on the Communibase API., _(*4)

The behaviour of this package should always Mimic the node-version, _(*5)

Usage

The easiest way to install the connector is to use Composer:, _(*6)

composer require kingsquare/communibase-connector-php

Now you should be able to install the package by updating your composer environment composer install
The connector is available and usable as follows:, _(*7)

require_once __DIR__ . '/../vendor/autoload.php'; // Autoload files using Composer autoload
use Communibase\Connector;

$cb = new Connector('<your api key here>');
$peopleNamedTim = $cb->search('Person', ['firstName' => 'Tim'], ['limit' => 5]);
print_r($peopleNamedTim);

API

"entityType" should be the Communibase Entitytype, e.g. "Person", "Invoice", etc. To see all the entity types your API key allows, see the API docs and insert your API key there., _(*8)

"selectors" may be provided MongoDb style as array-definitions., _(*9)

"params" is a key value store for e.g. fields, limit, page and/or sort . See API docs for more details. In addition to the nodeJS version of this parameter, the fields value may also be an array of fields. This will work more intuitively in PHP environments., _(*10)


$cbc->search($entityType, $selector, $params): entity[];

$cbc->getAll($entityType, $params): entity[];

$cbc->getById($entityType, $id, $params, $version): entity;

$cbc->getByIds($entityType, $ids, $params): entity[];

$cbc->getId($entityType, $selector): string;

$cbc->getIds($entityType, $selector, $params): null|string[];

$cbc->getByRef($ref[, $parent]): entity

$cbc->getTemplate($entityType): array;

$cbc->getHistory($entityType, $id): array;

$cbc->update($entityType, $properties): responseData;

$cbc->destroy($entityType, $id): responseData;

$cbc->generateId(): string - Generate a new, fresh Communibase ID

//Use for Files only to get a string with the binary contents
$cbc->getBinary(id): string;

Whenever a function like getByIds() or getByIds() returns null, the property cbc->lastError should be available containing an error message, _(*11)

Entity

An entity is an associative array containing a key/value store of data in Communibase., _(*12)

E.g., _(*13)

[
  'firstName' => 'Tim',
  'addresses' => [
    [
      'street' => 'Breestraat',
      // ...
    ], 
    // ...
  ]
]

Error handling

The connector may throw an error when something goes wrong. Default error handling is as follows:, _(*14)

try {
  $person = $cbc->getById('Person', '_PERSON_ID_');
} catch (\Communibase\Exception $e) {
  echo $e->getMessage();
}

A special type of error handling involves "Validity" errors for posted documents., _(*15)

try {
  $person = $cbc->update('Person', [...]);
} catch (\Communibase\Exception $e) {
  //get an array of errors, per property:
  //  [
  //    [
  //      'field' => '<string>',
  //      'message' => '<string>'
  //    ]
  //  ]
  print_r($e->getErrors());
}

Query Logging

It is also possible to add a query logger to the connector., _(*16)

Stack query data for debug/dev purposes:

$connector->setQueryLogger(new DebugStack());

Query data available after run via $connector->getQueryLogger()->queries, _(*17)

Echo query for debug/dev purposes (handy for cli):

$connector->setQueryLogger(new EchoQueryLogger());

Echoes each query to the current output stream., _(*18)

Create own query logging:

$connector->setQueryLogger(new MyOwnQueryLogger());

MyOwnQueryLogger implements QueryLogger and does something with the data.. possible db/api call, _(*19)

Contributions / Bugreports

If you're using this app and have questions and/or feedback, please file an issue on Github.
Also we welcome new features and code, so please don't hesitate to get that pull request online!, _(*20)

The Versions

19/10 2017

dev-master

9999999-dev

This is the Communibase connector for PHP.

library communibase-connector-php

This is the Communibase connector for PHP.

kingsquare/communibase-connector-php

The README.md

Usage

API

Entity

Error handling

Query Logging

Stack query data for debug/dev purposes:

Echo query for debug/dev purposes (handy for cli):

Create own query logging:

Contributions / Bugreports

The Versions

dev-master

The Requires

The Development Requires

by Robin Speekenbrink

by Tim de Koning

by Aubrey Hewes

dev-dev-fix-logo

The Requires

The Development Requires

by Robin Speekenbrink

by Tim de Koning

by Aubrey Hewes

2.5.4

The Requires

The Development Requires

by Robin Speekenbrink

by Tim de Koning

by Aubrey Hewes

2.5.3

The Requires

The Development Requires

by Robin Speekenbrink

by Tim de Koning

by Aubrey Hewes

dev-async-first

The Requires

The Development Requires

by Robin Speekenbrink

by Tim de Koning

by Aubrey Hewes

2.5.2

The Requires

The Development Requires

by Robin Speekenbrink

by Tim de Koning

by Aubrey Hewes

2.5.1

The Requires

The Development Requires

by Robin Speekenbrink

by Tim de Koning

by Aubrey Hewes

2.5.0

The Requires

The Development Requires

by Robin Speekenbrink

by Tim de Koning

by Aubrey Hewes

2.4.0

The Requires

The Development Requires

by Robin Speekenbrink

by Tim de Koning

by Aubrey Hewes

2.3.0

The Requires

The Development Requires

by Robin Speekenbrink

by Tim de Koning

by Aubrey Hewes

2.2.1

The Requires

The Development Requires

by Robin Speekenbrink

by Tim de Koning

by Aubrey Hewes