gorse/php-gorse

PHP SDK for Gorse recommender system

v0.5.0 2025-11-27 14:54 UTC

Requires

• guzzlehttp/guzzle: ^7.0

Requires (Dev)

• phpunit/phpunit: ^9.3

Apache 2

• zhenghaoz

README

PHP SDK for Gorse recommender system.

Install

Install via composer:

composer require gorse/php-gorse

Usage

Create a Gorse client:

$client = new Gorse("http://127.0.0.1:8088/", "api_key");

Insert users:

$user = new User("100", ["gender" => "M", "age" => "25"], "my_comment");
$rowsAffected = $client->insertUser($user);

Insert items:

$item = new Item(
    "2000", 
    true, 
    ["embedding" => [0.1, 0.2, 0.3]], 
    ["Comedy", "Animation"], 
    "2022-11-20T13:55:27Z", 
    "Minions (2015)"
);
$rowsAffected = $client->insertItem($item);

Insert feedback:

$feedback = [
    new Feedback("read", "100", "2000", 1.0, "2022-11-20T13:55:27Z"),
    new Feedback("read", "100", "2001", 1.0, "2022-11-20T13:55:27Z"),
];
$rowsAffected = $client->insertFeedback($feedback);

Get recommendations:

$items = $client->getRecommend('100', 10);