azaw/yt-toolkit

Youtube toolkit

v1.0.4 2026-04-04 14:17 UTC

Requires

• php: >=8.4
• symfony/framework-bundle: ^5.4 || ^6.0 || ^7.0 || ^8.0
• symfony/http-client-contracts: ^3.0

Requires (Dev)

• phpunit/phpunit: ^13.1
• symfony/var-dumper: ^5.4 || ^6.0 || ^7.0 || ^8.0

MIT

README

A Symfony bundle for interacting with the YouTube Data API v3.

Installation

composer require azaw/yt-toolkit

Register the bundle in config/bundles.php:

return [
    YtToolkit\YtToolkitPackBundle::class => ['all' => true],
];

Configuration

Set your YouTube Data API key as an environment variable:

YOUTUBE_API_KEY=your_api_key_here

The default YoutubeClientSecretProvider reads $_ENV['YOUTUBE_API_KEY']. To use a custom source, implement YoutubeClientSecretProviderInterface and bind it as the alias in your app's service configuration:

services:
  YtToolkit\Contracts\YoutubeClientSecretProviderInterface:
    alias: App\YourCustomSecretProvider

Services

FetchVideosService

Fetches videos from a YouTube channel.

use YtToolkit\Service\FetchVideosService;

$response = $fetchVideosService->fetchVideos(
    channelId: 'UCxxxxxxxxxxxxxxxxxxxxxx',
    maxResults: 25,        // optional, default 25
    pageToken: null,       // optional, for pagination
);

// $response is VideoSearchListResponse
foreach ($response->items as $result) {
    echo $result->id->videoId;
}

// Paginate
$nextPage = $fetchVideosService->fetchVideos('UCxxx', pageToken: $response->nextPageToken);

FetchChannelService

Fetches a channel by its handle (e.g. @channelname).

use YtToolkit\Service\FetchChannelService;

$response = $fetchChannelService->fetchChannelByHandle('@channelname');

// $response is ChannelListResponse
foreach ($response->items as $channel) {
    echo $channel->id;
}

YoutubeParser

Extracts a YouTube video ID from various URL formats (standard, short, embed, live).

use YtToolkit\Parser\YoutubeParser;

$parser = new YoutubeParser();

$videoId = $parser->getCodeFromLink('https://www.youtube.com/watch?v=dQw4w9WgXcQ');
// 'dQw4w9WgXcQ'

$videoId = $parser->getCodeFromLink('https://youtu.be/dQw4w9WgXcQ');
// 'dQw4w9WgXcQ'

$videoId = $parser->getCodeFromLink('https://www.youtube.com/embed/dQw4w9WgXcQ');
// 'dQw4w9WgXcQ'

$videoId = $parser->getCodeFromLink('https://www.youtube.com/live/dQw4w9WgXcQ');
// 'dQw4w9WgXcQ'

Returns null if no video ID is found.