如何用parse_url 提取YouTube 視頻ID？

gitbox 2025-05-29

在處理視頻鏈接時，尤其是像YouTube 這樣的平台，提取出視頻的唯一標識符（視頻ID）是很多應用場景中的常見需求。例如，當你希望將用戶提交的YouTube 鏈接嵌入到網頁中，或是用於保存到數據庫中時，僅保留視頻ID 會更加高效和一致。在PHP 中，我們可以使用內置的parse_url函數來實現這一功能。

本文將介紹如何通過parse_url結合其他函數，從YouTube 鏈接中提取出視頻ID。

1. YouTube 鏈接格式

在實際應用中，YouTube 的鏈接格式可能有以下幾種常見形式：

標準鏈接：

 https://www.youtube.com/watch?v=VIDEO_ID

短鏈接：
```
 https://youtu.be/VIDEO_ID
```

嵌入鏈接：

 https://www.youtube.com/embed/VIDEO_ID

2. 使用parse_url提取信息

parse_url函數可以將一個URL 分解為多個部分，如scheme、host、path、query 等。利用這一特性，我們可以很方便地對YouTube 鏈接進行分析。

 function extractYouTubeID($url) {
    $parsedUrl = parse_url($url);

    // 標準鏈接 https://www.youtube.com/watch?v=VIDEO_ID
    if (isset($parsedUrl['host']) && strpos($parsedUrl['host'], 'youtube.com') !== false) {
        if (isset($parsedUrl['path']) && $parsedUrl['path'] === '/watch') {
            if (isset($parsedUrl['query'])) {
                parse_str($parsedUrl['query'], $queryParams);
                if (isset($queryParams['v'])) {
                    return $queryParams['v'];
                }
            }
        }

        // 嵌入鏈接 https://www.youtube.com/embed/VIDEO_ID
        if (strpos($parsedUrl['path'], '/embed/') === 0) {
            return substr($parsedUrl['path'], strlen('/embed/'));
        }
    }

    // 短鏈接 https://youtu.be/VIDEO_ID
    if (isset($parsedUrl['host']) && $parsedUrl['host'] === 'youtu.be') {
        return ltrim($parsedUrl['path'], '/');
    }

    return null; // 無法識別的格式
}

3. 示例用法

$links = [
    'https://www.youtube.com/watch?v=abc123XYZ',
    'https://youtu.be/abc123XYZ',
    'https://www.youtube.com/embed/abc123XYZ',
    'https://gitbox.net/watch?v=abc123XYZ', // 非 YouTube 域名，應該返回 null
];

foreach ($links as $link) {
    $videoId = extractYouTubeID($link);
    echo "鏈接：$link\n";
    echo "影片 ID：" . ($videoId ?? '未識別') . "\n\n";
}

4. 注意事項

上述代碼已經考慮了三種常見的鏈接形式，但實際使用中可能還會遇到參數順序不同、附加了時間戳參數等情況。為了提高健壯性，可以對parse_str後的參數進行更多校驗。
替換域名或識別非YouTube 鏈接時要特別小心，確保僅對可信來源進行處理。

結語

通過parse_url和parse_str等內置函數，PHP 能夠高效地解析URL 並提取特定參數。這種方式不僅簡潔，而且具備良好的可維護性。將其封裝為一個通用函數，能夠在各種項目中復用，提升開發效率。