predictionio/predictionio

Apache PredictionIO API PHP Client

Apache PredictionIO PHP SDK

, _(*1)

Prerequisites

• PHP 5.6+ (http://php.net/)
• PHP: cURL (http://php.net/manual/en/book.curl.php)
• Phing (http://www.phing.info/)
• ApiGen (http://apigen.org/)

Note: This SDK only supports Apache PredictionIO version 0.8.2 or higher., _(*2)

Getting Started

The easiest way to install PredictionIO PHP client is to use Composer., _(*3)

1. predictionio is available on Packagist and can be installed using Composer:, _(*4)

   composer require predictionio/predictionio

2. Include Composer's autoloader in your PHP code, _(*5)

   require_once("vendor/autoload.php");

Usage

This package is a web service client based on Guzzle. A few quick examples are shown below., _(*6)

Instantiate PredictionIO API Event Client

use predictionio\EventClient;
$accessKey = 'j4jIdbq59JsF2f4CXwwkIiVHNFnyNvWXqMqXxcIbQDqFRz5K0fe9e3QfqjKwvW3O';
$client = new EventClient($accessKey, 'http://localhost:7070');

Set a User Record from Your App

// assume you have a user with user ID 5
$response = $client->setUser(5);

Set an Item Record from Your App

// assume you have a book with ID 'bookId1' and we assign 1 as the type ID for book
$response = $client->setItem('bookId1', array('itypes' => 1));

Import a User Action (View) form Your App

// assume this user has viewed this book item
$client->recordUserActionOnItem('view', 5, 'bookId1');

Retrieving Prediction Result

// assume you have created an itemrank engine on localhost:8000
// we try to get ranking of 5 items (item IDs: 1, 2, 3, 4, 5) for a user (user ID 7)

$engineClient = new EngineClient('http://localhost:8000');
$response = $engineClient->sendQuery(array('uid'=>7, 'iids'=>array(1,2,3,4,5)));

print_r($response);

Bugs and Feature Requests

Use Apache JIRA to report bugs or request new features., _(*7)

Community

Keep track of development and community news., _(*8)

• Subscribe to the user mailing list and the dev mailing list.
• Follow @PredictionIO on Twitter.

Contributing

Read the Contribute Code page., _(*9)

License

Apache PredictionIO is under Apache 2 license., _(*10)