PHP实现文件下载限速代码示例

核心逻辑与原理

实现文件限速的关键在于“读一块、发一块、停一会儿”。具体技术要点如下：

• 数据块读取：不一次性将所有内容加载到内存中，而是使用 fread 分段读取，配合 echo 即时输出。
• 缓冲区刷新：调用 flush() 确保服务器缓存中的数据立即发送给客户端浏览器，避免累积等待。
• 节奏控制：利用 sleep(1) 强制暂停一秒，从而在宏观上控制每秒输出的字节总量，达到限速目的。
• 安全性保证：通过计算文件大小并正确设置HTTP头部，确保下载文件的完整性，哈希值与原文件一致。

准备工作

在使用本代码前，请注意以下环境参数：

1. 内存限制：如果下载的大文件导致报错（如 Fatal error: Allowed memory size exhausted），请检查php.ini中的 memory_limit 配置。$kilobyte 参数不宜设置过大，建议保持在合理范围内。
2. 带宽影响：若实际限速效果低于预期，请排查云服务器本身的带宽上限或中间网络链路状况。
3. 强制下载：由于设置了 Content-Disposition: attachment 响应头，所有使用该函数的文件均会触发浏览器的下载行为，而非直接在页面预览。

实现步骤

第1步：定义限速下载函数

目的：创建一个封装好的PHP函数，支持指定文件路径、目标速度和自定义文件名。

入口：在项目公共文件（如 functions.php）或控制器中引入此代码。

动作：复制以下代码段。注意，该函数未内置文件存在性校验，调用前需自行判断文件是否存在。

/**
 * @function 自定义文件下载速度
 * @param    $file_path string 文件绝对路径
 * @param    $kilobyte  int    每秒发送多少千字节数据（有波动）
 * @param    $file_name string 自定义下载文件名（无需后缀）
 * @return   void
 */
function speedLimitedDownload($file_path, $kilobyte = 1024, $file_name = '') {
    // 1. 获取文件信息
    $file_info = pathinfo($file_path);
    
    // 2. 设置 HTTP 响应头
    // 强制触发下载对话框
    header('Content-Disposition:attachment; filename="'. ($file_name ? $file_name . '.' . $file_info['extension'] : $file_info['basename']) . '"');
    // 声明 MIME 类型
    header('Content-Type:"' . mime_content_type($file_path) . '"');
    // 声明文件总大小，让浏览器显示进度条
    header('Content-Length:' . filesize($file_path));

    // 3. 打开文件资源 (以只读二进制模式)
    $handle = fopen($file_path, 'rb');
    if (!$handle) {
        die('Failed to open file.');
    }

    // 4. 循环读取并输出
    while (!feof($handle)) {
        // 每次读取 kilobyte * 1024 个字节
        echo fread($handle, $kilobyte * 1024);
        
        // 刷新输出缓冲区，将已发送数据推送到客户端
        flush();
        
        // 暂停1秒，控制输出节奏
        sleep(1);
    }

    // 5. 清理资源
    fclose($handle);
}

第2步：调用函数执行下载

目的：在业务逻辑中调用上述函数，开始限速下载流程。

操作示例：

// 假设文件位于 /var/www/html/data/report.pdf /
$file = '/path/to/your/file.zip';

// 调用函数：限速为 50KB/s，自定义下载名为 "backup"
speedLimitedDownload($file, 50, 'backup');

可观察的完成状态：浏览器弹出保存文件对话框；或者如果是异步请求，控制台可见数据包分批次到达，整体耗时明显长于无限制下载。

简要总结

以上就是 PHP 实现文件下载限速功能的详细内容，更多关于 PHP 文件传输控制优化的资料请关注本站其它相关文章！