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 it to your project.

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.