Octobat PHP Library

2.4.0 2021-05-06 15:34 UTC

This package is auto-updated.

Last update: 2024-04-06 21:42:32 UTC


You can sign up for an Octobat account at https://www.octobat.com.


PHP 5.4.0 and later.


You can install the bindings via Composer. Run the following command:

composer require 0ctobat/octobat-php

To use the bindings, use Composer's autoload:


Manual Installation

If you do not wish to use Composer, you can download the latest release. Then, to use the bindings, include the init.php file.



The bindings require the following extensions in order to work properly:

  • curl, although you can use your own non-cURL client if you prefer
  • json
  • mbstring (Multibyte String)

If you use Composer, these dependencies should be handled automatically. If you install manually, you'll want to make sure that these extensions are available.

Getting Started

Simple usage looks like:

$customer = \Octobat\Customer::create(['email' => "john.doe@gmail.com", 'name' => 'John Doe', 'billing_address_country' => 'FR']);
echo $customer;


Please see http://v2apidoc.octobat.com/ for up-to-date documentation.

Configuring a Logger

The library does minimal logging, but it can be configured with a [PSR-3 compatible logger][psr3] so that messages end up there instead of error_log:


Per-request Configuration

For apps that need to use multiple keys during the lifetime of a process, it's also possible to set a per-request key and/or account:

\Octobat\Customer::all([], [
    'api_key' => 'oc_test_skey...'

\Octobat\Customer::retrieve("oc_cu_xxxxxxxx", [
    'api_key' => 'oc_test_skey...'