PhabricatorAPI.php
View Options

	<?php

	namespace Nasqueron\Notifications\Phabricator;

	use Nasqueron\Notifications\Contracts\APIClient;

	use Services;

	class PhabricatorAPI implements APIClient {

	///
	/// Private members
	///

	/**
	* The Phabricator main URL
	*
	* @var string
	*/
	private $endPoint;

	/**
	* The token generated at /settings/panel/apitokens/ to query the API
	*
	* @var string
	*/
	private $apiToken;

	///
	/// Constructors
	///

	/**
	* Initializes a new instance of the Phabricator API class
	*
	* @param string $endPoint The Phabricator main URL, without trailing slash
	* @param string $apiToken The token generated at /settings/panel/apitokens/
	*/
	public function __construct ($endPoint, $apiToken) {
	$this->endPoint = $endPoint;
	$this->apiToken = $apiToken;
	}

	/**
	* Gets an API instance for the specific instance
	*
	* @param string $instance The name of the instance (this matches that parameter in credentials.json)
	* @return PhabricatorAPI A PhabricatorAPI instance for the project if found; otherwise, null.
	*/
	public static function forInstance ($instance) {
	$service = Services::findServiceByProperty('Phabricator', 'instance', $instance);
	if ($service === null) {
	throw new \RuntimeException("No credentials for Phabricator instance $instance.");
	}
	return new self($service->instance, $service->secret);
	}

	/**
	* Gets an API instance for the specific project
	*
	* @param string $project The name of the project (this matches the door parameter in credentials.json)
	* @return PhabricatorAPI A PhabricatorAPI instance for the project if found; otherwise, null.
	*/
	public static function forProject ($project) {
	$service = Services::findServiceByDoor('Phabricator', $project);
	if ($service === null) {
	throw new \RuntimeException("No credentials for Phabricator project $project.");
	}
	return new self($service->instance, $service->secret);
	}

	///
	/// APIClient implementation
	///

	/**
	* Sets API end point
	*
	* @param string $url The API end point URL
	*/
	public function setEndPoint ($url) {
	$this->endPoint = $url;
	}

	/**
	* Calls a Conduit API method
	*
	* @param string $method The method to call (e.g. repository.create)
	* @param array $arguments The arguments to use
	* @return mixed The API result
	*/
	public function call ($method, $arguments = []) {
	$url = $this->endPoint . '/api/' . $method;
	$arguments['api.token'] = $this->apiToken;

	$reply = json_decode(static::post($url, $arguments));

	if ($reply->error_code !== null) {
	throw new PhabricatorAPIException(
	$reply->error_code,
	$reply->error_info
	);
	}

	return $reply->result;
	}

	///
	/// Helper methods
	///

	/**
	* Gets the first result of an API reply
	*
	* @param Traversable\|array $reply
	* @return mixed
	*/
	public static function getFirstResult ($reply) {
	if (is_object($reply) && property_exists($reply, 'data')) {
	$reply = $reply->data;
	}

	foreach ($reply as $value) {
	return $value;
	}
	}

	///
	/// CURL session
	///

	protected static function getPostFields ($arguments) {
	$items = [];
	foreach ($arguments as $key => $value) {
	$items[] = urlencode($key) . '=' . urlencode($value);
	}
	return implode('&', $items);
	}

	protected static function post ($url, $arguments) {
	$options = [
	CURLOPT_URL => $url,
	CURLOPT_HEADER => false,
	CURLOPT_RETURNTRANSFER => true,
	CURLOPT_FOLLOWLOCATION => 1,
	CURLOPT_POSTFIELDS => static::getPostFields($arguments),
	];

	$ch = curl_init();
	curl_setopt_array($ch, $options);
	$result = curl_exec($ch);
	curl_close($ch);

	if ($result === false) {
	throw new \RuntimeException("Can't reach Phabricator API endpoint: $url");
	}

	return $result;
	}
	}

File Metadata

Mime Type: text/x-php
Expires: Fri, Feb 28, 21:39 (1 d, 1 h)
Storage Engine: blob
Storage Format: Raw Data
Storage Handle: 2437462
Default Alt Text: PhabricatorAPI.php (4 KB)

PhabricatorAPI.php
No OneTemporary
Actions

PhabricatorAPI.php
View Options

File Metadata

Event Timeline

PhabricatorAPI.phpNo OneTemporaryActions

PhabricatorAPI.phpView Options

File Metadata

Event Timeline

PhabricatorAPI.php
No OneTemporary
Actions

PhabricatorAPI.php
View Options