mirror of
https://we.phorge.it/source/phorge.git
synced 2024-12-05 05:02:44 +01:00
643c1c4a52
Summary: Ref T2787. This brings us up to date. Test Plan: `git clone` Reviewers: btrahan, chad Reviewed By: chad Subscribers: epriestley Maniphest Tasks: T2787 Differential Revision: https://secure.phabricator.com/D9916
264 lines
7 KiB
PHP
264 lines
7 KiB
PHP
<?php
|
|
|
|
class Stripe_Object implements ArrayAccess
|
|
{
|
|
/**
|
|
* @var Stripe_Util_Set Attributes that should not be sent to the API because
|
|
* they're not updatable (e.g. API key, ID).
|
|
*/
|
|
public static $permanentAttributes;
|
|
/**
|
|
* @var Stripe_Util_Set Attributes that are nested but still updatable from
|
|
* the parent class's URL (e.g. metadata).
|
|
*/
|
|
public static $nestedUpdatableAttributes;
|
|
|
|
public static function init()
|
|
{
|
|
self::$permanentAttributes = new Stripe_Util_Set(array('_apiKey', 'id'));
|
|
self::$nestedUpdatableAttributes = new Stripe_Util_Set(array('metadata'));
|
|
}
|
|
|
|
protected $_apiKey;
|
|
protected $_values;
|
|
protected $_unsavedValues;
|
|
protected $_transientValues;
|
|
protected $_retrieveOptions;
|
|
|
|
public function __construct($id=null, $apiKey=null)
|
|
{
|
|
$this->_apiKey = $apiKey;
|
|
$this->_values = array();
|
|
$this->_unsavedValues = new Stripe_Util_Set();
|
|
$this->_transientValues = new Stripe_Util_Set();
|
|
|
|
$this->_retrieveOptions = array();
|
|
if (is_array($id)) {
|
|
foreach ($id as $key => $value) {
|
|
if ($key != 'id') {
|
|
$this->_retrieveOptions[$key] = $value;
|
|
}
|
|
}
|
|
$id = $id['id'];
|
|
}
|
|
|
|
if ($id !== null) {
|
|
$this->id = $id;
|
|
}
|
|
}
|
|
|
|
// Standard accessor magic methods
|
|
public function __set($k, $v)
|
|
{
|
|
if ($v === "") {
|
|
throw new InvalidArgumentException(
|
|
'You cannot set \''.$k.'\'to an empty string. '
|
|
.'We interpret empty strings as NULL in requests. '
|
|
.'You may set obj->'.$k.' = NULL to delete the property'
|
|
);
|
|
}
|
|
|
|
if (self::$nestedUpdatableAttributes->includes($k)
|
|
&& isset($this->$k) && is_array($v)) {
|
|
$this->$k->replaceWith($v);
|
|
} else {
|
|
// TODO: may want to clear from $_transientValues (Won't be user-visible).
|
|
$this->_values[$k] = $v;
|
|
}
|
|
if (!self::$permanentAttributes->includes($k))
|
|
$this->_unsavedValues->add($k);
|
|
}
|
|
public function __isset($k)
|
|
{
|
|
return isset($this->_values[$k]);
|
|
}
|
|
public function __unset($k)
|
|
{
|
|
unset($this->_values[$k]);
|
|
$this->_transientValues->add($k);
|
|
$this->_unsavedValues->discard($k);
|
|
}
|
|
public function __get($k)
|
|
{
|
|
if (array_key_exists($k, $this->_values)) {
|
|
return $this->_values[$k];
|
|
} else if ($this->_transientValues->includes($k)) {
|
|
$class = get_class($this);
|
|
$attrs = join(', ', array_keys($this->_values));
|
|
$message = "Stripe Notice: Undefined property of $class instance: $k. "
|
|
. "HINT: The $k attribute was set in the past, however. "
|
|
. "It was then wiped when refreshing the object "
|
|
. "with the result returned by Stripe's API, "
|
|
. "probably as a result of a save(). The attributes currently "
|
|
. "available on this object are: $attrs";
|
|
error_log($message);
|
|
return null;
|
|
} else {
|
|
$class = get_class($this);
|
|
error_log("Stripe Notice: Undefined property of $class instance: $k");
|
|
return null;
|
|
}
|
|
}
|
|
|
|
// ArrayAccess methods
|
|
public function offsetSet($k, $v)
|
|
{
|
|
$this->$k = $v;
|
|
}
|
|
|
|
public function offsetExists($k)
|
|
{
|
|
return array_key_exists($k, $this->_values);
|
|
}
|
|
|
|
public function offsetUnset($k)
|
|
{
|
|
unset($this->$k);
|
|
}
|
|
public function offsetGet($k)
|
|
{
|
|
return array_key_exists($k, $this->_values) ? $this->_values[$k] : null;
|
|
}
|
|
|
|
public function keys()
|
|
{
|
|
return array_keys($this->_values);
|
|
}
|
|
|
|
/**
|
|
* This unfortunately needs to be public to be used in Util.php
|
|
*
|
|
* @param string $class
|
|
* @param array $values
|
|
* @param string|null $apiKey
|
|
*
|
|
* @return Stripe_Object The object constructed from the given values.
|
|
*/
|
|
public static function scopedConstructFrom($class, $values, $apiKey=null)
|
|
{
|
|
$obj = new $class(isset($values['id']) ? $values['id'] : null, $apiKey);
|
|
$obj->refreshFrom($values, $apiKey);
|
|
return $obj;
|
|
}
|
|
|
|
/**
|
|
* @param array $values
|
|
* @param string|null $apiKey
|
|
*
|
|
* @return Stripe_Object The object of the same class as $this constructed
|
|
* from the given values.
|
|
*/
|
|
public static function constructFrom($values, $apiKey=null)
|
|
{
|
|
return self::scopedConstructFrom(__CLASS__, $values, $apiKey);
|
|
}
|
|
|
|
/**
|
|
* Refreshes this object using the provided values.
|
|
*
|
|
* @param array $values
|
|
* @param string $apiKey
|
|
* @param boolean $partial Defaults to false.
|
|
*/
|
|
public function refreshFrom($values, $apiKey, $partial=false)
|
|
{
|
|
$this->_apiKey = $apiKey;
|
|
|
|
// Wipe old state before setting new. This is useful for e.g. updating a
|
|
// customer, where there is no persistent card parameter. Mark those values
|
|
// which don't persist as transient
|
|
if ($partial) {
|
|
$removed = new Stripe_Util_Set();
|
|
} else {
|
|
$removed = array_diff(array_keys($this->_values), array_keys($values));
|
|
}
|
|
|
|
foreach ($removed as $k) {
|
|
if (self::$permanentAttributes->includes($k))
|
|
continue;
|
|
unset($this->$k);
|
|
}
|
|
|
|
foreach ($values as $k => $v) {
|
|
if (self::$permanentAttributes->includes($k) && isset($this[$k]))
|
|
continue;
|
|
|
|
if (self::$nestedUpdatableAttributes->includes($k) && is_array($v)) {
|
|
$this->_values[$k] = Stripe_Object::scopedConstructFrom(
|
|
'Stripe_AttachedObject', $v, $apiKey
|
|
);
|
|
} else {
|
|
$this->_values[$k] = Stripe_Util::convertToStripeObject($v, $apiKey);
|
|
}
|
|
|
|
$this->_transientValues->discard($k);
|
|
$this->_unsavedValues->discard($k);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @return array A recursive mapping of attributes to values for this object,
|
|
* including the proper value for deleted attributes.
|
|
*/
|
|
public function serializeParameters()
|
|
{
|
|
$params = array();
|
|
if ($this->_unsavedValues) {
|
|
foreach ($this->_unsavedValues->toArray() as $k) {
|
|
$v = $this->$k;
|
|
if ($v === NULL) {
|
|
$v = '';
|
|
}
|
|
$params[$k] = $v;
|
|
}
|
|
}
|
|
|
|
// Get nested updates.
|
|
foreach (self::$nestedUpdatableAttributes->toArray() as $property) {
|
|
if (isset($this->$property)
|
|
&& $this->$property instanceOf Stripe_Object) {
|
|
$params[$property] = $this->$property->serializeParameters();
|
|
}
|
|
}
|
|
return $params;
|
|
}
|
|
|
|
// Pretend to have late static bindings, even in PHP 5.2
|
|
protected function _lsb($method)
|
|
{
|
|
$class = get_class($this);
|
|
$args = array_slice(func_get_args(), 1);
|
|
return call_user_func_array(array($class, $method), $args);
|
|
}
|
|
protected static function _scopedLsb($class, $method)
|
|
{
|
|
$args = array_slice(func_get_args(), 2);
|
|
return call_user_func_array(array($class, $method), $args);
|
|
}
|
|
|
|
public function __toJSON()
|
|
{
|
|
if (defined('JSON_PRETTY_PRINT')) {
|
|
return json_encode($this->__toArray(true), JSON_PRETTY_PRINT);
|
|
} else {
|
|
return json_encode($this->__toArray(true));
|
|
}
|
|
}
|
|
|
|
public function __toString()
|
|
{
|
|
return $this->__toJSON();
|
|
}
|
|
|
|
public function __toArray($recursive=false)
|
|
{
|
|
if ($recursive) {
|
|
return Stripe_Util::convertStripeObjectToArray($this->_values);
|
|
} else {
|
|
return $this->_values;
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
Stripe_Object::init();
|