2013-07-28 21:44:51 +02:00
|
|
|
<?php
|
|
|
|
|
|
|
|
namespace JsonRPC;
|
|
|
|
|
2014-09-19 18:54:48 +02:00
|
|
|
use BadFunctionCallException;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* JsonRPC client class
|
|
|
|
*
|
|
|
|
* @package JsonRPC
|
|
|
|
* @author Frederic Guillot
|
|
|
|
* @license Unlicense http://unlicense.org/
|
|
|
|
*/
|
2013-07-28 21:44:51 +02:00
|
|
|
class Client
|
|
|
|
{
|
2014-09-19 18:54:48 +02:00
|
|
|
/**
|
|
|
|
* URL of the server
|
|
|
|
*
|
|
|
|
* @access private
|
|
|
|
* @var string
|
|
|
|
*/
|
2013-07-28 21:44:51 +02:00
|
|
|
private $url;
|
2014-09-19 18:54:48 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* HTTP client timeout
|
|
|
|
*
|
|
|
|
* @access private
|
|
|
|
* @var integer
|
|
|
|
*/
|
2013-07-28 21:44:51 +02:00
|
|
|
private $timeout;
|
2014-09-19 18:54:48 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Username for authentication
|
|
|
|
*
|
|
|
|
* @access private
|
|
|
|
* @var string
|
|
|
|
*/
|
2013-07-28 21:44:51 +02:00
|
|
|
private $username;
|
2014-09-19 18:54:48 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Password for authentication
|
|
|
|
*
|
|
|
|
* @access private
|
|
|
|
* @var string
|
|
|
|
*/
|
2013-07-28 21:44:51 +02:00
|
|
|
private $password;
|
|
|
|
|
2014-09-19 18:54:48 +02:00
|
|
|
/**
|
|
|
|
* Enable debug output to the php error log
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @var boolean
|
|
|
|
*/
|
|
|
|
public $debug = false;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Default HTTP headers to send to the server
|
|
|
|
*
|
|
|
|
* @access private
|
|
|
|
* @var array
|
|
|
|
*/
|
2013-07-28 21:44:51 +02:00
|
|
|
private $headers = array(
|
|
|
|
'Connection: close',
|
|
|
|
'Content-Type: application/json',
|
|
|
|
'Accept: application/json'
|
|
|
|
);
|
|
|
|
|
2014-09-19 18:54:48 +02:00
|
|
|
/**
|
|
|
|
* Constructor
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @param string $url Server URL
|
|
|
|
* @param integer $timeout Server URL
|
|
|
|
* @param array $headers Custom HTTP headers
|
|
|
|
*/
|
|
|
|
public function __construct($url, $timeout = 5, $headers = array())
|
2013-07-28 21:44:51 +02:00
|
|
|
{
|
|
|
|
$this->url = $url;
|
|
|
|
$this->timeout = $timeout;
|
|
|
|
$this->headers = array_merge($this->headers, $headers);
|
|
|
|
}
|
|
|
|
|
2014-09-19 18:54:48 +02:00
|
|
|
/**
|
|
|
|
* Automatic mapping of procedures
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @param string $method Procedure name
|
|
|
|
* @param array $params Procedure arguments
|
|
|
|
* @return mixed
|
|
|
|
*/
|
2014-02-08 20:13:14 +01:00
|
|
|
public function __call($method, $params)
|
|
|
|
{
|
|
|
|
return $this->execute($method, $params);
|
|
|
|
}
|
2014-09-19 18:54:48 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Set authentication parameters
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @param string $username Username
|
|
|
|
* @param string $password Password
|
|
|
|
*/
|
2013-07-28 21:44:51 +02:00
|
|
|
public function authentication($username, $password)
|
|
|
|
{
|
|
|
|
$this->username = $username;
|
|
|
|
$this->password = $password;
|
|
|
|
}
|
|
|
|
|
2014-09-19 18:54:48 +02:00
|
|
|
/**
|
|
|
|
* Execute
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @throws BadFunctionCallException Exception thrown when a bad request is made (missing argument/procedure)
|
|
|
|
* @param string $procedure Procedure name
|
|
|
|
* @param array $params Procedure arguments
|
|
|
|
* @return mixed
|
|
|
|
*/
|
2013-07-28 21:44:51 +02:00
|
|
|
public function execute($procedure, array $params = array())
|
|
|
|
{
|
|
|
|
$id = mt_rand();
|
|
|
|
|
|
|
|
$payload = array(
|
|
|
|
'jsonrpc' => '2.0',
|
|
|
|
'method' => $procedure,
|
|
|
|
'id' => $id
|
|
|
|
);
|
|
|
|
|
|
|
|
if (! empty($params)) {
|
|
|
|
$payload['params'] = $params;
|
|
|
|
}
|
|
|
|
|
|
|
|
$result = $this->doRequest($payload);
|
|
|
|
|
|
|
|
if (isset($result['id']) && $result['id'] == $id && array_key_exists('result', $result)) {
|
|
|
|
return $result['result'];
|
|
|
|
}
|
|
|
|
|
2014-09-19 18:54:48 +02:00
|
|
|
throw new BadFunctionCallException('Bad Request');
|
2013-07-28 21:44:51 +02:00
|
|
|
}
|
|
|
|
|
2014-09-19 18:54:48 +02:00
|
|
|
/**
|
|
|
|
* Do the HTTP request
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @param string $payload Data to send
|
|
|
|
*/
|
2013-07-28 21:44:51 +02:00
|
|
|
public function doRequest($payload)
|
|
|
|
{
|
|
|
|
$ch = curl_init();
|
|
|
|
|
|
|
|
curl_setopt($ch, CURLOPT_URL, $this->url);
|
|
|
|
curl_setopt($ch, CURLOPT_HEADER, false);
|
|
|
|
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
|
|
|
|
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, $this->timeout);
|
|
|
|
curl_setopt($ch, CURLOPT_USERAGENT, 'JSON-RPC PHP Client');
|
|
|
|
curl_setopt($ch, CURLOPT_HTTPHEADER, $this->headers);
|
|
|
|
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, false);
|
|
|
|
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
|
|
|
|
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
|
|
|
|
|
|
|
|
if ($this->username && $this->password) {
|
|
|
|
curl_setopt($ch, CURLOPT_USERPWD, $this->username.':'.$this->password);
|
|
|
|
}
|
|
|
|
|
|
|
|
$result = curl_exec($ch);
|
|
|
|
$response = json_decode($result, true);
|
|
|
|
|
2014-09-19 18:54:48 +02:00
|
|
|
if ($this->debug) {
|
|
|
|
error_log('==> Request: '.PHP_EOL.json_encode($payload, JSON_PRETTY_PRINT));
|
|
|
|
error_log('==> Response: '.PHP_EOL.json_encode($response, JSON_PRETTY_PRINT));
|
|
|
|
}
|
|
|
|
|
2013-07-28 21:44:51 +02:00
|
|
|
curl_close($ch);
|
|
|
|
|
|
|
|
return is_array($response) ? $response : array();
|
|
|
|
}
|
|
|
|
}
|