PHP stream_set_chunk_size 对大文件传输的缓冲影响

大文件传输遇到内存抖动或吞吐不稳定时，stream_set_chunk_size() 可以作为“当前流的分块策略”调节项，但它不是 TCP 包大小开关，也不等于 stream_set_read_buffer()。更稳妥的做法是：打开源流后设置一个可回退的 chunk size，用 stream_copy_to_stream() 进行流式复制，再按返回值和超时结果决定提交还是清理半成品。

先分清 chunk size 与读缓冲

stream_set_chunk_size($stream, $size) 作用于传入的流，成功时返回旧值；它描述的是流处理时使用的分块大小。stream_set_read_buffer() 则针对读操作缓冲，传入 0 代表不使用读缓冲。应用自己调用 fread($stream, 1024 * 1024) 时，读取长度又是调用层的选择。三者可以同时出现，但不能用其中一个推断另外两个。

大文件复制时的参数边界

下面的写法把 chunk size 设为 1 MiB，并保留旧值，便于在同一资源被复用时恢复。示例没有把整个文件读进字符串；length 设为 null 表示复制源流当前位置之后的剩余内容。

这里的关键不是“把数值调到最大”，而是把参数和结果绑定起来：记录源文件大小、$copied、耗时与失败原因，再比较不同 chunk size。对本地磁盘，过大的块可能增加单次等待和并发内存；对慢网络，过小的块可能增加调用次数。没有基准数据时，不应直接宣称某个值一定更快。

线上排查与回滚清单

回滚时先恢复默认配置或旧 chunk size，再清理未完成目标文件；不要只删除告警而保留一个大小正确但内容不完整的文件。监控至少记录传输字节数、耗时、失败率、打开句柄和临时文件数量。

相关问题

stream_set_chunk_size 会改变网络包大小吗？

不会直接等同于 TCP 包大小。它是 PHP 流层的分块设置，实际网络分段还受协议栈、传输协议和对端行为影响。

应该同时把 stream_set_read_buffer 设为 0 吗？

不应默认这样做。只有明确需要无读缓冲并理解代价时才调整；先区分问题属于流分块、读缓冲还是应用层读取长度。

为什么示例要使用 .part 文件？

因为复制中断时目标文件可能只有部分内容。临时文件配合成功后的改名，可以避免消费者读到半成品。