PHP 实现 HTTP Range 协议支持文件断点续传与分段下载

<?php
// 获取请求的文件名
$filename = $_GET['filename'];

// 构建服务器端文件路径（建议根据实际安全规范限制目录）
$location = 'media/' . $filename;

// 获取后缀以设定 MIME 类型
$extension = substr(strrchr($filename, '.'), 1);
if ($extension == "mp3") {
    $mimeType = "audio/mpeg";
} else if ($extension == "ogg") {
    $mimeType = "audio/ogg";
} else {
    // 默认 fallback
    $mimeType = "application/octet-stream";
}

// 1. 检查文件是否存在
if (!file_exists($location)) {
    header("HTTP/1.1 404 Not Found");
    return;
}

// 获取文件大小和修改时间
$size = filesize($location);
$time = date('r', filemtime($location));

// 2. 打开文件句柄
$fm = @fopen($location, 'rb');
if (!$fm) {
    header("HTTP/1.1 505 Internal server error");
    return;
}

// 3. 初始化范围边界
$begin = 0;
$end = $size - 1;

// 4. 解析 HTTP_RANGE 请求头
if (isset($_SERVER['HTTP_RANGE'])) {
    // 匹配格式：bytes=start-end 或 bytes=start-
    if (preg_match('/bytes=\h*(\d+)-(\d*)[\D.*]?/i', $_SERVER['HTTP_RANGE'], $matches)) {
        $begin = intval($matches[1]);
        
        // 如果指定了结束位置，则使用之；否则默认为文件末尾
        if (!empty($matches[2])) {
            $end = intval($matches[2]);
        }
    }
}

// 5. 设置状态码：有 Range 为 206，否则为 200 OK
if (isset($_SERVER['HTTP_RANGE'])) {
    header('HTTP/1.1 206 Partial Content');
} else {
    header('HTTP/1.1 200 OK');
}

// 6. 设置必要的响应头部
header("Content-Type: $mimeType");
header('Cache-Control: public, must-revalidate, max-age=0');
header('Pragma: no-cache');
header('Accept-Ranges: bytes');

// 计算本次实际输出的长度
$contentLength = ($end - $begin) + 1;
header('Content-Length: ' . $contentLength);

if (isset($_SERVER['HTTP_RANGE'])) {
    header("Content-Range: bytes $begin-$end/$size");
}

header("Content-Disposition: inline; filename=$filename");
header("Content-Transfer-Encoding: binary");
header("Last-Modified: $time");

// 7. 定位文件指针并开始读取
$cur = $begin;
fseek($fm, $begin, 0);

// 循环读取并输出，直到达到结束位置或连接断开
// connection_status() == 0 表示客户端连接正常
while (!feof($fm) && $cur <= $end && (connection_status() == 0)) {
    // 每次读取 16KB 或剩余所需字节数，防止内存溢出
    $readLength = min(1024 * 16, ($end - $cur) + 1);
    print fread($fm, $readLength);
    $cur += $readLength;
    
    // 可选：适当休眠以避免占用过多 CPU
    // usleep(1000); 
}

fclose($fm);
?>