Download the PHP package dominionenterprises/tol-api without Composer

tol-api-php

This is a PHP client for REST APIs like the TraderOnline APIs.

Requirements

This api client requires PHP 7.3 or newer and uses composer to install further PHP dependencies. See the composer specification for more details.

When contributing, access to a working mongo database for testing is needed. See the Contribution Guidelines for more details.

Installation

tol-api-php can be installed for use in your project using composer.

The recommended way of using this library in your project is to add a composer.json file to your project. The following contents would add tol-api-php as a dependency:

Basic Usage

The basic guzzle client, without caching or automated pagination handling is mostly easy to work with.

To instantiate a client, you need the guzzle adapter, client id, client secret, and API url. This client should work with apis like the TOL APIs.

Then you can make index requests like below, although it is recommended to take a look at the Collection section below so that you can take advantage of automatic pagination handling. Here's an example of how to fetch a single page of items.

For getting just a single item back from the api, you can use the get method:

For creating a new item, you can use the post method:

For updating an item, you can use the put method:

For deleting an item, you can use the delete method:

For making asynchronous requests use the start*() and end() methods:

Cache

The library allows for a PSR-16 SimpleCache implementation.

Collection

This is the preferred way to make index requests so that you don't have to handle (or forget to handle!) pagination yourself. Using this iterator is simple with the API Client. As an example, here is a snippet of code that will create a dropdown list of items. WARNING Updates should not be performed to the items in the collection while interating as this may change the pagination.

Contributing

If you would like to contribute, please use our build process for any changes and after the build passes, send us a pull request on github!

There is also a docker-based fig configuration that will standup docker containers for the databases, execute the build inside a docker container, and then terminate everything. This is an easy way to build the application: