fcopy() 不行是因为它底层调用系统级拷贝（如 sendfile），不经过 PHP 用户态缓冲，无法获取中间进度；必须手动分块读写（fread + fwrite）才能实时反馈进度、控制中断和处理异常。
为什么 fcopy() 不行，必须手动分块读写
fcopy() 是 PHP 8.4+ 新增的函数，它底层调用系统级拷贝（如 sendfile()），不经过 PHP 用户态缓冲，因此无法获取中间进度。要实时反馈已拷贝字节数，必须由 PHP 主动控制读取与写入节奏——也就是用 fread() + fwrite() 循环分块处理。
常见错误是直接 file_get_contents() 全量读入内存，大文件（比如 >100MB）会触发 Fatal error: Allowed memory size exhausted；还有人用 stream_copy_to_stream() 却没意识到它默认不返回已复制字节数，且无法中断或回调进度。
- 必须用
fopen()打开源/目标为二进制流（'rb'和'wb'） - 每次
fread()的长度建议设为 8192 或 65536 字节：太小（如 1024）会增加系统调用次数，影响性能；太大（如 1MB）可能阻塞响应或吃光内存 - 务必检查
fread()返回值是否为false（读取失败）或空字符串（EOF），不能只依赖feof()
如何安全地实现带进度回调的拷贝函数
核心逻辑是：打开两个流 → 循环读块 → 写块 → 累计已写大小 → 调用用户传入的回调函数。关键在于异常处理和资源清理。
下面是一个最小可行示例：
立即学习“PHP免费学习笔记（深入）”；
function copyWithProgress(string $src, string $dst, callable $onProgress): bool
{
$srcFp = @fopen($src, 'rb');
if (!$srcFp) {
return false;
}
<pre class="brush:php;toolbar:false;">$dstFp = @fopen($dst, 'wb');
if (!$dstFp) {
fclose($srcFp);
return false;
}
$totalSize = filesize($src);
$copied = 0;
$bufferSize = 65536;
while (!feof($srcFp)) {
$chunk = fread($srcFp, $bufferSize);
if ($chunk === false) {
break;
}
$written = fwrite($dstFp, $chunk);
if ($written !== strlen($chunk)) {
break;
}
$copied += $written;
$onProgress($copied, $totalSize);
}
$success = feof($srcFp) && $copied === $totalSize;
fclose($srcFp);
fclose($dstFp);
return $success;}
- 回调
$onProgress($copied, $totalSize)可用于更新前端进度条、写日志或中断操作（比如在回调里抛异常并捕获） - 注意
fwrite()返回实际写入字节数，必须校验是否等于strlen($chunk)，否则说明磁盘满、权限不足等写入失败 - 不要省略
@fopen()的错误抑制符——否则fopen()失败会触发警告，而你已经在代码里做了显式判断
PHP 8.1+ 中使用 stream_copy_to_stream() 获取进度的陷阱
有人尝试用 stream_copy_to_stream($src, $dst, -1, $offset) 并配合 ftell() 查进度，但这是错的：stream_copy_to_stream() 是原子操作，$offset 是起始偏移，不是每次读取位置；而且它不提供每轮读写后的回调点。
唯一能“伪进度”的方式是分段调用它，例如每次只拷贝 1MB：
$srcFp = fopen($src, 'rb');
$dstFp = fopen($dst, 'wb');
$total = filesize($src);
$offset = 0;
$chunkSize = 1048576; // 1MB
<p>while ($offset < $total) {
$len = min($chunkSize, $total - $offset);
$copied = stream_copy_to_stream($srcFp, $dstFp, $len, $offset);
$offset += $copied;
$onProgress($offset, $total);</p><pre class="brush:php;toolbar:false;">if ($copied !== $len) {
break;
}}
- 这种方式本质还是手动分块，只是底层用了更高效的流复制；但要注意
stream_copy_to_stream()的第三个参数是最大拷贝长度，第四个是源流起始偏移，不是目标偏移 - 必须自己维护
$offset，且每次调用前需确保源流位置正确（fseek($srcFp, $offset)），否则会重复拷贝或跳过数据 - 相比纯
fread/fwrite，它减少了 PHP 层内存拷贝，但调试难度更高，出错时错误信息更模糊（比如stream_copy_to_stream(): Cannot seek stream）
Web 环境下进度回传到前端的实际约束
即使 PHP 层能计算进度，浏览器端也未必能实时收到——因为 HTTP 是无状态短连接，输出缓冲、FastCGI 超时、Nginx proxy_buffering 都会截断或延迟数据。
- 不要用
echo直接输出 JSON 进度，前端fetch()无法流式解析；应改用 Server-Sent Events（SSE）或 WebSocket - CLI 模式下可放心用
echo "\rCopied: {$copied}/{$total}"，但 Web 下需禁用输出缓冲：ob_end_flush(); ob_implicit_flush(true);，且仅适用于小文件（ - 生产环境强烈建议将拷贝任务放入队列（如 Redis + Worker），前端轮询任务状态，避免请求超时和资源占用
真正难的从来不是“怎么读写”，而是“怎么让进度可靠落地”——从 PHP 流控制，到 Web 传输链路，再到前端渲染时机，每一层都可能吞掉你的 $onProgress 调用。
