如何检测PHP文件下载是否被取消？并实现特定文件下载量统计

嘿，这个问题我之前帮好几个开发者解决过！确实，用$bytes_sent对比文件大小的思路看起来很直接，但浏览器和服务器的交互逻辑里藏着个小坑，导致这个方法根本不靠谱。

为什么$bytes_sent不管用？ #

当你用PHP发送文件时，服务器会先把文件数据写到前端的缓冲区里，这时候PHP就会把$bytes_sent标记为文件的总大小——哪怕用户立刻点击了下载对话框的“取消”按钮，服务器已经把数据推到浏览器缓冲区了，所以这个值不会随着用户的操作改变。

可行的解决方案：分块发送+实时检测连接状态 #

最靠谱的方法是分块发送文件数据，同时用PHP的connection_aborted()函数实时检测客户端连接是否中断。这样就能准确判断用户是完成了下载，还是中途取消/断网了。

给你一个可直接用的示例代码：

$targetFile = 'your/file/path/here.pdf';
$fileSize = filesize($targetFile);
$fileHandle = fopen($targetFile, 'rb');

// 设置下载响应头
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="'.basename($targetFile).'"');
header('Content-Length: ' . $fileSize);

$chunkSize = 1024 * 1024; // 每次发送1MB数据，可根据需求调整
$actualSent = 0;

// 分块发送并检测连接状态
while (!feof($fileHandle) && !connection_aborted()) {
    $buffer = fread($fileHandle, $chunkSize);
    echo $buffer;
    $actualSent += strlen($buffer);
    // 强制刷新输出缓冲区，确保数据实时发送到客户端
    flush();
    ob_flush();
}

fclose($fileHandle);

// 最后判断下载是否完成
if (connection_aborted()) {
    // 用户中途取消下载或连接中断，不统计这次下载
    error_log("下载中断：文件 {$targetFile}，实际发送字节数：{$actualSent}");
} else {
    // 下载完成，更新你的下载量统计（比如写入数据库）
    // update_download_count($targetFile);
    error_log("下载完成：文件 {$targetFile}，总字节数：{$fileSize}");
}

关键注意事项 #

• 确保PHP的output_buffering配置为off，或者在代码里用ob_flush()+flush()强制刷新缓冲区，否则数据会滞留在服务器，导致connection_aborted()无法及时检测到中断。
• 分块大小不用太大，1MB左右就很合适——既不会增加太多IO开销，又能保证连接状态检测的实时性。
• 如果你的服务器有反向代理（比如Nginx），要确保代理的缓冲区设置不会影响实时检测，可能需要调整代理的proxy_buffering为off。

可选的前端辅助（仅供参考） #

虽然前端无法100%准确判断下载结果，但可以做一些辅助：比如用户点击下载按钮时，前端发送一个“下载开始”的请求；部分浏览器支持download事件，可以在下载完成时发送一个“下载完成”的请求。不过这个方法只能作为后端检测的补充，不能单独依赖——因为用户取消下载时，前端可能不会触发任何事件。

内容的提问来源于stack exchange，提问作者Germán Salamanca Viveros