ghola/rserve-php

Rserve client library for PHP

Rserve-php

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

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, _(*2)

• 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, _(*3)

Using with composer: composer require cturbelin/rserve-php, _(*4)

Some usage examples are provided in example/ directory, _(*5)

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)), _(*6)

Parsers

Results provided by R could be handled using several parsers, _(*7)

• NativeArray Translates R structure into php simple arrays. It is useful to get simple values from R, _(*8)

• 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, _(*9)

• Debug Translates R response to structure useful for debugging, _(*10)

• REXP Translates R response into REXP classes, _(*11)

Async Mode

Several functions allow to use connection in async mode, _(*12)

• 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, _(*13)