ytdl php

YT-DL php

一个简单的PHP库，用于从YouTube，Instagram，X等下载视频。由钴提供动力

由钴提供动力

该图书馆依靠钴的免费API。

• 钴代码： GitHub存储库
• 钴网站：钴工具
• 钴API文档： API文档

目录

• 安装
• 用法
• 方法
• 响应身体变量
• 选择器项目变量
• 支持的服务
• 执照
• 接触

安装

要安装pira/ytdl库，您需要使用Composer。运行以下命令：

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)

用URL初始化YTDL类。

• 参数：
  • $url （字符串）：要在请求中使用的URL。

setQuality(string $quality): void

设置视频质量以供下载。

• 参数：
  • $quality （字符串）：所需720 144 max ）。
• 扔：
  • Exception如果提供的质量无效。

setFilenamePattern(string $pattern): void

为下载文件设置文件名模式。

• 参数：
  • $pattern （字符串）：所需的文件名模式。可用模式：
    • 经典的：
      • 视频： youtube_dQw4w9WgXcQ_640x360_h264.mp4
      • 音频： youtube_dQw4w9WgXcQ_audio.mp3
    • 基本的：
      • 视频： Video Title (360p, h264).mp4
      • 音频： Audio Title - Audio Author.mp3
    • 漂亮的：
      • 视频： Video Title (360p, h264, youtube).mp4
      • 音频： Audio Title - Audio Author (soundcloud).mp3
    • 书呆子：
      • 视频： Video Title (360p, h264, youtube, dQw4w9WgXcQ).mp4
      • 音频： Audio Title - Audio Author (soundcloud, 1242868615).mp3
• 扔：
  • Exception如果提供的模式无效。

setVCodec(string $codec): void

将视频编解码器设置为下载。

• 参数：
  • $codec （字符串）：所需的视频编解码器（例如， h264 ， av1 ， vp9 ）。
• 扔：
  • Exception如果提供的编解码器无效。

setAFormat(string $format): void

设置音频格式以供下载。

• 参数：
  • $format （字符串）：所需的音频格式（例如， mp3 ， ogg ， wav ）。
• 扔：
  • Exception如果提供的格式无效。

enableAudioOnly(): void

启用仅下载音频。

enableTTFullAudio(): void

启用从Tiktok视频下载原始声音。

enableAudioMuted(): void

在视频下载中启用音频曲目。

enableDubLang(): void

启用YouTube视频音轨的接受语言标头。

enableDisableMetadata(): void

启用禁用文件元数据。

enableTwitterGif(): void

启用将Twitter GIF转换为.gif格式。

enableTiktokH265(): void

启用偏爱Tiktok的1080p H265视频。

setAcceptLanguage(string $language): void

为请求设置自定义接受语言标题值。

• 参数：
  • $language （字符串）：自定义接受语言标题值。

sendRequest(): array

将配置的请求发送到API并返回响应。

• 返回：

  • 一个包含响应状态和数据的关联阵列。

• 扔：

  • 如果发送请求有错误， Exception 。

响应身体变量

钥匙	类型	变量
status	string	error / redirect / stream / success / rate-limit / picker
text	string	各种文字，主要用于错误
url	string	直接链接到文件或链接到钴实时渲染
pickerType	string	various / images
picker	array	一系列采摘物品
audio	string	直接链接到文件或链接到钴实时渲染

资料来源：钴API文档 - 响应身体变量

选择器项目变量

项目类型： object

钥匙	类型	变量	描述
type	string	video / photo / gif	仅当pickerType是various
url	string	直接链接到文件或链接到钴实时渲染
thumb	string	项目缩略图显示在选择器中	用于video和gif类型

资料来源：钴API文档 - 选择器项目变量

支持的服务

此列表不是最终的，并且会随着时间的推移而不断扩展。

服务	视频 +音频	只有音频	只有视频	元数据	丰富的文件名
bilibili.com＆bilibili.tv	✅	✅	✅	➖	➖
Dailymotion	✅	✅	✅	✅	✅
Instagram帖子和卷轴	✅	✅	✅	➖	➖
Facebook视频	✅			➖	➖
织机	✅		✅	✅	➖
好的视频	✅		✅	✅	✅
Pinterest	✅	✅	✅	➖	➖
reddit	✅	✅	✅
rutube	✅	✅	✅	✅	✅
Snapchat的故事和聚光灯	✅	✅	✅	➖	➖
Soundcloud	➖	✅	➖	✅	✅
流媒体	✅	✅	✅	➖	➖
蒂克托克	✅	✅	✅
tumblr	✅	✅	✅	➖	➖
抽搐剪辑	✅	✅	✅	✅	✅
Twitter/x	✅	✅	✅	➖	➖
Vimeo	✅	✅	✅	✅	✅
藤档案	✅	✅	✅	➖	➖
VK视频和剪辑	✅		✅	✅	✅
YouTube视频，短裤和音乐	✅	✅	✅	✅	✅

表情符号	意义
✅	支持
➖	不可能/不合理
	不支持

资料来源：钴 - 支持服务

附加笔记或功能

服务	笔记或功能
Instagram	支持卷轴，照片和视频。让您从多媒体帖子中选择要保存的内容。
Facebook	仅支持公共访问的视频内容。
Pinterest	支持照片，GIF，视频和故事。
reddit	支持GIF和视频。
Snapchat	支持聚光灯和故事。让您从故事中选择要保存的内容。
rutube	支持Yappy＆私人链接。
Soundcloud	支持私人链接。
蒂克托克	支持带有或没有水印的视频，来自无水印的幻灯片的图像以及完整的（原始）音频。
Twitter/x	让您从多媒体帖子中选择要保存的内容。由于当前管理，可能不会100％可靠。
Vimeo	音频下载仅可用于破折号。
YouTube	支持视频，音乐和短裤。 8K，4K，HDR，VR和高FPS视频。丰富的元数据和配音。 H264/AV1/VP9编解码器。

资料来源：钴 - 每个服务的其他笔记或功能

如果缺少您想要的服务的支持，请在Cobalt的GitHub存储库上创建问题（或拉动请求？）。

执照

该图书馆已获得MIT许可证的许可。有关更多详细信息，请参见许可证文件。

接触

有关任何查询或问题，请联系：

• 名称： Hossein Pira
• 电子邮件： [email protected]
• Instagram ： @h3dev.pira
• 电报： @H3DEV

参考

• 钴代码： GitHub存储库
• 钴网站：钴工具
• 钴API文档： API文档