README

A simple wrapper for the Petfinder API, written in PHP.

Uses Petfinder API v2.

Features

• Uses HTTPlug
• Supports Async requests
• Well tested

Requirements

• PHP >= 7.1
• A HTTPlug Async client
• A PSR-7 implementation

Install

In addition to the Petfinder package, you'll need an HTTPlug client that support async requests. We recommend using php-http/guzzle6-adapter, but you are free to use whatever one works for you.

composer require petfinder-com/petfinder-php php-http/guzzle6-adapter

Usage

Basic usage

$client = new \Petfinder\Client('my-api-key', 'my-api-secret');

$client->animal->search(['type' => 'Dog']);

Using async requests

$client = new \Petfinder\Client('my-api-key', 'my-api-secret');

$client->organization->searchAsync()->then(function (\Petfinder\Result $result) {
    // Do something with $result
})->catch(function (\Petfinder\Exception\ProblemDetailsException $exception) {
    // Do something with $exception
});

Using a custom Httplug client

$builder = new \Petfinder\Http\Builder($myHttpClient);
$client = new \Petfinder\Client('my-api-key', 'my-api-secret', $builder);