ytdl php

YT-DL PHP

مكتبة PHP بسيطة لتنزيل مقاطع الفيديو من YouTube و Instagram و X والمزيد. مدعوم من الكوبالت

مدعوم من الكوبالت

تعتمد هذه المكتبة على واجهة برمجة تطبيقات الكوبالت المجانية.

• رمز الكوبالت: مستودع جيثب
• موقع الكوبالت: أدوات الكوبالت
• مستندات Cobalt 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 (سلسلة): جودة الفيديو المطلوبة (على سبيل المثال ، 144 ، 720 ، 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

يتيح تحويل صور GIF Twitter إلى .gif.

enableTiktokH265(): void

يتيح تفضيل مقاطع الفيديو 1080p H265 لـ Tiktok.

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 Cobalt - متغيرات عنصر Picker

الخدمات المدعومة

هذه القائمة ليست نهائية وتستمر في التوسع بمرور الوقت.

خدمة	فيديو + صوت	فقط الصوت	فيديو فقط	بيانات التعريف	أسماء الملفات الغنية
bilibili.com و bilibili.tv	✅	✅	✅	➖	➖
dailymotion	✅	✅	✅	✅	✅
منشورات Instagram والبكرات	✅	✅	✅	➖	➖
مقاطع فيديو Facebook	✅			➖	➖
تلوح في الأفق	✅		✅	✅	➖
موافق الفيديو	✅		✅	✅	✅
بينتيريست	✅	✅	✅	➖	➖
رديت	✅	✅	✅
الروب	✅	✅	✅	✅	✅
قصص Snapchat وأضواء كاشفة	✅	✅	✅	➖	➖
SoundCloud	➖	✅	➖	✅	✅
قابلية للتدفق	✅	✅	✅	➖	➖
تيخوك	✅	✅	✅
نعرفكم	✅	✅	✅	➖	➖
تشنج مقاطع	✅	✅	✅	✅	✅
Twitter/X.	✅	✅	✅	➖	➖
Vimeo	✅	✅	✅	✅	✅
أرشيف كرمة	✅	✅	✅	➖	➖
VK مقاطع فيديو ومقاطع	✅		✅	✅	✅
مقاطع فيديو يوتيوب ، شورتات وموسيقى	✅	✅	✅	✅	✅

الرموز التعبيرية	معنى
✅	مدعوم
➖	مستحيل/غير معقول
	غير مدعوم

المصدر: الكوبالت - الخدمات المدعومة

ملاحظات أو ميزات إضافية

خدمة	ملاحظات أو ميزات
Instagram	يدعم البكرات والصور ومقاطع الفيديو. يتيح لك اختيار ما يمكنك حفظه من منشورات الوسائط المتعددة.
فيسبوك	يدعم محتوى مقاطع الفيديو التي يمكن الوصول إليها العامة فقط.
بينتيريست	يدعم الصور والصور المتحركة ومقاطع الفيديو والقصص.
رديت	يدعم صور GIF ومقاطع الفيديو.
Snapchat	يدعم الأضواء والقصص. يتيح لك اختيار ما تحفظه من القصص.
الروب	يدعم روابط Yappy و Private.
SoundCloud	يدعم الروابط الخاصة.
تيخوك	يدعم مقاطع الفيديو مع أو بدون علامة مائية ، وصور من عرض الشرائح بدون علامة مائية ، و Audios الكاملة (الأصلية).
Twitter/X.	يتيح لك اختيار ما يمكنك حفظه من منشورات الوسائط المتعددة. قد لا تكون موثوقة بنسبة 100 ٪ بسبب الإدارة الحالية.
Vimeo	التنزيلات الصوتية متاحة فقط ل DASH.
يوتيوب	يدعم مقاطع الفيديو والموسيقى والسراويل القصيرة. 8K ، 4K ، HDR ، VR ، و HIVE FPS Videos. البيانات الوصفية الغنية و dubs. H264/AV1/VP9 برامج الترميز.

المصدر: الكوبالت - ملاحظات أو ميزات إضافية لكل خدمة

إذا كان الدعم للخدمة التي تريدها مفقودة ، فقم بإنشاء مشكلة (أو طلب سحب؟) على مستودع GitHub Cobalt.

رخصة

هذه المكتبة مرخصة بموجب ترخيص معهد ماساتشوستس للتكنولوجيا. انظر ملف الترخيص لمزيد من التفاصيل.

اتصال

للحصول على أي استفسارات أو مشكلات ، يرجى الاتصال:

• الاسم: حسين بيرا
• البريد الإلكتروني: [email protected]
• Instagram : @h3dev.pira
• Telegram: @H3Dev

مراجع

• رمز الكوبالت: مستودع جيثب
• موقع الكوبالت: أدوات الكوبالت
• مستندات Cobalt API: وثائق API