PHPackages                             openx/ox3-php-api-client - 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. openx/ox3-php-api-client

ActivePackage[API Development](/categories/api)

openx/ox3-php-api-client
========================

OpenX Platform API PHP CLIENT

1.0.0(4y ago)13149[2 issues](https://github.com/openx/OX3-PHP-API-Client/issues)PHP

Since Oct 16Pushed 2mo ago17 watchersCompare

[ Source](https://github.com/openx/OX3-PHP-API-Client)[ Packagist](https://packagist.org/packages/openx/ox3-php-api-client)[ RSS](/packages/openx-ox3-php-api-client/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

ox3-php-api-client
==================

[](#ox3-php-api-client)

This library provides a client class with examples to facilitate access to the OpenX API. It handles, most of all, the OAuth1 login process used by OpenX API, and some basic path operations.

In `src\OpenX\PlatformAPI` directory,

- `OXApiClient.php` (using patched Zend2) is the one supported by composer and autoloader, a fully namespaced client to be used in PHP7+

and if you need an older approach and want to use/copy just the file...

- `OX3_Api_Client.php` supports Zend Framework Version 1
- `OX3ApiClient2.php` supports Zend Framework Version 2

Help appreciated
----------------

[](#help-appreciated)

As we do not actively maintain PHP projects, any help in straightening up the package and readme will be appreciated.

What might need a review:

- better or less mixed install instructions
- let us know if you need modern (composer, namespaces) or old (dirty file copying, old PHP) setup support
- the `/3.0/` paths of the API are obsolete and not supported anymore, we can clean them up from the code
- make the package independent from frameworks
    - especially ones that are obsolete (Zend)

We'd like to thank:

- Fei Song for a push towards making this a proper composer package.

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

[](#installation)

**(recommended) if working with Composer and Zend2**

- See the example `Dockerfile` for inspiration
- You should only need to add `openx/ox3-php-api-client` as dependency
- Then you can use the class `OpenX\PlatformAPI\OXApiClient` in your project.

### Try it out in the docker image

[](#try-it-out-in-the-docker-image)

- `docker build . -t openx-test`
- `docker run -it openx-test bash`
    - `export OPENX_URI=http://your-ui.openx.net`
    - `export OPENX_EMAIL=john.doe@company.com`
    - `export OPENX_PASWORD="My password satisfies the sane requirements for a long p@assword!"`
    - `export OPENX_KEY=c0n5um3rK3y`
    - `export OPENX_SECRET=c0n5um3rS3cR3T`
    - `export OPENX_REALM="your_realm" # (usually same as hostname prefix)`
    - `php example.php`

Older install instructions, to be reviewed:
-------------------------------------------

[](#older-install-instructions-to-be-reviewed)

**If Working with Zend Framework 1:**

1. Install Zend Framework 1.12.13 (link: ).
2. Set include\_path:

- Method 1: Navigate to /private/etc/php.ini and set include\_path to the path to the Zend Framework under the "/library" directory.

```
include_path = ".:/Users/.../ZendFramework-1.12.13/library/"

```

- Method 2: Alternatively, you can create a file called 'set\_path.php' and set your paths there. If you chose to set the path using this option, the file 'set\_path.php' should look like:

```

```

\*\* If you use this option make sure to create the file in the same folder as the folder which contains the OX3\_API\_Client.php file. Also make sure to require the file by adding the line "require\_once 'set\_path.php'; " to the top of the OX3\_Api\_Client.php file.

**If Working with Zend Framework 2:**

1. Install Zend Framework 2 (link: ).
2. Install Composer in your working directory (link: ).
3. Run the command "php composer.phar init". After doing this. composer will guide you through the process of configuring a composer.json file. To allow the default configuration, press enter or "yes" when prompted.
4. Install the required Zend packages, ZendOAuth and ZendRest:
    To do so, add the "repositories" and "require" sections in the composer.json file so the file looks
    as follows:

```
{
  "name": "",
  "authors": [
    {
      "name": "",
      "email": ""
    }
  ],
  "repositories": [
    {
      "type": "composer",
      "url": "https://packages.zendframework.com/"
    }
  ],
  "require": {
    "zendframework/zendoauth": "2.0.*",
    "zendframework/zendrest": "2.0.*"
  }
}
```

5. Run the command "php composer.phar install" to install the packages and their dependencies.
6. Set include\_path:

- Method 1: Navigate to /private/etc/php.ini and set include\_path to the paths to the Zend Framework under the ".../library/" directory and to the newly installed packages under the ".../vendor/" directory. The "vendor" folder should appear in your working directory after installing the packages with composer.

```
include_path = ".:/Users/.../ZendFramework-2.4.5/library/:/Users/.../vendor/"
```

- Method 2: Alternatively, you can create a file called 'set\_path.php' and set your paths there. If you chose to set the path using this option, the file set\_path.php should look like:

```

```

\*\* If you use this option make sure to create the file in the same folder as the folder which contains the OX3\_API\_Client2.php file. Also make sure to require the file by adding the line "require\_once 'set\_path.php'; " to the top of the OX3\_Api\_Client2.php file.

\#Authentication/Example Scripts
Add this to your code to authenticate with Oauth:

```

```

\*\* Note that when running the example scripts, OX3\_Api\_Client.php/OX3\_Api\_Client2.php must be in the same folder as the script. Also note that the example scripts contain some user configurable variables (besides the authentication section), which are described at the top of the scripts.

\#Usage

- To see the results in a friendly format on the command line, use the functions json\_decode, getBody, and print\_r. Ex.:

    ```
    $result = $client->get('/account');
    print_r(json_decode($result->getBody(), true));

    ```

**GET REQUESTS:**

- To get all current objects of a certain type, use the following request:

```
$result = $client->get('/"object_type"');
// Example:
$result = $client->get('/account');

```

- To get the object(s) with a specific value for some attribute(s), pass in the value of the desired attribute as an array along with the path:

```
$query = array("attribute"=>"value");
$result = $client->get('/object_type', $query)
// Example:
$query1 = array('name'=>'OpenX');
result1 = $client->get('/account', $query1);
// --> Returns the account(s) with the name OpenX

```

- Many fields have multiple options for what value they can take on. To see these options, use the following request:

```
$result = $client->get('/options/:field_options')
// Example:
$content_types = $client->get('/options/content_type_options');

```

**POST REQUESTS:**

- To create an object, make a post request, passing in the path along with an array which includes the values of the fields for the object

```
$query = array(
'account_uid'=>"...",
'currency'=>"...",
.
.
.
'timezone'=>"...");
$result = $client->post('/:object_type/', $query);

```

**PUT REQUESTS:**

- To update an object, make a put resquest, passing in the path along with an array which includes the parameters that are being updated

```
$query = array('timezone'=>'updated_value');
$result = $client->put('/:object_type/:object_uid', $query);

```

**DELETE REQUESTS:**

- To delete an object, make a delete request, passing in the path including the uids/id of the object that is to be deleted:

```
$result = $client->delete('/:object_type/:object_uid');
// Example:
$result = $client->delete('/site/6003a1c2-e000-fff1-8123-0c9a66');

```

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance53

Moderate activity, may be stable

Popularity16

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1675d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/412044?v=4)[Roger](/maintainers/ikari)[@Ikari](https://github.com/Ikari)

![](https://avatars.githubusercontent.com/u/161648?v=4)[OpenX](/maintainers/OpenX)[@openx](https://github.com/openx)

---

Top Contributors

[![chriscrichton](https://avatars.githubusercontent.com/u/896361?v=4)](https://github.com/chriscrichton "chriscrichton (7 commits)")[![ikari-pl](https://avatars.githubusercontent.com/u/811702?v=4)](https://github.com/ikari-pl "ikari-pl (6 commits)")[![wing-lok-lam](https://avatars.githubusercontent.com/u/48365014?v=4)](https://github.com/wing-lok-lam "wing-lok-lam (2 commits)")[![jagriti-agrawal](https://avatars.githubusercontent.com/u/13735011?v=4)](https://github.com/jagriti-agrawal "jagriti-agrawal (2 commits)")[![laurb9](https://avatars.githubusercontent.com/u/5796634?v=4)](https://github.com/laurb9 "laurb9 (2 commits)")[![openx-rj](https://avatars.githubusercontent.com/u/47584663?v=4)](https://github.com/openx-rj "openx-rj (2 commits)")[![kesar](https://avatars.githubusercontent.com/u/1288106?v=4)](https://github.com/kesar "kesar (1 commits)")

### Embed Badge

![Health badge](/badges/openx-ox3-php-api-client/health.svg)

```
[![Health](https://phpackages.com/badges/openx-ox3-php-api-client/health.svg)](https://phpackages.com/packages/openx-ox3-php-api-client)
```

###  Alternatives

[jacobsteringa/odoo-client

A PHP Client for Odoo

1324.1k](/packages/jacobsteringa-odoo-client)[zfr/zfr-prerender

Integration with prerender.io service

218.0k](/packages/zfr-zfr-prerender)[fourmation/rest-remote-object

This library provide a REST adapter for the Remote Object pattern implemented by the ProxyManager project.

175.6k1](/packages/fourmation-rest-remote-object)

PHPackages © 2026

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