mirror of
https://gitlab.com/openlp/website.git
synced 2024-09-01 19:43:37 +00:00
203 lines
6.3 KiB
PHP
203 lines
6.3 KiB
PHP
<?php
|
|
|
|
namespace Stripe;
|
|
|
|
/**
|
|
* Class ApiResource
|
|
*
|
|
* @package Stripe
|
|
*/
|
|
abstract class ApiResource extends StripeObject
|
|
{
|
|
private static $HEADERS_TO_PERSIST = array('Stripe-Account' => true, 'Stripe-Version' => true);
|
|
|
|
public static function baseUrl()
|
|
{
|
|
return Stripe::$apiBase;
|
|
}
|
|
|
|
/**
|
|
* @return ApiResource The refreshed resource.
|
|
*/
|
|
public function refresh()
|
|
{
|
|
$requestor = new ApiRequestor($this->_opts->apiKey, static::baseUrl());
|
|
$url = $this->instanceUrl();
|
|
|
|
list($response, $this->_opts->apiKey) = $requestor->request(
|
|
'get',
|
|
$url,
|
|
$this->_retrieveOptions,
|
|
$this->_opts->headers
|
|
);
|
|
$this->setLastResponse($response);
|
|
$this->refreshFrom($response->json, $this->_opts);
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* @return string The name of the class, with namespacing and underscores
|
|
* stripped.
|
|
*/
|
|
public static function className()
|
|
{
|
|
$class = get_called_class();
|
|
// Useful for namespaces: Foo\Charge
|
|
if ($postfixNamespaces = strrchr($class, '\\')) {
|
|
$class = substr($postfixNamespaces, 1);
|
|
}
|
|
// Useful for underscored 'namespaces': Foo_Charge
|
|
if ($postfixFakeNamespaces = strrchr($class, '')) {
|
|
$class = $postfixFakeNamespaces;
|
|
}
|
|
if (substr($class, 0, strlen('Stripe')) == 'Stripe') {
|
|
$class = substr($class, strlen('Stripe'));
|
|
}
|
|
$class = str_replace('_', '', $class);
|
|
$name = urlencode($class);
|
|
$name = strtolower($name);
|
|
return $name;
|
|
}
|
|
|
|
/**
|
|
* @return string The endpoint URL for the given class.
|
|
*/
|
|
public static function classUrl()
|
|
{
|
|
$base = static::className();
|
|
return "/v1/${base}s";
|
|
}
|
|
|
|
/**
|
|
* @return string The instance endpoint URL for the given class.
|
|
*/
|
|
public static function resourceUrl($id)
|
|
{
|
|
if ($id === null) {
|
|
$class = get_called_class();
|
|
$message = "Could not determine which URL to request: "
|
|
. "$class instance has invalid ID: $id";
|
|
throw new Error\InvalidRequest($message, null);
|
|
}
|
|
$id = Util\Util::utf8($id);
|
|
$base = static::classUrl();
|
|
$extn = urlencode($id);
|
|
return "$base/$extn";
|
|
}
|
|
|
|
/**
|
|
* @return string The full API URL for this API resource.
|
|
*/
|
|
public function instanceUrl()
|
|
{
|
|
return static::resourceUrl($this['id']);
|
|
}
|
|
|
|
protected static function _validateParams($params = null)
|
|
{
|
|
if ($params && !is_array($params)) {
|
|
$message = "You must pass an array as the first argument to Stripe API "
|
|
. "method calls. (HINT: an example call to create a charge "
|
|
. "would be: \"Stripe\\Charge::create(array('amount' => 100, "
|
|
. "'currency' => 'usd', 'source' => 'tok_1234'))\")";
|
|
throw new Error\Api($message);
|
|
}
|
|
}
|
|
|
|
protected function _request($method, $url, $params = array(), $options = null)
|
|
{
|
|
$opts = $this->_opts->merge($options);
|
|
list($resp, $options) = static::_staticRequest($method, $url, $params, $opts);
|
|
$this->setLastResponse($resp);
|
|
return array($resp->json, $options);
|
|
}
|
|
|
|
protected static function _staticRequest($method, $url, $params, $options)
|
|
{
|
|
$opts = Util\RequestOptions::parse($options);
|
|
$requestor = new ApiRequestor($opts->apiKey, static::baseUrl());
|
|
list($response, $opts->apiKey) = $requestor->request($method, $url, $params, $opts->headers);
|
|
foreach ($opts->headers as $k => $v) {
|
|
if (!array_key_exists($k, self::$HEADERS_TO_PERSIST)) {
|
|
unset($opts->headers[$k]);
|
|
}
|
|
}
|
|
return array($response, $opts);
|
|
}
|
|
|
|
protected static function _retrieve($id, $options = null)
|
|
{
|
|
$opts = Util\RequestOptions::parse($options);
|
|
$instance = new static($id, $opts);
|
|
$instance->refresh();
|
|
return $instance;
|
|
}
|
|
|
|
protected static function _all($params = null, $options = null)
|
|
{
|
|
self::_validateParams($params);
|
|
$url = static::classUrl();
|
|
|
|
list($response, $opts) = static::_staticRequest('get', $url, $params, $options);
|
|
$obj = Util\Util::convertToStripeObject($response->json, $opts);
|
|
if (!is_a($obj, 'Stripe\\Collection')) {
|
|
$class = get_class($obj);
|
|
$message = "Expected type \"Stripe\\Collection\", got \"$class\" instead";
|
|
throw new Error\Api($message);
|
|
}
|
|
$obj->setLastResponse($response);
|
|
$obj->setRequestParams($params);
|
|
return $obj;
|
|
}
|
|
|
|
protected static function _create($params = null, $options = null)
|
|
{
|
|
self::_validateParams($params);
|
|
$url = static::classUrl();
|
|
|
|
list($response, $opts) = static::_staticRequest('post', $url, $params, $options);
|
|
$obj = Util\Util::convertToStripeObject($response->json, $opts);
|
|
$obj->setLastResponse($response);
|
|
return $obj;
|
|
}
|
|
|
|
/**
|
|
* @param string $id The ID of the API resource to update.
|
|
* @param array|null $params
|
|
* @param array|string|null $opts
|
|
*
|
|
* @return ApiResource the updated API resource
|
|
*/
|
|
protected static function _update($id, $params = null, $options = null)
|
|
{
|
|
self::_validateParams($params);
|
|
$url = static::resourceUrl($id);
|
|
|
|
list($response, $opts) = static::_staticRequest('post', $url, $params, $options);
|
|
$obj = Util\Util::convertToStripeObject($response->json, $opts);
|
|
$obj->setLastResponse($response);
|
|
return $obj;
|
|
}
|
|
|
|
protected function _save($options = null)
|
|
{
|
|
$params = $this->serializeParameters();
|
|
if (count($params) > 0) {
|
|
$url = $this->instanceUrl();
|
|
list($response, $opts) = $this->_request('post', $url, $params, $options);
|
|
$this->refreshFrom($response, $opts);
|
|
}
|
|
return $this;
|
|
}
|
|
|
|
protected function _delete($params = null, $options = null)
|
|
{
|
|
self::_validateParams($params);
|
|
|
|
$url = $this->instanceUrl();
|
|
list($response, $opts) = $this->_request('delete', $url, $params, $options);
|
|
$this->refreshFrom($response, $opts);
|
|
return $this;
|
|
}
|
|
}
|