X-Git-Url: http://git.onelab.eu/?a=blobdiff_plain;f=php%2Fphpxmlrpc%2Fsrc%2FResponse.php;h=f814d7bcb59525b0ca28e2a13f04089e43ea68aa;hb=c379c0fff5edc592cc5d5d647c7fadb91317db87;hp=48ebca81fe420347e2893d7f086f82ee6e40aa78;hpb=21d187714285d9818fd94509b015ba069facb7ef;p=plcapi.git diff --git a/php/phpxmlrpc/src/Response.php b/php/phpxmlrpc/src/Response.php index 48ebca8..f814d7b 100644 --- a/php/phpxmlrpc/src/Response.php +++ b/php/phpxmlrpc/src/Response.php @@ -8,32 +8,54 @@ use PhpXmlRpc\Helper\Charset; * This class provides the representation of the response of an XML-RPC server. * Server-side, a server method handler will construct a Response and pass it as its return value. * An identical Response object will be returned by the result of an invocation of the send() method of the Client class. + * + * @property array $hdrs deprecated, use $httpResponse['headers'] + * @property array _cookies deprecated, use $httpResponse['cookies'] + * @property string $raw_data deprecated, use $httpResponse['raw_data'] */ class Response { + protected static $charsetEncoder; + /// @todo: do these need to be public? + /** @internal */ public $val = 0; + /** @internal */ public $valtyp; + /** @internal */ public $errno = 0; + /** @internal */ public $errstr = ''; public $payload; - public $hdrs = array(); - public $_cookies = array(); public $content_type = 'text/xml'; - public $raw_data = ''; + protected $httpResponse = array('headers' => array(), 'cookies' => array(), 'raw_data' => '', 'status_code' => null); + + public function getCharsetEncoder() + { + if (self::$charsetEncoder === null) { + self::$charsetEncoder = Charset::instance(); + } + return self::$charsetEncoder; + } + + public function setCharsetEncoder($charsetEncoder) + { + self::$charsetEncoder = $charsetEncoder; + } /** - * @param mixed $val either a Value object, a php value or the xml serialization of an xmlrpc value (a string) + * @param Value|string|mixed $val either a Value object, a php value or the xml serialization of an xmlrpc value (a string) * @param integer $fCode set it to anything but 0 to create an error response. In that case, $val is discarded * @param string $fString the error string, in case of an error response * @param string $valType The type of $val passed in. Either 'xmlrpcvals', 'phpvals' or 'xml'. Leave empty to let * the code guess the correct type. + * @param array|null $httpResponse * * @todo add check that $val / $fCode / $fString is of correct type??? * NB: as of now we do not do it, since it might be either an xmlrpc value or a plain php val, or a complete * xml chunk, depending on usage of Client::send() inside which creator is called... */ - public function __construct($val, $fCode = 0, $fString = '', $valType = '') + public function __construct($val, $fCode = 0, $fString = '', $valType = '', $httpResponse = null) { if ($fCode != 0) { // error response @@ -56,6 +78,10 @@ class Response $this->valtyp = $valType; } } + + if (is_array($httpResponse)) { + $this->httpResponse = array_merge(array('headers' => array(), 'cookies' => array(), 'raw_data' => '', 'status_code' => null), $httpResponse); + } } /** @@ -98,11 +124,19 @@ class Response * It is up to the user-defined code to decide how to use the received cookies, and whether they have to be sent back * with the next request to the server (using Client::setCookie) or not. * - * @return array array of cookies received from the server + * @return array[] array of cookies received from the server */ public function cookies() { - return $this->_cookies; + return $this->httpResponse['cookies']; + } + + /** + * @return array array with keys 'headers', 'cookies', 'raw_data' and 'status_code' + */ + public function httpResponse() + { + return $this->httpResponse; } /** @@ -127,8 +161,7 @@ class Response $result = "\n"; } if ($this->errno) { - // G. Giunta 2005/2/13: let non-ASCII response messages be tolerated by clients - // by xml-encoding non ascii chars + // Let non-ASCII response messages be tolerated by clients by xml-encoding non ascii chars $result .= "\n" . "\nfaultCode\n" . $this->errno . "\n\n\nfaultString\n" . @@ -141,7 +174,7 @@ class Response $this->val . "\n"; } else { - /// @todo try to build something serializable? + /// @todo try to build something serializable using the Encoder... throw new \Exception('cannot serialize xmlrpc response objects whose content is native php values'); } } else { @@ -155,4 +188,76 @@ class Response return $result; } + + // BC layer + + public function __get($name) + { + //trigger_error('getting property Response::' . $name . ' is deprecated', E_USER_DEPRECATED); + + switch($name) { + case 'hdrs': + return $this->httpResponse['headers']; + case '_cookies': + return $this->httpResponse['cookies']; + case 'raw_data': + return $this->httpResponse['raw_data']; + default: + $trace = debug_backtrace(); + trigger_error('Undefined property via __get(): ' . $name . ' in ' . $trace[0]['file'] . ' on line ' . $trace[0]['line'], E_USER_WARNING); + return null; + } + } + + public function __set($name, $value) + { + //trigger_error('setting property Response::' . $name . ' is deprecated', E_USER_DEPRECATED); + + switch($name) { + case 'hdrs': + $this->httpResponse['headers'] = $value; + break; + case '_cookies': + $this->httpResponse['cookies'] = $value; + break; + case 'raw_data': + $this->httpResponse['raw_data'] = $value; + break; + default: + $trace = debug_backtrace(); + trigger_error('Undefined property via __set(): ' . $name . ' in ' . $trace[0]['file'] . ' on line ' . $trace[0]['line'], E_USER_WARNING); + } + } + + public function __isset($name) + { + switch($name) { + case 'hdrs': + return isset($this->httpResponse['headers']); + case '_cookies': + return isset($this->httpResponse['cookies']); + case 'raw_data': + return isset($this->httpResponse['raw_data']); + default: + return false; + } + } + + public function __unset($name) + { + switch($name) { + case 'hdrs': + unset($this->httpResponse['headers']); + break; + case '_cookies': + unset($this->httpResponse['cookies']); + break; + case 'raw_data': + unset($this->httpResponse['raw_data']); + break; + default: + $trace = debug_backtrace(); + trigger_error('Undefined property via __unset(): ' . $name . ' in ' . $trace[0]['file'] . ' on line ' . $trace[0]['line'], E_USER_WARNING); + } + } }