php 8.6输出固定本地文件时,可以解析单个bytes区间,调用fseek定位,再按剩余字节数循环读取。有效区间返回206和content-range;超出文件范围的区间返回416。下面仅实现单区间get下载,遇到多区间或不支持的语法时忽略range并返回完整文件,不把多个区间错误合并成一段。

PHP手册中的fseek定义
先确定可下载文件和区间
适用于64位PHP、稳定且可定位的普通文件。路径由业务白名单确定,并在输出前完成权限校验;文件不能在发送期间被原地改写。示例使用预先确定的下载类型,不从用户参数拼文件路径。
<?php $path = '/srv/downloads/guide.pdf';
$fh = fopen($path, 'rb');
if ($fh === false) throw new RuntimeException('无法打开下载文件');
$stat = fstat($fh);
if ($stat === false) throw new RuntimeException('无法读取文件信息');
$size = $stat['size']; $start = 0; $end = $size - 1; $partial = false;
$range = isset($_SERVER['HTTP_IF_RANGE']) ? '' : ($_SERVER['HTTP_RANGE'] ?? '');
if (is_string($range) && preg_match('/\Abytes=([0-9]*)-([0-9]*)\z/D', $range, $m)
&& ($m[1] !== '' || $m[2] !== '')) {
if (strlen($m[1]) > 18 || strlen($m[2]) > 18) {
http_response_code(416); header("Content-Range: bytes */$size"); exit;
}
if ($m[1] === '') {
$n = (int)$m[2]; $start = max(0, $size - $n);
if ($n === 0) $start = $size;
} else {
$start = (int)$m[1];
$end = $m[2] === '' ? $size - 1 : min((int)$m[2], $size - 1);
}
if ($size === 0 || $start >= $size || $start > $end) {
http_response_code(416); header("Content-Range: bytes */$size"); exit;
}
$partial = true;
}
$length = max(0, $end - $start + 1);
if ($start && fseek($fh, $start) !== 0) throw new RuntimeException('定位失败');
if ($partial) { http_response_code(206); header("Content-Range: bytes $start-$end/$size"); }
header('Content-Type: application/pdf');
header('Accept-Ranges: bytes');
header('Content-Length: '.$length);
while ($length > 0 && !connection_aborted()) {
$part = fread($fh, min(65536, $length));
if ($part === false || $part === '') break;
echo $part; $length -= strlen($part);
}
fclose($fh);

PHP手册中的fread定义
避免输出层改变实际字节
关闭此下载端点的压缩和额外页面输出,确保Content-Length与真正发送的字节一致。fread可能短读,循环应按实际返回长度扣减;文件读取中途失败后不能再改成新的JSON错误响应,应记录故障并让客户端重试。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
与条件请求保持一致
RFC 9110还定义了If-Range及多区间响应。示例未实现这些机制,因此不应当作完整下载服务器替代品:生产环境若收到If-Range,应交给支持条件范围处理的Web服务器,或忽略Range返回完整内容。大文件和高并发下载可优先交给Nginx等成熟静态文件服务。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










