123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203 |
- <?php
- namespace Gogs\Lib\Curl {
- /**
- * A trait used for every class referencing the api-url and token.
- *
- * @author Joachim M. Giaever (joachim[]giaever.org)
- * @package curl
- * @version 0.1
- */
- trait Client {
- protected $url;
- protected $token;
- protected $user_agent = "Gogs PHP Api Curl\\Client/0.1 (compatible; LINUX)";
- protected $timeout = 30;
- protected $max_redirects = 4;
- /**
- * array_2_params takes an array and converts it into a
- * query string (e.g param=val¶m2=val2).
- *
- * @param array $params parameters to pass
- * @return string
- */
- private function array_2_params(array $params) {
- return join("&", array_map(function($k, $v) {
- return sprintf("%s=%s", $k, rawurlencode(is_bool($v) ? ($v ? "true" : "false") : $v ));
- }, array_keys($params), $params));
- }
- /**
- * array_2_json takes an array and converts it into a
- * json-string (e.g {'name': 'This'}) which is typically
- * used in a request body.
- *
- * @param array $params paramters to pass
- * @return string
- */
- private function array_2_json(array $params) {
- return count($params) == 0 ? null : json_encode($params);
- }
- /**
- * Initializes a curl request of different kinds, depending
- * on the specified method. This can be
- *
- * DELETE, PATCH, POST or GET. An unidentified value will
- * become a GET-request.
- *
- * @param string $method either DELETE, PATCH, POST, GET
- * @param string &$req variable to store request body in
- * @param string $scope scope within the API (e.g /user/repos)
- * @param array $params parameters to pass
- * @param bool $ret return transfer
- * @return int the status code
- */
- protected function method(string $method, string &$req, string $scope, array $params, bool $ret) {
- $c = curl_init();
- if (!$c) {
- return false;
- }
- $headers = array(
- sprintf("Authorization: token %s", $this->token),
- );
- $url = sprintf("%s%s", $this->url, $scope);
- echo sprintf("%s: %s, params: %s\n", $method, $url, $this->array_2_json($params));
- if (in_array($method, array("DELETE", "PATCH", "POST"))) {
- $json = $this->array_2_json($params);
- curl_setopt($c, CURLOPT_CUSTOMREQUEST, $method);
- curl_setopt($c, CURLOPT_POSTFIELDS, $json);
- array_unshift($headers, "Content-Type: application/json");
- array_push($headers, "Content-Length: " . strlen($json));
- } else {
- $url .= "?" . $this->array_2_params($params);
- }
- curl_setopt($c, CURLOPT_USERAGENT, $this->user_agent);
- curl_setopt($c, CURLOPT_URL, $url);
- curl_setopt($c, CURLOPT_HTTPHEADER, $headers);
- curl_setopt($c, CURLOPT_RETURNTRANSFER, $ret);
- curl_setopt($c, CURLOPT_TIMEOUT, $this->timeout);
- curl_setopt($c, CURLOPT_MAXREDIRS, $this->max_redirects);
- curl_setopt($c, CURLOPT_FOLLOWLOCATION, true);
- $req = curl_exec($c);
- $status_code = curl_getinfo($c, CURLINFO_HTTP_CODE);
- curl_close($c);
- return $status_code;
- }
- /**
- * Checks if the user is authorized for the scope. Shouldn't
- * be used frequently. One test for one scope should be enough,
- * but if you know for sure thats you're programming with the
- * use of an authorized user you should leave this and just
- * handle the NotAuthorizedExeption whenever thrown.
- *
- * @param $scope the scope, a relative uri.
- * @throws Not AuthorizedException if server responde with a 401
- * @return bool
- */
- protected function authorized(string $scope = "") {
- $ret = "";
- if (in_array(($code = $this->method("GET", $ret, $scope, array(), false)),
- array(400, 401, 402, 403)
- )) {
- throw new NotAuthorizedException("Not authorized", 401);
- }
- return true;
- }
- /**
- * Post method.
- *
- * @param string $scope the scope, a relative uri.
- * @param array $params the parameters to post.
- * @throws NotAuthorizedException on 401, 403
- * @throws HTTPUnexpectedResponse when not 200,201,401,403
- * @return string the request content.
- */
- private function post(string $scope = "", array $params = array()) {
- $req = "";
- $code = $this->method("POST", $req, $scope, $params, true);
- switch ($code) {
- case 200:
- case 201:
- return $req;
- case 400:
- case 401:
- case 403:
- throw new Exception\NotAuthorizedException($req, $code);
- default:
- throw new Exception\HTTPUnexpectedResponse($req, $code);
- }
- }
- /**
- * Delete method.
- *
- * @param string $scope the scope, a relative uri.
- * @throws NotAuthorizedException on 401, 403
- * @throws HTTPUnexpectedResponse when not 200,204,401,403
- * @return string the request content.
- */
- private function delete(string $scope = "") {
- $req = "";
- $code = $this->method("DELETE", $req, $scope, array(), true);
- switch ($code) {
- case 200:
- case 204:
- return $req;
- case 401:
- case 403:
- throw new Exception\NotAuthorizedException($req, $code);
- default:
- throw new Exception\HTTPUnexpectedResponse($req, $code);
- }
- }
- /**
- * GET method.
- *
- * @param string $scope the scope, a relative uri.
- * @param array $params the parameters to post.
- * @throws NotAuthorizedException on 401, 403
- * @throws HTTPUnexpectedResponse when not 200,401,403
- * @return string the request content.
- */
- private function get($scope = "", $params = array()) {
- $req = "";
- $code = $this->method("GET", $req, $scope, $params, true);
- switch ($code) {
- case 200:
- return $req;
- case 401:
- case 403:
- throw new Exception\NotAuthorizedException($req, $code);
- default:
- throw new Exception\HTTPUnexpectedResponse($req, $code);
- }
- }
- }
- }
- ?>
|