dukt / facebook

src/services/Api.php

<?php
/**
 * @link      https://dukt.net/facebook/
 * @copyright Copyright (c) Dukt
 * @license   https://github.com/dukt/facebook/blob/master/LICENSE.md
 */

namespace dukt\facebook\services;

use Craft;
use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;
use yii\base\Component;
use dukt\facebook\Plugin as Facebook;

/**
 * Class Api service
 *
 * @author Dukt <support@dukt.net>
 * @since  2.0
 */
class Api extends Component
{
    // Properties
    // =========================================================================

    /**
     * @var string
     */
    private $baseApiUrl = 'https://graph.facebook.com/';

    // Public Methods
    // =========================================================================

    /**
     * Performs an authenticated GET request on Facebook’s API
     *
     * @param null $uri

Are you sure the doc-type for parameter $uri is correct as it would always require null to be passed?

     * @param null $query

Are you sure the doc-type for parameter $query is correct as it would always require null to be passed?

     * @param null $headers

Are you sure the doc-type for parameter $headers is correct as it would always require null to be passed?

     *
     * @return mixed
     * @throws \GuzzleHttp\Exception\GuzzleException
     */
    public function get($uri = null, $query = null, $headers = null)
    {
        $options = [];
        try {
            $client = $this->getClient();

            $options['query'] = ($query ?: []);

$query is of type null, thus it always evaluated to false.

            if ($headers) {

$headers is of type null, thus it always evaluated to false.

                $options['headers'] = $headers;
            }

            $response = $client->request('GET', $uri, $options);

            return json_decode($response->getBody(), true);
        } catch (RequestException $requestException) {
            Craft::error('Error requesting Facebook’s API: '.$requestException->getResponse()->getBody(), __METHOD__);
            throw $requestException;
        }
    }

    /**
     * @param       $facebookInsightsObjectId
     * @param array $options
     *
     * @return mixed
     * @throws \GuzzleHttp\Exception\GuzzleException
     */
    public function getInsights($facebookInsightsObjectId, array $options = [])
    {
        try {
            $pageAccessTokenResponse = $this->get('/'.$facebookInsightsObjectId, ['fields' => 'access_token']);

            if(empty($pageAccessTokenResponse['access_token'])) {
                throw new \Exception('Couldn’t retrieve page access token for '.$facebookInsightsObjectId);
            }

            $client = $this->getClient($pageAccessTokenResponse['access_token']);

            $response = $client->request('GET', '/'.$facebookInsightsObjectId.'/insights', $options);

            return json_decode($response->getBody(), true);
        } catch (RequestException $requestException) {
            Craft::error('Error requesting insights: '.$requestException->getResponse()->getBody(), __METHOD__);
            throw $requestException;
        }
    }

    // Private Methods
    // =========================================================================

    /**
     * Returns the Facebook API URL.
     *
     * @return string
     */
    private function getApiUrl()
    {
        $apiVersion = Facebook::$plugin->getSettings()->apiVersion;

        return $this->baseApiUrl.$apiVersion.'/';
    }

    /**
     * Return the authenticated Facebook OAuth client.
     *
     * @param null $accessToken

Are you sure the doc-type for parameter $accessToken is correct as it would always require null to be passed?

     *
     * @return Client
     */
    private function getClient($accessToken = null): Client
    {
        if(!$accessToken) {

$accessToken is of type null, thus it always evaluated to false.

            $token = Facebook::$plugin->getOauth()->getToken();
            $accessToken = $token->getToken();
        }

        $headers = [];

        if ($accessToken) {
            $headers['Authorization'] = 'Bearer '.$accessToken;
        }

        $options = [
            'base_uri' => $this->getApiUrl(),
            'headers' => $headers
        ];

        return new Client($options);
    }
}