ApiResource.php — Booking for Appointments and Events Calendar – Amelia 2.4.4

ameliabooking / vendor / stripe / stripe-php / lib / ApiResource.php

ameliabooking / vendor / stripe / stripe-php / lib Last commit date

ApiResource.php

101 lines

1	<?php
2
3	namespace AmeliaVendor\Stripe;
4
5	/**
6	* Class ApiResource.
7	*
8	* */
9	abstract class ApiResource extends StripeObject
10	{
11	use \AmeliaVendor\Stripe\ApiOperations\Request;
12	/**
13	* @return Util\Set A list of fields that can be their own type of
14	* API resource (say a nested card under an account for example), and if
15	* that resource is set, it should be transmitted to the API on a create or
16	* update. Doing so is not the default behavior because API resources
17	* should normally be persisted on their own RESTful endpoints.
18	*/
19	public static function getSavedNestedResources()
20	{
21	static $savedNestedResources = null;
22	if (null === $savedNestedResources) {
23	$savedNestedResources = new Util\Set();
24	}
25	return $savedNestedResources;
26	}
27	/**
28	* @var bool A flag that can be set a behavior that will cause this
29	* resource to be encoded and sent up along with an update of its parent
30	* resource. This is usually not desirable because resources are updated
31	* individually on their own endpoints, but there are certain cases,
32	* replacing a customer's source for example, where this is allowed.
33	*/
34	public $saveWithParent = false;
35	public function __set($k, $v)
36	{
37	parent::__set($k, $v);
38	$v = $this->{$k};
39	if (static::getSavedNestedResources()->includes($k) && $v instanceof ApiResource) {
40	$v->saveWithParent = true;
41	}
42	}
43	/**
44	* @return ApiResource the refreshed resource
45	*
46	* @throws Exception\ApiErrorException
47	*/
48	public function refresh()
49	{
50	$requestor = new ApiRequestor($this->_opts->apiKey, static::baseUrl());
51	$url = $this->instanceUrl();
52	list($response, $this->_opts->apiKey) = $requestor->request('get', $url, $this->_retrieveOptions, $this->_opts->headers);
53	$this->setLastResponse($response);
54	$this->refreshFrom($response->json, $this->_opts);
55	return $this;
56	}
57	/**
58	* @return string the base URL for the given class
59	*/
60	public static function baseUrl()
61	{
62	return Stripe::$apiBase;
63	}
64	/**
65	* @return string the endpoint URL for the given class
66	*/
67	public static function classUrl()
68	{
69	// Replace dots with slashes for namespaced resources, e.g. if the object's name is
70	// "foo.bar", then its URL will be "/v1/foo/bars".
71	/** @phpstan-ignore-next-line */
72	$base = \str_replace('.', '/', static::OBJECT_NAME);
73	return "/v1/{$base}s";
74	}
75	/**
76	* @param null\|string $id the ID of the resource
77	*
78	* @return string the instance endpoint URL for the given class
79	*
80	* @throws Exception\UnexpectedValueException if $id is null
81	*/
82	public static function resourceUrl($id)
83	{
84	if (null === $id) {
85	$class = static::class;
86	$message = 'Could not determine which URL to request: ' . "{$class} instance has invalid ID: {$id}";
87	throw new Exception\UnexpectedValueException($message);
88	}
89	$id = \AmeliaVendor\Stripe\Util\Util::utf8($id);
90	$base = static::classUrl();
91	$extn = \urlencode($id);
92	return "{$base}/{$extn}";
93	}
94	/**
95	* @return string the full API URL for this API resource
96	*/
97	public function instanceUrl()
98	{
99	return static::resourceUrl($this['id']);
100	}
101	}