koel/app/Services/YouTube.php

<?php

namespace App\Services;

use App\Models\Song;
use Cache;
use GuzzleHttp\Client;

class YouTube extends RESTfulService
{
    /**
     * Construct an instance of YouTube service.
     *
     * @param string      $key    The YouTube API key
     * @param Client|null $client The Guzzle HTTP client
     */
    public function __construct($key = null, Client $client = null)
    {
        parent::__construct(
            $key ?: env('YOUTUBE_API_KEY'),
            null,
            'https://www.googleapis.com/youtube/v3',
            $client ?: new Client()
        );
    }

    /**
     * Determine if our application is using YouTube.
     *
     * @return bool
     */
    public function enabled()
    {
        return (bool) env('YOUTUBE_API_KEY');
    }

    /**
     * Search for YouTube videos related to a song.
     *
     * @param Song   $song
     * @param string $pageToken
     *
     * @return object|false
     */
    public function searchVideosRelatedToSong($song, $pageToken = '')
    {
        $q = $song->title;

        // If the artist is worth noticing, include them into the search.
        if (!$song->artist->isUnknown() && !$song->artist->isVarious()) {
            $q .= ' '.$song->artist->name;
        }

        return $this->search($q, $pageToken);
    }

    /**
     * Search for YouTube videos by a query string.
     *
     * @param string $q         The query string
     * @param string $pageToken YouTube page token (e.g. for next/previous page)
     * @param int    $perPage   Number of results per page
     *
     * @return object|false
     */
    public function search($q, $pageToken = '', $perPage = 10)
    {
        if (!$this->enabled()) {
            return false;
        }

        $uri = sprintf('search?part=snippet&type=video&maxResults=%s&pageToken=%s&q=%s',
            $perPage,
            urlencode($pageToken),
            urlencode($q)
        );

        $cacheKey = md5("youtube_$uri");
        if ($response = Cache::get($cacheKey)) {
            return $response;
        }

        if ($response = $this->get($uri)) {
            // Cache the result for 7 days
            Cache::put($cacheKey, $response, 60 * 24 * 7);
        }

        return $response;
    }
}