Client.php

<?php

namespace Twingly;

require 'vendor/autoload.php';

/**
 * Twingly Search API client
 *
 * @package Twingly
 */
class Client {
    const VERSION = '2.1.1';
    const BASE_URL = 'https://api.twingly.com';
    const SEARCH_API_VERSION = 'v3';
    const SEARCH_PATH = '/blog/search/api/'. self::SEARCH_API_VERSION .'/search';
    const DEFAULT_USER_AGENT = 'Twingly Search PHP Client/%s';

    public $api_key = null;
    public $user_agent = null;
    public $guzzle;

    /**
     * Client constructor.
     *
     * @param string $api_key Twingly Search API Key. If not provided, reads key from environment (TWINGLY_SEARCH_KEY)
     * @param string $user_agent User Agent for client
     *
     * @throws AuthException if no API key was provided
     */
    function __construct($api_key = false, $user_agent = false)
    {
        if(!$api_key) {
            $api_key = $this->env_api_key();
        }

        if(!$api_key) {
            $this->api_key_missing();
        }

        $this->api_key = $api_key;

        if(!$user_agent) {
            $user_agent = sprintf(Client::DEFAULT_USER_AGENT, Client::VERSION);
        }
        $this->user_agent = $user_agent;

        $this->guzzle = new \GuzzleHttp\Client([
            'base_uri' => Client::BASE_URL,
            'headers' => [
                'Content-Type' => 'application/json',
                'Accept' => 'application/json',
                'User-Agent' => $this->user_agent,
                'Accept-Encoding' => 'gzip'
            ],
            'verify' => false
        ]);
    }

    /**
     * Returns a new Query object connected to this client
     *
     * @return Query
     */
    public function query() {
        return new Query($this);
    }

    /**
     * Executes the given Query and returns the result
     *
     * This method should not be called manually, instead use Query->execute().
     *
     * @param Query $query the query to be executed
     *
     * @return Result
     */
    public function execute_query($query) {
        $response_body = $this->get_response($query)->getBody();
        $parser = new Parser();
        return $parser->parse($response_body);
    }

    /**
     * @return string API endpoint URL
     */
    public function endpoint_url() {
        return sprintf('%s%s', Client::BASE_URL, Client::SEARCH_PATH);
    }

    private function env_api_key() {
        return getenv('TWINGLY_SEARCH_KEY');
    }

    private function get_response($query) {
        $response = $this->guzzle->get($query->url(), ['http_errors' => false]); // disable http errors, we will handle them
        return $response;
    }

    private function api_key_missing() {
        throw new AuthException('No API key has been provided.');
    }
}