PHPackages                             peterfox/graphaware-reco-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. peterfox/graphaware-reco-client

AbandonedArchivedLibrary[API Development](/categories/api)

peterfox/graphaware-reco-client
===============================

An API client implemented in PHP to work with GraphAware's Recommendation framework

1.0.0(10y ago)017[1 issues](https://github.com/peterfox/graphaware-reco-client-php/issues)MITPHP

Since Oct 18Pushed 10y ago1 watchersCompare

[ Source](https://github.com/peterfox/graphaware-reco-client-php)[ Packagist](https://packagist.org/packages/peterfox/graphaware-reco-client)[ RSS](/packages/peterfox-graphaware-reco-client/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (7)Versions (2)Used By (0)

GraphAware-Reco client for PHP
------------------------------

[](#graphaware-reco-client-for-php)

The client is designed to work in turning recommendations and scores from a GraphAware Recommendation endpoint into objects that are easy to work with.

The current implementation uses Guzzle but can easily build your own to work with any HTTP client library.

Install
=======

[](#install)

Use composer to get the package

```
composer require peterfox/graphaware-reco-client

```

Basic Setup
===========

[](#basic-setup)

A basic example can use the common implementations of the interfaces set out but it's easy to create your own or extend the common ones to make it work with your own tweaks to the recommendations end point you've created.

```
use GraphAwareReco\Bridge\Guzzle\Client;
use GraphAwareReco\Bridge\Guzzle\RecommendationDescriptionBuilder;
use GraphAwareReco\Domain\Common\RecommendationFactory;
use GraphAwareReco\Domain\Common\RecommendationService;
use GraphAwareReco\Domain\Common\JsonResponseParser;
use GuzzleHttp\Client as Guzzle;
use GuzzleHttp\Command\Guzzle\GuzzleClient;

$service = new RecommendationService('http://localhost:7474/');

$description = RecommendationDescriptionBuilder::getDescriptionFromService($service);

$guzzle = new GuzzleClient(new Guzzle(), $description, ['defaults' => []]);

$client = new Client($guzzle, new RecommendationFactory(), new JsonResponseParser());
```

You can then just supply a parameter array to fetch a set of recommendations

```
$recommendations = $client->getRecommendations(['id' => 1, 'limit' => 30]);
```

Implement your own service
==========================

[](#implement-your-own-service)

You can implement your own setup as needed, the common classes are mainly for examples and because they cover how most developers would set up a recommendation endpoint for their service.

\###Create a recommendation service

The purpose of the RecommendationService interface is to simply state the uri for the endpoint and any arguments that you'll use for to request your recommendations.

```
use GraphAwareReco\Domain\Model\RecommendationService as RecommendationServiceInterface;

class RecommendationService implements RecommendationServiceInterface
{
    /**
     * @var string
     */
    private $baseUrl;

    /**
     * @param string $baseUrl
     */
    public function __construct($baseUrl)
    {
        $this->baseUrl = $baseUrl;
    }

    /**
     * @return string
     */
    public function getBaseUrl()
    {
        return $this->baseUrl;
    }

    /**
     * @return array
     */
    public function getUriParameters()
    {
        return ['id' => 'string'];
    }

    /**
     * @return array
     */
    public function getQueryParameters()
    {
        return ['limit' => 'string'];
    }

    /**
     * @return string
     */
    public function getRecommendationPath()
    {
        return '/graphaware/recommendation/{id}';
    }
}
```

\###Create a response parser

Overall the response parser is simply used as a way of taking the json as an array and breaking it down into an array of recommendations. By default most setups will just be an array of recommendations already so nothing happens in the common example but if you need to change that you can.

```
use GraphAwareReco\Domain\Model\JsonResponseParser as ResponseParserInterface;

class JsonResponseParser implements ResponseParserInterface
{

    /**
     * @param array $result
     * @return array
     */
    public function parse(array $result)
    {
        return $result;
    }
}
```

\###Create a recommendation model

Your models might differ from the common example as each recommendation might provide more details about the nodes it's recommending, as such you can implement your own.

```
use GraphAwareReco\Domain\Model\Recommendation as RecommendationInterface;
use GraphAwareReco\Domain\Model\Score;

class Recommendation implements RecommendationInterface
{
    /**
     * @var
     */
    private $identifier;
    /**
     * @var
     */
    private $uuid;
    /**
     * @var
     */
    private $score;

    public function __construct($identifier, $uuid, $score)
    {
        $this->identifier = $identifier;
        $this->uuid = $uuid;
        $this->score = $score;
    }

    /**
     * @return string
     */
    public function getUUID()
    {
        return $this->uuid;
    }

    /**
     * @return mixed
     */
    public function getItemIdentifier()
    {
        return $this->identifier;
    }

    /**
     * @return Score
     */
    public function getScore()
    {
        $this->score;
    }
}
```

\###Create a recommendation factory

If you have made your own recommendation models you'll need to implement a factory for the client to initiate an instance of it using the date for each recommendation.

```
use GraphAwareReco\Domain\Common\Recommendation as RecommendationImpl;
use GraphAwareReco\Domain\Model\Recommendation;
use GraphAwareReco\Domain\Model\RecommendationFactory as RecommendationFactoryInterface;
use GraphAwareReco\Domain\Model\Score;

class RecommendationFactory implements RecommendationFactoryInterface
{
    /**
     * @param array $data
     * @return Recommendation
     */
    public function getRecommendation(array $data)
    {
        return new RecommendationImpl($data['id'], $data['uuid'], Score::fromArray($data['score']));
    }
}
```

Testing
=======

[](#testing)

There's some basic testing you can run for the library, namely PHPSpec and Behat. To run the behat tests you must also run the tutu server to emulate a GraphAware Reco setup.

\###Run tutu

```
cd tutu && php -S localhost:7474 -t web -d date.timezone=UTC

```

\###Run behat:

```
bin/behat

```

\###Run phpspec:

```
bin/phpspec

```

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

3866d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/15fcbffff7260a7e75c3f8600eb112b9447aaa5926965ba5376881ef50b9ab8b?d=identicon)[peterfox](/maintainers/peterfox)

---

Top Contributors

[![peterfox](https://avatars.githubusercontent.com/u/1716506?v=4)](https://github.com/peterfox "peterfox (1 commits)")

###  Code Quality

TestsBehat

### Embed Badge

![Health badge](/badges/peterfox-graphaware-reco-client/health.svg)

```
[![Health](https://phpackages.com/badges/peterfox-graphaware-reco-client/health.svg)](https://phpackages.com/packages/peterfox-graphaware-reco-client)
```

###  Alternatives

[keen-io/keen-io

A PHP library for reporting events to the Keen IO API

1332.3M7](/packages/keen-io-keen-io)[restcord/restcord

REST Library for the Discord API

177452.4k11](/packages/restcord-restcord)[zfr/zfr-shopify

PHP library for interacting with the Shopify REST API

37198.8k](/packages/zfr-zfr-shopify)[fillup/nexmo

Nexmo API client built with Guzzle Web Service descriptions

2664.6k1](/packages/fillup-nexmo)[apidae-tourisme/apidae-php

Apidae API official PHP Client

373.1k](/packages/apidae-tourisme-apidae-php)

PHPackages © 2026

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