Youtube
Laravel PHP Facade/Wrapper for the Youtube Data API v3 ( Non-OAuth )
Requirements
- PHP 7.0 or higher
- Laravel 5.1 or higher
- API key from Google Console
Looking for Youtube Package for either of these: PHP 5, Laravel 5.0, Laravel 4? Visit the php5-branch
Installation
Run in console below command to download package to your project:
composer require alaouy/youtube
Configuration
In /config/app.php
add YoutubeServiceProvider (Laravel < 5.5):
Alaouy\Youtube\YoutubeServiceProvider::class,
Do not forget to add also Youtube facade there (Laravel < 5.5):
'Youtube' => Alaouy\Youtube\Facades\Youtube::class,
Publish config settings:
$ php artisan vendor:publish --provider="Alaouy\Youtube\YoutubeServiceProvider"
Set your Youtube API key in the file:
/config/youtube.php
Or in the .env file
YOUTUBE_API_KEY = KEY
Or you can set the key programmatically at run time :
Youtube::setApiKey('KEY');
Usage
// use Alaouy\Youtube\Facades\Youtube;
// Return an STD PHP object
$video = Youtube::getVideoInfo('rie-hPVJ7Sw');
// Get multiple videos info from an array
$videoList = Youtube::getVideoInfo(['rie-hPVJ7Sw','iKHTawgyKWQ']);
// Get localized video info
$video = Youtube::getLocalizedVideoInfo('vjF9GgrY9c0', 'pl');
// Get multiple videos related to a video
$relatedVideos = Youtube::getRelatedVideos('iKHTawgyKWQ');
// Get comment threads by videoId
$commentThreads = Youtube::getCommentThreadsByVideoId('zwiUB_Lh3iA');
// Get popular videos in a country, return an array of PHP objects
$videoList = Youtube::getPopularVideos('us');
// Search playlists, channels and videos. return an array of PHP objects
$results = Youtube::search('Android');
// Only search videos, return an array of PHP objects
$videoList = Youtube::searchVideos('Android');
// Search only videos in a given channel, return an array of PHP objects
$videoList = Youtube::searchChannelVideos('keyword', 'UCk1SpWNzOs4MYmr0uICEntg', 40);
// List videos in a given channel, return an array of PHP objects
$videoList = Youtube::listChannelVideos('UCk1SpWNzOs4MYmr0uICEntg', 40);
$results = Youtube::searchAdvanced([ /* params */ ]);
// Get channel data by channel name, return an STD PHP object
$channel = Youtube::getChannelByName('xdadevelopers');
// Get channel data by channel ID, return an STD PHP object
$channel = Youtube::getChannelById('UCk1SpWNzOs4MYmr0uICEntg');
// Get playlist by ID, return an STD PHP object
$playlist = Youtube::getPlaylistById('PL590L5WQmH8fJ54F369BLDSqIwcs-TCfs');
// Get playlists by multiple ID's, return an array of STD PHP objects
$playlists = Youtube::getPlaylistById(['PL590L5WQmH8fJ54F369BLDSqIwcs-TCfs', 'PL590L5WQmH8cUsRyHkk1cPGxW0j5kmhm0']);
// Get playlist by channel ID, return an array of PHP objects
$playlists = Youtube::getPlaylistsByChannelId('UCk1SpWNzOs4MYmr0uICEntg');
// Get items in a playlist by playlist ID, return an array of PHP objects
$playlistItems = Youtube::getPlaylistItemsByPlaylistId('PL590L5WQmH8fJ54F369BLDSqIwcs-TCfs');
// Get channel activities by channel ID, return an array of PHP objects
$activities = Youtube::getActivitiesByChannelId('UCk1SpWNzOs4MYmr0uICEntg');
// Retrieve video ID from original YouTube URL
$videoId = Youtube::parseVidFromURL('https://www.youtube.com/watch?v=moSFlvxnbgk');
// result: moSFlvxnbgk
Validation Rules
// use Alaouy\Youtube\Rules\ValidYoutubeVideo;
// Validate a YouTube Video URL
[
'youtube_video_url' => ['bail', 'required', new ValidYoutubeVideo]
];
You can use the bail rule in conjunction with this in order to prevent unnecessary queries.
Basic Search Pagination
// Set default parameters
$params = [
'q' => 'Android',
'type' => 'video',
'part' => 'id, snippet',
'maxResults' => 50
];
// Make intial call. with second argument to reveal page info such as page tokens
$search = Youtube::searchAdvanced($params, true);
// Check if we have a pageToken
if (isset($search['info']['nextPageToken'])) {
$params['pageToken'] = $search['info']['nextPageToken'];
}
// Make another call and repeat
$search = Youtube::searchAdvanced($params, true);
// Add results key with info parameter set
print_r($search['results']);
/* Alternative approach with new built-in paginateResults function */
// Same params as before
$params = [
'q' => 'Android',
'type' => 'video',
'part' => 'id, snippet',
'maxResults' => 50
];
// An array to store page tokens so we can go back and forth
$pageTokens = [];
// Make inital search
$search = Youtube::paginateResults($params, null);
// Store token
$pageTokens[] = $search['info']['nextPageToken'];
// Go to next page in result
$search = Youtube::paginateResults($params, $pageTokens[0]);
// Store token
$pageTokens[] = $search['info']['nextPageToken'];
// Go to next page in result
$search = Youtube::paginateResults($params, $pageTokens[1]);
// Store token
$pageTokens[] = $search['info']['nextPageToken'];
// Go back a page
$search = Youtube::paginateResults($params, $pageTokens[0]);
// Add results key with info parameter set
print_r($search['results']);
The pagination above is quite basic. Depending on what you are trying to achieve you may want to create a recursive function that traverses the results.
Manual Class Instantiation
// Directly call the YouTube constructor
$youtube = new Youtube(config('YOUTUBE_API_KEY'));
// By default, if the $_SERVER['HTTP_HOST'] header is set,
// it will be used as the `Referer` header. To override
// this setting, set 'use-http-host' to false during
// object construction:
$youtube = new Youtube(config('YOUTUBE_API_KEY'), ['use-http-host' => false]);
// This setting can also be set after the object was created
$youtube->useHttpHost(false);
Run Unit Test
If you have PHPUnit installed in your environment, run:
$ phpunit
If you don't have PHPUnit installed, you can run the following:
$ composer update
$ ./vendor/bin/phpunit
Format of returned data
The returned JSON is decoded as PHP objects (not Array). Please read the "Reference" section of the Official API doc.
Youtube Data API v3
Donation
If you find this project to be of use to you please consider buying me a cup of tea :)
Credits
Built on code from Madcoda's php-youtube-api.