69 lines
2.5 KiB
PHP
69 lines
2.5 KiB
PHP
|
<?php
|
||
|
|
|
||
|
|
namespace Stripe\ApiOperations;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Trait for resources that need to make API requests.
|
||
|
|
*
|
||
|
|
* This trait should only be applied to classes that derive from StripeObject.
|
||
|
|
*/
|
||
|
|
trait Request
|
||
|
|
{
|
||
|
|
/**
|
||
|
|
* @param null|array|mixed $params The list of parameters to validate
|
||
|
|
*
|
||
|
|
* @throws \Stripe\Exception\InvalidArgumentException if $params exists and is not an array
|
||
|
|
*/
|
||
|
|
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(['amount' => 100, "
|
||
|
|
. "'currency' => 'usd', 'source' => 'tok_1234'])\")";
|
||
|
|
|
||
|
|
throw new \Stripe\Exception\InvalidArgumentException($message);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param string $method HTTP method ('get', 'post', etc.)
|
||
|
|
* @param string $url URL for the request
|
||
|
|
* @param array $params list of parameters for the request
|
||
|
|
* @param null|array|string $options
|
||
|
|
*
|
||
|
|
* @throws \Stripe\Exception\ApiErrorException if the request fails
|
||
|
|
*
|
||
|
|
* @return array tuple containing (the JSON response, $options)
|
||
|
|
*/
|
||
|
|
protected function _request($method, $url, $params = [], $options = null)
|
||
|
|
{
|
||
|
|
$opts = $this->_opts->merge($options);
|
||
|
|
list($resp, $options) = static::_staticRequest($method, $url, $params, $opts);
|
||
|
|
$this->setLastResponse($resp);
|
||
|
|
|
||
|
|
return [$resp->json, $options];
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param string $method HTTP method ('get', 'post', etc.)
|
||
|
|
* @param string $url URL for the request
|
||
|
|
* @param array $params list of parameters for the request
|
||
|
|
* @param null|array|string $options
|
||
|
|
*
|
||
|
|
* @throws \Stripe\Exception\ApiErrorException if the request fails
|
||
|
|
*
|
||
|
|
* @return array tuple containing (the JSON response, $options)
|
||
|
|
*/
|
||
|
|
protected static function _staticRequest($method, $url, $params, $options)
|
||
|
|
{
|
||
|
|
$opts = \Stripe\Util\RequestOptions::parse($options);
|
||
|
|
$baseUrl = isset($opts->apiBase) ? $opts->apiBase : static::baseUrl();
|
||
|
|
$requestor = new \Stripe\ApiRequestor($opts->apiKey, $baseUrl);
|
||
|
|
list($response, $opts->apiKey) = $requestor->request($method, $url, $params, $opts->headers);
|
||
|
|
$opts->discardNonPersistentHeaders();
|
||
|
|
|
||
|
|
return [$response, $opts];
|
||
|
|
}
|
||
|
|
}
|