在 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 縮略圖" />
| URL 模式 | 尺寸 | 說明 |
|---|---|---|
/0.jpg | 1280×720 | 最大尺寸(若視頻為 HD) |
/1.jpg, /2.jpg, /3.jpg | 120×90 | 三張不同幀的小圖 |
/mqdefault.jpg | 320×180 | 中等質量 |
/hqdefault.jpg | 480×360 | 高質量(推薦通用) |
/sddefault.jpg | 640×480 | 標準清晰度 |
/maxresdefault.jpg | 1920×1080 | 最高分辨率(非所有視頻有) |
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;
}
YouTube 縮略圖獲取極簡(固定 URL 模式),Vimeo 需調用 oEmbed 接口。封裝統一函數 + 緩存層,即可在項目中優雅地實現視頻鏈接轉封面圖功能。