Php-rpc
===============

Small library to provide remote proceedure calls in PHP over System V on Linux.

### Installation
--------

Currently the project contains only one file. Simply add sysVcom.php to your project. Other files are for testing.
The global files need to be set correctly for your project. In particular, a file needs to be created which is
used as the buffer for the SysV system. In practice this is just used as a unique key but it must exist and be
reachable by both client and server.

The following methods are use to invoke an RPC
<pre>
	rpc( $funcName, ...$params );
	rpc_listen( &$caller_id, &$msgArr, $bBlock = true );
	rpc_reply( $caller_id, $obj );
</pre>


##### rpc( $funcName, ...$params )
--------

Invoke a remote proceedure call. All parameters are serialized and sent to
the server. The call blocks until the results are returned.
	
	
##### rpc_listen( &$caller_id, &$msgArr, $bBlock = true )
--------

The server must periodically call rpc_listen(). This call will populate the
array &msgArr and $caller_id according to what message has been retrieved from
the queue. The array &msgArr might contain other client messages which have only partially been
recieved. The array must be used on subsequent calls to rpc_listen if it is not empty.

The unserialized object is returned.


##### rpc_reply( $caller_id, $obj )
--------

This call must be invoked after the rpc instructions have been completed by the server. It is up to the
server implementation whether or not these calls invoke a 'real' PHP function or something else. The call
must pass back the results of the RPC in $obj. These will be serialized to back to the client. Note that
the client is blocking on this call.