PHPackages                             evance/apiclient - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. evance/apiclient

ActiveLibrary[API Development](/categories/api)

evance/apiclient
================

Client library for Evance APIs

133PHPCI failing

Since Jun 3Pushed 7mo ago5 watchersCompare

[ Source](https://github.com/evanceit/evance-api-php-client)[ Packagist](https://packagist.org/packages/evance/apiclient)[ RSS](/packages/evance-apiclient/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependenciesVersions (2)Used By (0)

Evance APIs Client Library for PHP
==================================

[](#evance-apis-client-library-for-php)

A PHP client library for accessing Evance APIs

Work in progress!
-----------------

[](#work-in-progress)

This library is currently a work in progress. It is therefore subject to dramatic changes.

Requirements
------------

[](#requirements)

PHP 5.6 or higher

Installation
------------

[](#installation)

You can use **Composer** (our preferred method) or download the source.

### Composer

[](#composer)

Once you have [installed composer](https://getcomposer.org), execute the following command in your project root to install this library:

```
composer require evance/apiclient
```

You should ensure you have included the autoloader for your project:

```
require_once '/path/to/your-project/vendor/autoload.php';
```

### Download

[](#download)

At the moment we do not have a release complete with its dependencies - it'll be coming soon.

Examples
--------

[](#examples)

### Authentication with OAuth 2.0

[](#authentication-with-oauth-20)

This method is for Web Clients requiring user authorisation. Follow the steps below to obtain an access token from Evance.

1. Create your App and credentials.
2. Download the JSON credentials and save them into a configuration directory within you project.
3. Set the path to your credentials as below:

    ```
    use Evance\ApiClient;
    $client = new ApiClient();
    $client->loadAuthConfig('/path/to/client-credentials.json');
    ```
4. Set the scopes required for the API you are going to call.

    ```
    $client->addScope('shipping');
    ```
5. Set your application's redirect URI. The redirect URI must match the authorised redirect URI you set when creating your client credentials.

    ```
    $client->setRedirectUri('https://example.com/callback');
    ```
6. Set a use-once state number. This number will be returned to your callback page so that you may confirm you sent the original request. Therefore, you will need to ensure you can persist the number to the callback page. This may done, for example, within a session variable.

    ```
    $client->setState($nonce);
    ```
7. Get the Evance OAuth 2.0 URL for a user to authorise access. You can either use this URL in redirect or provide a link for the user to click.

    ```
    $url = $client->createAuthorizeUrl();
    ```
8. In the callback script (your redirect URI), you will need to exchange the authorisation code for an access token. You should also verify that **state** is as expected.

    ```
    $token = $client->authenticate($_GET);
    ```

### Authenticating Server-to-server clients

[](#authenticating-server-to-server-clients)

This method is for obtaining single use access tokens. Unlike Web Clients a Server Key does not have a refresh token so a new access token must be obtained every time a token expires.

1. Create your App and credentials.
2. Download the JSON credentials and save them into a configuration directory within you project.
3. Set the path to your credentials as below:

    ```
    use Evance\ApiClient;
    $client = new ApiClient();
    $client->loadAuthConfig('/path/to/server-credentials.json');
    ```
4. Optionally, you may set the scope you wish to grant the access token. Omitting this step will grant the access token full access to the scopes granted to your App.

    ```
    $client->addScope('shipping');
    ```
5. Now you can obtain the access token from Evance.

    ```
    $token = $client->fetchAccessTokenWithJwt();
    ```

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance45

Moderate activity, may be stable

Popularity9

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity20

Early-stage or recently created project

 Bus Factor1

Top contributor holds 52.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/f2d5ad5c6ef013ed21fe63a1db1ceb34fa9cf198d6c2db09eda8fbd48c430bfc?d=identicon)[gwillings](/maintainers/gwillings)

---

Top Contributors

[![gwillings](https://avatars.githubusercontent.com/u/4246446?v=4)](https://github.com/gwillings "gwillings (23 commits)")[![Andrew-Matthew](https://avatars.githubusercontent.com/u/8606482?v=4)](https://github.com/Andrew-Matthew "Andrew-Matthew (10 commits)")[![mnunn2](https://avatars.githubusercontent.com/u/5892628?v=4)](https://github.com/mnunn2 "mnunn2 (5 commits)")[![kaitoj](https://avatars.githubusercontent.com/u/66623523?v=4)](https://github.com/kaitoj "kaitoj (3 commits)")[![radualexandru1986](https://avatars.githubusercontent.com/u/20443044?v=4)](https://github.com/radualexandru1986 "radualexandru1986 (2 commits)")[![matKamil](https://avatars.githubusercontent.com/u/32133773?v=4)](https://github.com/matKamil "matKamil (1 commits)")

### Embed Badge

![Health badge](/badges/evance-apiclient/health.svg)

```
[![Health](https://phpackages.com/badges/evance-apiclient/health.svg)](https://phpackages.com/packages/evance-apiclient)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M454](/packages/google-gax)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)