App\Controller\Component\GithubApiComponent

Complexity

Total Complexity

13

Size/Duplication

Total Lines	222
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	2

Test Coverage

Coverage

100%

Importance

Changes

0

9 Methods

Rating	Name	Duplication	Size	Complexity
A	apiRequest()	0	15	2
A	getIssue()	0	10	1
A	createIssue()	0	10	1
A	createComment()	0	10	1
A	getAccessToken()	0	13	1
A	getUserInfo()	0	8	1
B	sendRequest()	0	27	4
A	getRedirectUrl()	0	18	1
A	canCommitTo()	0	12	1

<?php
/* vim: set expandtab sw=4 ts=4 sts=4: */

/**
 * Github api component handling comunication with github.
 *
 * phpMyAdmin Error reporting server
 * Copyright (c) phpMyAdmin project (https://www.phpmyadmin.net/)
 *
 * Licensed under The MIT License
 * For full copyright and license information, please see the LICENSE.txt
 * Redistributions of files must retain the above copyright notice.
 *
 * @copyright Copyright (c) phpMyAdmin project (https://www.phpmyadmin.net/)
 * @license   https://opensource.org/licenses/mit-license.php MIT License
 *
 * @see      https://www.phpmyadmin.net/
 */

namespace App\Controller\Component;

use Cake\Controller\Component;
use Cake\Routing\Router;

/**
 * Github api component handling comunication with github.
 */
class GithubApiComponent extends Component
{
    /**
     * perform an api request given a path, the data to send, the method and whether
     * or not to return a status.
     *
     * @param string $path         the api path to preform the request to
     * @param array  $data         the data to send in the request. This works with both GET
     *                             and Post requests
     * @param string $method       the method type of the request
     * @param bool   $returnStatus whether to return the status code with the
     *                             request
     * @param mixed  $access_token
     *
     * @return array the returned response decoded and optionally the status code,
     *               see GithubApiComponent::sendRequest()
     *
     * @see GithubApiComponent::sendRequest()
     */
    public function apiRequest(
        $path = '',
        $data = array(),
        $method = 'GET',
        $returnStatus = false,
        $access_token = ''
    ) {
        $path = 'https://api.github.com/' . $path;
        if (strtoupper($method) === 'GET') {
            $path .= '?' . http_build_query($data);
            $data = array();
        }

        return $this->sendRequest($path, $data, $method, $returnStatus, $access_token);
    }

    /**
     * retrieve an access token using a code that has been authorized by a user.
     *
     * @param string $code the code returned by github to the callback url
     *
     * @return string the access token
     */
    public function getAccessToken($code)
    {
        $url = 'https://github.com/login/oauth/access_token';
        $data = array_merge(
            $this->githubConfig,
            array(
                'code' => $code,
            )
        );
        $decodedResponse = $this->sendRequest($url, http_build_query($data), 'POST');

        return $decodedResponse['access_token'];
    }

    /**
     * retrieve the github info stored on a user by his access token.
     *
     * @param string $accessToken the access token belonging to the user being
     *                            requested
     *
     * @return Arrray the github info returned by github as an associative array
     */
    public function getUserInfo($accessToken)
    {
        $data = array(
            'access_token' => $accessToken,
        );

        return $this->apiRequest('user', $data, 'GET', true);
    }

    /**
     * perform an http request using curl given a url, the post data to send, the
     * request method and whether or not to return a status.
     *
     * @param string $url          the url to preform the request to
     * @param array  $data         the post data to send in the request. This only works with POST requests. GET requests need the data appended in the url.
     *                             with POST requests. GET requests need the data appended
     *                             in the url.
     * @param string $method       the method type of the request
     * @param bool   $returnCode   whether to return the status code with the
     *                             request
     * @param mixed  $access_token
     *
     * @return array the returned response decoded and optionally the status code,
     *               eg: array($decodedResponse, $statusCode) or just $decodedResponse
     */
    public function sendRequest(
        $url,
        $data,
        $method,
        $returnCode = false,
        $access_token = ''
    ) {
        $curlHandle = curl_init($url);
        curl_setopt($curlHandle, CURLOPT_CUSTOMREQUEST, $method);
        $header = array('Accept: application/json');
        if (isset($access_token) && $access_token != '') {
            $header[] = 'Authorization: token ' . $access_token;
        }
        curl_setopt($curlHandle, CURLOPT_HTTPHEADER, $header);
        curl_setopt($curlHandle, CURLOPT_USERAGENT, 'phpMyAdmin - Error Reporting Server');
        curl_setopt($curlHandle, CURLOPT_POSTFIELDS, $data);
        curl_setopt($curlHandle, CURLOPT_RETURNTRANSFER, 1);
        $response = curl_exec($curlHandle);
        $decodedResponse = json_decode($response, true);
        if ($returnCode) {
            $status = curl_getinfo($curlHandle, CURLINFO_HTTP_CODE);

            return array($decodedResponse, $status);
        }

        return $decodedResponse;
    }

    /**
     * generate the url to redirect the user to for authorization given the
     * requested scope.
     *
     * @param string $scope the api scope for the user to authorize
     *
     * @return string the generated url to redirect the user to
     */
    public function getRedirectUrl($scope = null)
    {
        $url = 'https://github.com/login/oauth/authorize';
        $data = array(
            'client_id' => $this->githubConfig['client_id'],
            'redirect_uri' => Router::url(
                array(
                    'controller' => 'developers',
                    'action' => 'callback',
                ), true
            ),
            'scope' => $scope,
        );

        $url .= '?' . http_build_query($data);

        return $url;
    }

    /**
     * Check if a user can commit to a rep.
     *
     * @param string $username the username to check
     * @param string $repoPath the repo path of the repo to check for
     *
     * @return bool true if the user is a collaborator and false if they arent
     */
    public function canCommitTo($username, $repoPath, $access_token)
    {
        list(, $status) = $this->apiRequest(
            "repos/$repoPath/collaborators/$username",
            array(),
            'GET',
            true,
            $access_token
        );

        return $status === 204;
    }

    /**
     * make api request for github issue creation.
     *
     * @param string $repoPath
     * @param array  $data         issue details
     * @param string $access_token
     */
    public function createIssue($repoPath, $data, $access_token)
    {
        return $this->apiRequest(
            "repos/$repoPath/issues",
            json_encode($data),
            'POST',
            true,
            $access_token
        );
    }

    /**
     * make api request for github comment creation.
     *
     * @param string $repoPath
     * @param array  $data
     * @param int    $issueNumber
     * @param string $access_token
     */
    public function createComment($repoPath, $data, $issueNumber, $access_token)
    {
        return $this->apiRequest(
            "repos/$repoPath/issues/$issueNumber/comments",
            json_encode($data),
            'POST',
            true,
            $access_token
        );
    }

    /**
     * Make API request for getting Github issue's status
     *
     * @param string $repoPath
     * @param array  $data
     * @param int    $issueNumber
     * @param string $access_token
     */
    public function getIssue($repoPath, $data, $issueNumber, $access_token)
    {
        return $this->apiRequest(
            "repos/$repoPath/issues/$issueNumber",
            $data,
            'GET',
            true,
            $access_token
        );
    }

}