php 强制下载文件时，默认情况下不会进行限速，文件会以服务器网络带宽和磁盘 i/o 的最大速度传输。若需实现每秒限制特定 kb 数（如 100kb），必须通过 php 代码手动控制输出缓冲区的刷新频率，即计算每发送指定字节数后暂停执行的时间，从而模拟出稳定的传输速率。
readfile() 能否直接设置下载限速
不能。readfile() 函数是 PHP 中用于读取文件并直接输出到输出缓冲区的内置函数，它底层依赖于操作系统的系统调用，一旦启动就会尽可能快地将数据块写入缓冲区并发送给客户端，中间没有任何钩子或参数允许开发者插入延时逻辑。因此，使用 readfile() 无法实现任何形式的流量整形或限速功能，它仅适用于需要快速、完整传输且不关心速度的场景。
$file = 'example.zip'; header('Content-Type: application/octet-stream'); header('Content-Disposition: attachment; filename="' . basename($file) . '"'); readfile($file);
上述代码执行后，浏览器会立即下载 example.zip，但下载速度取决于服务器出口带宽，可能瞬间跑满带宽导致其他服务受影响，且无法控制在每秒 100KB 等具体数值。
立即学习“PHP免费学习笔记（深入）”；
如何通过 fpassthru() 实现精确限速
要实现限速，应放弃 readfile()，改用 fopen() 打开文件句柄，配合 fread() 分块读取和 echo 输出，并在每次输出后根据设定的速率计算休眠时间。核心逻辑是：设定目标速率（如 100KB/s），设定每次读取的块大小（如 8KB），计算发送完一块数据后需要等待的时间间隔，然后调用 usleep() 暂停脚本执行，直到下一个时间片到来再发送下一块数据。
$file = 'example.zip';
$rate = 100 * 1024; // 100 KB/s
$chunkSize = 8 * 1024; // 8 KB per chunk
$handle = fopen($file, 'r');
if ($handle) {
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . basename($file) . '"');
while (!feof($handle)) {
$data = fread($handle, $chunkSize);
if ($data === false) break;
echo $data;
flush(); // 强制刷新输出缓冲区
usleep(($chunkSize / $rate) * 1000000); // 计算并休眠
}
fclose($handle);
}
该程序首先定义限速为 100KB/s，块大小为 8KB。在循环中，每次读取 8KB 数据后立即输出并刷新缓冲区，确保客户端能收到数据。随后计算休眠时间：(8KB / 100KB/s) * 1,000,000 微秒 = 80,000 微秒（即 80ms）。这样每 80ms 发送 8KB，平均速率即为 100KB/s。预期结果是下载进度条缓慢推进，网络监控显示稳定在 100KB/s 左右，不会突发高峰。
当文件大小不能被块大小整除时的处理结果
当文件大小不能被设定的块大小（如 8KB）整除时，最后一次 fread() 返回的数据量会小于块大小，例如剩余 4KB。此时程序依然会输出这 4KB 数据，并执行一次 usleep() 休眠。由于休眠时间是基于完整的块大小计算的，最后这一小段数据的发送会被“拉长”到与前一个块相同的时间间隔内完成，导致最后几 KB 的瞬时速率低于设定值，但整体平均速率仍接近目标限速。这种处理方式保证了代码逻辑的一致性，无需特殊判断，因为 feof() 会在最后一次读取后正确终止循环，不会导致错误或无限循环。
