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文檔