Edit File by line

<?php

[0] Fix | Delete

[1] Fix | Delete

namespace WPForms\Vendor\Stripe;

[2] Fix | Delete

[3] Fix | Delete

/**

[4] Fix | Delete

* Class ApiResource.

[5] Fix | Delete

[6] Fix | Delete

* */

[7] Fix | Delete

abstract class ApiResource extends StripeObject

[8] Fix | Delete

{

[9] Fix | Delete

use ApiOperations\Request;

[10] Fix | Delete

/**

[11] Fix | Delete

* @return \Stripe\Util\Set A list of fields that can be their own type of

[12] Fix | Delete

* API resource (say a nested card under an account for example), and if

[13] Fix | Delete

* that resource is set, it should be transmitted to the API on a create or

[14] Fix | Delete

* update. Doing so is not the default behavior because API resources

[15] Fix | Delete

* should normally be persisted on their own RESTful endpoints.

[16] Fix | Delete

[17] Fix | Delete

public static function getSavedNestedResources()

[18] Fix | Delete

{

[19] Fix | Delete

static $savedNestedResources = null;

[20] Fix | Delete

if (null === $savedNestedResources) {

[21] Fix | Delete

$savedNestedResources = new Util\Set();

[22] Fix | Delete

}

[23] Fix | Delete

return $savedNestedResources;

[24] Fix | Delete

}

[25] Fix | Delete

/**

[26] Fix | Delete

* @var bool A flag that can be set a behavior that will cause this

[27] Fix | Delete

* resource to be encoded and sent up along with an update of its parent

[28] Fix | Delete

* resource. This is usually not desirable because resources are updated

[29] Fix | Delete

* individually on their own endpoints, but there are certain cases,

[30] Fix | Delete

* replacing a customer's source for example, where this is allowed.

[31] Fix | Delete

[32] Fix | Delete

public $saveWithParent = \false;

[33] Fix | Delete

public function __set($k, $v)

[34] Fix | Delete

{

[35] Fix | Delete

parent::__set($k, $v);

[36] Fix | Delete

$v = $this->{$k};

[37] Fix | Delete

if (static::getSavedNestedResources()->includes($k) && $v instanceof ApiResource) {

[38] Fix | Delete

$v->saveWithParent = \true;

[39] Fix | Delete

}

[40] Fix | Delete

}

[41] Fix | Delete

/**

[42] Fix | Delete

* @throws Exception\ApiErrorException

[43] Fix | Delete

[44] Fix | Delete

* @return ApiResource the refreshed resource

[45] Fix | Delete

[46] Fix | Delete

public function refresh()

[47] Fix | Delete

{

[48] Fix | Delete

$requestor = new ApiRequestor($this->_opts->apiKey, static::baseUrl());

[49] Fix | Delete

$url = $this->instanceUrl();

[50] Fix | Delete

list($response, $this->_opts->apiKey) = $requestor->request('get', $url, $this->_retrieveOptions, $this->_opts->headers);

[51] Fix | Delete

$this->setLastResponse($response);

[52] Fix | Delete

$this->refreshFrom($response->json, $this->_opts);

[53] Fix | Delete

return $this;

[54] Fix | Delete

}

[55] Fix | Delete

/**

[56] Fix | Delete

* @return string the base URL for the given class

[57] Fix | Delete

[58] Fix | Delete

public static function baseUrl()

[59] Fix | Delete

{

[60] Fix | Delete

return Stripe::$apiBase;

[61] Fix | Delete

}

[62] Fix | Delete

/**

[63] Fix | Delete

* @return string the endpoint URL for the given class

[64] Fix | Delete

[65] Fix | Delete

public static function classUrl()

[66] Fix | Delete

{

[67] Fix | Delete

// Replace dots with slashes for namespaced resources, e.g. if the object's name is

[68] Fix | Delete

// "foo.bar", then its URL will be "/v1/foo/bars".

[69] Fix | Delete

/** @phpstan-ignore-next-line */

[70] Fix | Delete

$base = \str_replace('.', '/', static::OBJECT_NAME);

[71] Fix | Delete

return "/v1/{$base}s";

[72] Fix | Delete

}

[73] Fix | Delete

/**

[74] Fix | Delete

* @param null|string $id the ID of the resource

[75] Fix | Delete

[76] Fix | Delete

* @throws Exception\UnexpectedValueException if $id is null

[77] Fix | Delete

[78] Fix | Delete

* @return string the instance endpoint URL for the given class

[79] Fix | Delete

[80] Fix | Delete

public static function resourceUrl($id)

[81] Fix | Delete

{

[82] Fix | Delete

if (null === $id) {

[83] Fix | Delete

$class = static::class;

[84] Fix | Delete

$message = 'Could not determine which URL to request: ' . "{$class} instance has invalid ID: {$id}";

[85] Fix | Delete

throw new Exception\UnexpectedValueException($message);

[86] Fix | Delete

}

[87] Fix | Delete

$id = Util\Util::utf8($id);

[88] Fix | Delete

$base = static::classUrl();

[89] Fix | Delete

$extn = \urlencode($id);

[90] Fix | Delete

return "{$base}/{$extn}";

[91] Fix | Delete

}

[92] Fix | Delete

/**

[93] Fix | Delete

* @return string the full API URL for this API resource

[94] Fix | Delete

[95] Fix | Delete

public function instanceUrl()

[96] Fix | Delete

{

[97] Fix | Delete

return static::resourceUrl($this['id']);

[98] Fix | Delete

}

[99] Fix | Delete

}

[100] Fix | Delete

[101] Fix | Delete