ytdl php

YT-DL PHP

Простая библиотека PHP для загрузки видео с YouTube, Instagram, X и других. Питается кобальтом

Питается кобальтом

Эта библиотека опирается на бесплатный API Кобальта.

• Кобальт -код: репозиторий GitHub
• Сайт кобальта: инструменты кобальта
• Кобальтовые документы API: документация API

Оглавление

• Установка
• Использование
• Методы
• Переменные тела ответа
• Элемент сборщика переменных
• Поддерживаемые услуги
• Лицензия
• Контакт

Установка

Чтобы установить библиотеку pira/ytdl , вам необходимо использовать композитор. Запустите следующую команду:

composer require pira/ytdl

Использование

После установки библиотеки вы можете начать использовать ее в своем проекте PHP. Вот основной пример:

 <?php

use pira  YTDL ;

require_once ' vendor/autoload.php ' ;

try {
    $ ytdl = new YTDL ( ' https://www.youtube.com/watch?v=OAr6AIvH9VY ' );
    $ ytdl -> setQuality ( ' 480 ' );
    $ response = $ ytdl -> sendRequest ();
    print_r ( $ response );
} catch ( Exception $ e ) {
    echo $ e -> getMessage ();
}

Методы

__construct(string $url)

Инициализирует класс YTDL с помощью URL.

• Параметры:
  • $url (строка): URL, который будет использоваться в запросах.

setQuality(string $quality): void

Устанавливает качество видео для загрузки.

• Параметры:
  • $quality (String): желаемое качество видео (например, 144 , 720 , max ).
• Бросает:
  • Exception , если предоставленное качество не является действительным.

setFilenamePattern(string $pattern): void

Устанавливает шаблон имени файла для загруженных файлов.

• Параметры:
  • $pattern (строка): желаемый шаблон имени файла. Доступные шаблоны:
    • Классика:
      • Видео: youtube_dQw4w9WgXcQ_640x360_h264.mp4
      • Audio: youtube_dQw4w9WgXcQ_audio.mp3
    • базовый:
      • Видео: Video Title (360p, h264).mp4
      • Audio: Audio Title - Audio Author.mp3
    • симпатичный:
      • Видео: Video Title (360p, h264, youtube).mp4
      • Audio: Audio Title - Audio Author (soundcloud).mp3
    • зануд:
      • Видео: Video Title (360p, h264, youtube, dQw4w9WgXcQ).mp4
      • Audio: Audio Title - Audio Author (soundcloud, 1242868615).mp3
• Бросает:
  • Exception если предоставленный шаблон недопустим.

setVCodec(string $codec): void

Устанавливает видеокодек для загрузки.

• Параметры:
  • $codec (String): желаемый видеокодек (например, h264 , av1 , vp9 ).
• Бросает:
  • Exception , если предоставленный кодек не является действительным.

setAFormat(string $format): void

Устанавливает аудиоформат для загрузки.

• Параметры:
  • $format (String): желаемый аудио -формат (например, mp3 , ogg , wav ).
• Бросает:
  • Exception , если предоставленный формат не является действительным.

enableAudioOnly(): void

Позволяет загружать только аудио.

enableTTFullAudio(): void

Позволяет загрузить оригинальный звук из видео Tiktok.

enableAudioMuted(): void

Позволяет приглушить аудио -трек в загрузке видео.

enableDubLang(): void

Включает использование заголовка Accept Language для видео аудио-аудио YouTube.

enableDisableMetadata(): void

Позволяет отключить метаданные файла.

enableTwitterGif(): void

Позволяет конвертировать GIF -файлы в формате .gif.

enableTiktokH265(): void

Включите предпочтение 1080p H265 видео для Tiktok.

setAcceptLanguage(string $language): void

Устанавливает пользовательское значение заголовка на уровне приема для запросов.

• Параметры:
  • $language (String): пользовательская стоимость заголовка на индивидуальном языке.

sendRequest(): array

Отправляет настроенный запрос в API и возвращает ответ.

• Возвращает:

  • Ассоциативный массив, содержащий статус и данные ответа.

• Бросает:

  • Exception , если есть ошибка при отправке запроса.

