mirror of
https://we.phorge.it/source/phorge.git
synced 2024-11-25 00:02:41 +01:00
84 lines
2.7 KiB
PHP
84 lines
2.7 KiB
PHP
<?php
|
|
|
|
/**
|
|
* @category Services
|
|
* @package Services_Twilio
|
|
* @author Neuman Vong <neuman@twilio.com>
|
|
* @license http://creativecommons.org/licenses/MIT/ MIT
|
|
* @link http://pear.php.net/package/Services_Twilio
|
|
*/
|
|
|
|
/**
|
|
* Abstraction of an instance resource from the Twilio API.
|
|
*/
|
|
abstract class Services_Twilio_InstanceResource extends Services_Twilio_Resource {
|
|
|
|
/**
|
|
* Make a request to the API to update an instance resource
|
|
*
|
|
* :param mixed $params: An array of updates, or a property name
|
|
* :param mixed $value: A value with which to update the resource
|
|
*
|
|
* :rtype: null
|
|
* :throws: a :php:class:`RestException <Services_Twilio_RestException>` if
|
|
* the update fails.
|
|
*/
|
|
public function update($params, $value = null)
|
|
{
|
|
if (!is_array($params)) {
|
|
$params = array($params => $value);
|
|
}
|
|
$decamelizedParams = $this->client->createData($this->uri, $params);
|
|
$this->updateAttributes($decamelizedParams);
|
|
}
|
|
|
|
/*
|
|
* Add all properties from an associative array (the JSON response body) as
|
|
* properties on this instance resource, except the URI
|
|
*
|
|
* :param stdClass $params: An object containing all of the parameters of
|
|
* this instance
|
|
* :return: Nothing, this is purely side effecting
|
|
* :rtype: null
|
|
*/
|
|
public function updateAttributes($params) {
|
|
unset($params->uri);
|
|
foreach ($params as $name => $value) {
|
|
$this->$name = $value;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get the value of a property on this resource.
|
|
*
|
|
* Instead of defining all of the properties of an object directly, we rely
|
|
* on the API to tell us which properties an object has. This method will
|
|
* query the API to retrieve a property for an object, if it is not already
|
|
* set on the object.
|
|
*
|
|
* If the call is to a subresource, eg ``$client->account->messages``, no
|
|
* request is made.
|
|
*
|
|
* To help with lazy HTTP requests, we don't actually retrieve an object
|
|
* from the API unless you really need it. Hence, this function may make API
|
|
* requests even if the property you're requesting isn't available on the
|
|
* resource.
|
|
*
|
|
* :param string $key: The property name
|
|
*
|
|
* :return mixed: Could be anything.
|
|
* :throws: a :php:class:`RestException <Services_Twilio_RestException>` if
|
|
* the update fails.
|
|
*/
|
|
public function __get($key)
|
|
{
|
|
if ($subresource = $this->getSubresources($key)) {
|
|
return $subresource;
|
|
}
|
|
if (!isset($this->$key)) {
|
|
$params = $this->client->retrieveData($this->uri);
|
|
$this->updateAttributes($params);
|
|
}
|
|
return $this->$key;
|
|
}
|
|
}
|