萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 獲取 YouTube 與 Vimeo 視頻縮略圖:API 免費調用實戰

需求場景

在 CMS、編輯器、視頻聚合頁中,根據視頻鏈接自動獲取縮略圖展示,無需用戶手動上傳封面。YouTube 和 Vimeo 均提供免費無需密鑰的公開接口。

統一入口函數

/**
 * 根據視頻鏈接獲取縮略圖 URL
 * @param string $url YouTube/Vimeo 視頻鏈接
 * @return string|false 縮略圖 URL 或 false
 */
function video_image($url) {
    $parsed = parse_url($url);
    $host = strtolower($parsed['host'] ?? '');

    // YouTube 標準鏈接:youtube.com/watch?v=VIDEO_ID
    if (in_array($host, ['www.youtube.com', 'youtube.com'])) {
        parse_str($parsed['query'] ?? '', $query);
        $videoId = $query['v'] ?? '';
        if ($videoId) {
            return "https://img.youtube.com/vi/{$videoId}/0.jpg"; // 0.jpg = 最大尺寸 1280x720
        }
    }

    // YouTube 短鏈接:youtu.be/VIDEO_ID
    if (in_array($host, ['www.youtu.be', 'youtu.be'])) {
        $path = trim($parsed['path'], '/');
        if ($path) {
            return "https://img.youtube.com/vi/{$path}/0.jpg";
        }
    }

    // Vimeo:vimeo.com/VIDEO_ID
    if (in_array($host, ['www.vimeo.com', 'vimeo.com'])) {
        $videoId = ltrim($parsed['path'], '/');
        if ($videoId && is_numeric($videoId)) {
            // Vimeo 官方 oEmbed 接口(返回 JSON,含多種尺寸縮略圖)
            $api = "https://vimeo.com/api/oembed.json?url=" . urlencode($url);
            $json = @file_get_contents($api);
            if ($json) {
                $data = json_decode($json, true);
                return $data['thumbnail_url'] ?? false; // 返回默認縮略圖(640x360)
                // 如需指定尺寸:解析 thumbnail_width/height 或用 API v3.4(需 Token)
            }
        }
    }

    return false;
}

使用示例

<img src="<?php echo video_image('https://www.youtube.com/watch?v=dQw4w9WgXcQ'); ?>" alt="YouTube 縮略圖" />
<img src="<?php echo video_image('https://youtu.be/dQw4w9WgXcQ'); ?>" alt="YouTube 短鏈縮略圖" />
<img src="<?php echo video_image('https://vimeo.com/76979871'); ?>" alt="Vimeo 縮略圖" />

YouTube 縮略圖尺寸規則

URL 模式尺寸說明
/0.jpg1280×720最大尺寸(若視頻為 HD)
/1.jpg, /2.jpg, /3.jpg120×90三張不同幀的小圖
/mqdefault.jpg320×180中等質量
/hqdefault.jpg480×360高質量(推薦通用)
/sddefault.jpg640×480標準清晰度
/maxresdefault.jpg1920×1080最高分辨率(非所有視頻有)

Vimeo 進階:API v3.4(需 Access Token)

function vimeo_thumbnail_advanced($videoId, $accessToken, $size = '640x360') {
    $url = "https://api.vimeo.com/videos/{$videoId}/pictures";
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => ["Authorization: Bearer {$accessToken}"],
    ]);
    $resp = curl_exec($ch);
    curl_close($ch);
    $data = json_decode($resp, true);
    foreach ($data['data'] ?? [] as $pic) {
        if (isset($pic['sizes'])) {
            foreach ($pic['sizes'] as $s) {
                if ($s['width'] . 'x' . $s['height'] === $size) {
                    return $s['link'];
                }
            }
        }
    }
    return false;
}

緩存策略(強烈建議)

  • 縮略圖 URL 相對穩定,建議緩存 24 小時(Redis/File/數據庫)。
  • 避免每次頁面請求都發起外部 HTTP 請求(Vimeo oEmbed 尤其慢)。
  • 異步預熱:用戶提交鏈接時後台任務獲取並緩存。

總結

YouTube 縮略圖獲取極簡(固定 URL 模式),Vimeo 需調用 oEmbed 接口。封裝統一函數 + 緩存層,即可在項目中優雅地實現視頻鏈接轉封面圖功能。

copyright © 萬盛學電腦網 all rights reserved