commit	f1e33f3ada31b585fddcc7dbfb9f09ef5fb13259	[log] [tgz]
author	Donald Szeto <donald@apache.org>	Thu Sep 13 11:19:54 2018 -0700
committer	Donald Szeto <donald@apache.org>	Thu Sep 13 11:19:54 2018 -0700
tree	ce01f839fbcfc82cff8e1f4676872262cd3351b8
parent	2b99dcc007cd2e457de872942575e40ca763fbd6 [diff]

tree: ce01f839fbcfc82cff8e1f4676872262cd3351b8

README.md

Apache PredictionIO PHP SDK

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.

Getting Started

The easiest way to install PredictionIO PHP client is to use Composer.

predictionio is available on Packagist and can be installed using Composer:
```
 composer require predictionio/predictionio
```
Include Composer's autoloader in your PHP code
```
 require_once("vendor/autoload.php");
```

Usage

This package is a web service client based on Guzzle. A few quick examples are shown below.

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.

Community

Keep track of development and community news.

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

Contributing

Read the Contribute Code page.

License

Apache PredictionIO is under Apache 2 license.