236 lines
6.6 KiB
PHP
Executable File
236 lines
6.6 KiB
PHP
Executable File
<?php
|
|
|
|
namespace Twilio;
|
|
|
|
use Twilio\Exceptions\RestException;
|
|
use Twilio\Exceptions\TwilioException;
|
|
use Twilio\Http\Response;
|
|
|
|
abstract class Version {
|
|
/**
|
|
* @const int MAX_PAGE_SIZE largest page the Twilio API will return
|
|
*/
|
|
const MAX_PAGE_SIZE = 1000;
|
|
|
|
/**
|
|
* @var \Twilio\Domain $domain
|
|
*/
|
|
protected $domain;
|
|
|
|
/**
|
|
* @var string $version
|
|
*/
|
|
protected $version;
|
|
|
|
/**
|
|
* @param \Twilio\Domain $domain
|
|
*/
|
|
public function __construct(Domain $domain) {
|
|
$this->domain = $domain;
|
|
$this->version = null;
|
|
}
|
|
|
|
/**
|
|
* Generate an absolute URL from a version relative uri
|
|
* @param string $uri Version relative uri
|
|
* @return string Absolute URL
|
|
*/
|
|
public function absoluteUrl($uri) {
|
|
return $this->getDomain()->absoluteUrl($this->relativeUri($uri));
|
|
}
|
|
|
|
/**
|
|
* Generate a domain relative uri from a version relative uri
|
|
* @param string $uri Version relative uri
|
|
* @return string Domain relative uri
|
|
*/
|
|
public function relativeUri($uri) {
|
|
return trim($this->version, '/') . '/' . trim($uri, '/');
|
|
}
|
|
|
|
public function request($method, $uri, $params = array(), $data = array(),
|
|
$headers = array(), $username = null,
|
|
$password = null, $timeout = null) {
|
|
$uri = $this->relativeUri($uri);
|
|
return $this->getDomain()->request(
|
|
$method,
|
|
$uri,
|
|
$params,
|
|
$data,
|
|
$headers,
|
|
$username,
|
|
$password,
|
|
$timeout
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Create the best possible exception for the response.
|
|
*
|
|
* Attempts to parse the response for Twilio Standard error messages and use
|
|
* those to populate the exception, falls back to generic error message and
|
|
* HTTP status code.
|
|
*
|
|
* @param Response $response Error response
|
|
* @param string $header Header for exception message
|
|
* @return TwilioException
|
|
*/
|
|
protected function exception($response, $header) {
|
|
$message = '[HTTP ' . $response->getStatusCode() . '] ' . $header;
|
|
|
|
$content = $response->getContent();
|
|
if (is_array($content)) {
|
|
$message .= isset($content['message']) ? ': ' . $content['message'] : '';
|
|
$code = isset($content['code']) ? $content['code'] : $response->getStatusCode();
|
|
return new RestException($message, $code, $response->getStatusCode());
|
|
} else {
|
|
return new RestException($message, $response->getStatusCode(), $response->getStatusCode());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @throws TwilioException
|
|
*/
|
|
public function fetch($method, $uri, $params = array(), $data = array(),
|
|
$headers = array(), $username = null,
|
|
$password = null, $timeout = null) {
|
|
$response = $this->request(
|
|
$method,
|
|
$uri,
|
|
$params,
|
|
$data,
|
|
$headers,
|
|
$username,
|
|
$password,
|
|
$timeout
|
|
);
|
|
|
|
if ($response->getStatusCode() < 200 || $response->getStatusCode() >= 300) {
|
|
throw $this->exception($response, 'Unable to fetch record');
|
|
}
|
|
|
|
return $response->getContent();
|
|
}
|
|
|
|
/**
|
|
* @throws TwilioException
|
|
*/
|
|
public function update($method, $uri, $params = array(), $data = array(),
|
|
$headers = array(), $username = null,
|
|
$password = null, $timeout = null) {
|
|
$response = $this->request(
|
|
$method,
|
|
$uri,
|
|
$params,
|
|
$data,
|
|
$headers,
|
|
$username,
|
|
$password,
|
|
$timeout
|
|
);
|
|
|
|
if ($response->getStatusCode() < 200 || $response->getStatusCode() >= 300) {
|
|
throw $this->exception($response, 'Unable to update record');
|
|
}
|
|
|
|
return $response->getContent();
|
|
}
|
|
|
|
/**
|
|
* @throws TwilioException
|
|
*/
|
|
public function delete($method, $uri, $params = array(), $data = array(),
|
|
$headers = array(), $username = null,
|
|
$password = null, $timeout = null) {
|
|
$response = $this->request(
|
|
$method,
|
|
$uri,
|
|
$params,
|
|
$data,
|
|
$headers,
|
|
$username,
|
|
$password,
|
|
$timeout
|
|
);
|
|
|
|
if ($response->getStatusCode() < 200 || $response->getStatusCode() >= 300) {
|
|
throw $this->exception($response, 'Unable to delete record');
|
|
}
|
|
|
|
return $response->getStatusCode() == 204;
|
|
}
|
|
|
|
public function readLimits($limit = null, $pageSize = null) {
|
|
$pageLimit = Values::NONE;
|
|
|
|
if ($limit) {
|
|
if (is_null($pageSize)) {
|
|
$pageSize = min($limit, self::MAX_PAGE_SIZE);
|
|
}
|
|
$pageLimit = (int)(ceil($limit / (float)$pageSize));
|
|
}
|
|
|
|
$pageSize = min($pageSize, self::MAX_PAGE_SIZE);
|
|
|
|
return array(
|
|
'limit' => $limit ?: Values::NONE,
|
|
'pageSize' => $pageSize ?: Values::NONE,
|
|
'pageLimit' => $pageLimit,
|
|
);
|
|
}
|
|
|
|
public function page($method, $uri, $params = array(), $data = array(),
|
|
$headers = array(), $username = null,
|
|
$password = null, $timeout = null) {
|
|
return $this->request(
|
|
$method,
|
|
$uri,
|
|
$params,
|
|
$data,
|
|
$headers,
|
|
$username,
|
|
$password,
|
|
$timeout
|
|
);
|
|
}
|
|
|
|
public function stream($page, $limit = null, $pageLimit = null) {
|
|
return new Stream($page, $limit, $pageLimit);
|
|
}
|
|
|
|
/**
|
|
* @throws TwilioException
|
|
*/
|
|
public function create($method, $uri, $params = array(), $data = array(),
|
|
$headers = array(), $username = null,
|
|
$password = null, $timeout = null) {
|
|
$response = $this->request(
|
|
$method,
|
|
$uri,
|
|
$params,
|
|
$data,
|
|
$headers,
|
|
$username,
|
|
$password,
|
|
$timeout
|
|
);
|
|
|
|
if ($response->getStatusCode() < 200 || $response->getStatusCode() >= 300) {
|
|
// throw $this->exception($response, 'Unable to create record');
|
|
}
|
|
|
|
return $response->getContent();
|
|
}
|
|
|
|
/**
|
|
* @return \Twilio\Domain $domain
|
|
*/
|
|
public function getDomain() {
|
|
return $this->domain;
|
|
}
|
|
|
|
public function __toString() {
|
|
return '[Version]';
|
|
}
|
|
}
|