README

php5 client for Rserve http://www.rforge.net/Rserve/ (a TCP/IP server for R statistical software)

Changes from 1.0 version

• All classes are declared under Sentiweb\Rserve namespace allowing PSR-4 autoloading
• Parsers are now individualized into classes
• A Parser instance can be directly used as second argument of evalString() to replace default parser (see example)

Tests

You can run tests using phpunit

• Create a file config.php in the "tests" directory (copy config.php.sample)
• define the constant RSERVE_HOST with the address of your Rserve server (custom port not supported yet)
• run tests . phpunit --bootstrap=src/autoload.php tests/ParserNativeTest.php . phpunit tests\SessionTest.php . phpunit tests\REXPTest.php
• define the constants RSERVE_PORT, RSERVE_USER, RSERVE_PASS to config.php (along with RSERVE_HOST)
• run test . phpunit tests\LoginTest.php

Installation

Using without composer : include src/autoload.php in your project

Using with composer: composer require cturbelin/rserve-php

Some usage examples are provided in example/ directory

Using Login Authorization

Usage is the same as the vanilla usage, except for the constructor $cnx = new Connection('myserverhost', serverport, array('username'=>username,'password'=>password))

Parsers

Results provided by R could be handled using several parsers

• NativeArray Translates R structure into php simple arrays. It is useful to get simple values from R

• Wrapped array Using NativeArray with parameter ["wrapper"=>true] in contructor returns object with attributes of R objects. The result object can be used as an array and provides methods to access R object attributes

• Debug Translates R response to structure useful for debugging

• REXP Translates R response into REXP classes

Async Mode

Several functions allow to use connection in async mode

• getSocket() to get the socket an set some options
• setAsync() allow to set the async mode
• getResults($parser) : get and parse the results after a call to evalString() in async mode

Contacts

Clément Turbelin, clement.turbelin@gmail.com http://www.sentiweb.fr Université Pierre et Marie Curie - Paris 6, France