Переменные тела ответа

ключ	тип	переменные
status	string	error / redirect / stream / success / rate-limit / picker
text	string	Различный текст, в основном используется для ошибок
url	string	Прямая ссылка на файл или ссылка на живое рендеринг Cobalt
pickerType	string	various / images
picker	array	множество предметов
audio	string	Прямая ссылка на файл или ссылка на живое рендеринг Cobalt

Источник: документация по API кобальта - переменные тела ответа

Элемент сборщика переменных

Тип элемента: object

ключ	тип	переменные	описание
type	string	video / photo / gif	Используется только в том случае, если pickerType various
url	string	Прямая ссылка на файл или ссылка на живое рендеринг Cobalt
thumb	string	Миниатюра предмета, отображаемая в сборщике	используется для video и типов gif

Источник: документация по API Cobalt - переменные элемента сбора

Поддерживаемые услуги

Этот список не является окончательным и продолжает расширяться с течением времени.

услуга	Видео + аудио	только аудио	только видео	метаданные	богатые имена файлов
bilibili.com & bilibili.tv	✅	✅	✅	➖	➖
Dailymotion	✅	✅	✅	✅	✅
Instagram посты и барабаны	✅	✅	✅	➖	➖
Видео в Facebook	✅			➖	➖
ткацкий станок	✅		✅	✅	➖
ОК	✅		✅	✅	✅
Pinterest	✅	✅	✅	➖	➖
Reddit	✅	✅	✅
Рутуб	✅	✅	✅	✅	✅
Snapchat Stories & Spotlights	✅	✅	✅	➖	➖
SoundCloud	➖	✅	➖	✅	✅
потоковой	✅	✅	✅	➖	➖
Тикток	✅	✅	✅
Tumblr	✅	✅	✅	➖	➖
Twitch Clips	✅	✅	✅	✅	✅
Twitter/x	✅	✅	✅	➖	➖
Vimeo	✅	✅	✅	✅	✅
Vine Archive	✅	✅	✅	➖	➖
VK видео и клипы	✅		✅	✅	✅
Видео, шорты и музыка на YouTube	✅	✅	✅	✅	✅

эмодзи	значение
✅	Поддерживается
➖	невозможно/неразумно
	не поддерживается

Источник: Cobalt - поддерживаемые услуги

Дополнительные заметки или функции

услуга	примечания или функции
Instagram	Поддерживает барабаны, фотографии и видео. Позволяет выбрать, что сохранить из мультимедийных постов.
Facebook	Поддерживает только общедоступные доступные видео контент.
Pinterest	Поддерживает фотографии, GIF, видео и истории.
Reddit	Поддерживает GIF и видео.
Snapchat	Поддерживает прожекторы и истории. Позволяет выбрать, что спасти из историй.
Рутуб	Поддерживает Yappy & Private ссылки.
SoundCloud	Поддерживает частные ссылки.
Тикток	Поддерживает видео с водяным знаком или без водяного знака, изображений из слайд -шоу без водяного знака и полных (оригинальных) звуков.
Twitter/x	Позволяет выбрать, что сохранить из мультимедийных постов. Не может быть на 100% надежным из -за текущего управления.
Vimeo	Аудио загрузки доступны только для DASH.
YouTube	Поддерживает видео, музыку и шорты. 8K, 4K, HDR, VR и High FPS. Богатые метаданные и дубинг. H264/AV1/VP9 Кодеки.

Источник: кобальт - дополнительные заметки или функции на услугу

Если поддержка желаемой услуги отсутствует, создайте проблему (или запрос на притяжение?) В репозитории Github Cobalt.

Лицензия

Эта библиотека лицензирована по лицензии MIT. Смотрите файл лицензии для получения более подробной информации.

Контакт

По любым вопросам или проблемам, пожалуйста, свяжитесь:

• Имя: Хоссейн Пира
• Электронная почта: [email protected]
• Instagram : @h3dev.pira
• Телеграмма: @H3DEV

Ссылки

• Кобальт -код: репозиторий GitHub
• Сайт кобальта: инструменты кобальта
• Кобальтовые документы API: документация API