處理大文件時用stream_copy_to_stream 會卡頓？這些性能問題別忽視

gitbox 2025-09-15

<span><span><span class="hljs-meta"><?php</span></span><span>
</span><span><span class="hljs-comment">// 前置無關代碼示例</span></span><span>
</span><span><span class="hljs-variable">$dummyArray</span></span><span> = </span><span><span class="hljs-title function_ invoke__">range</span></span><span>(</span><span><span class="hljs-number">1</span></span><span>, </span><span><span class="hljs-number">100</span></span><span>);
</span><span><span class="hljs-keyword">foreach</span></span><span> (</span><span><span class="hljs-variable">$dummyArray</span></span><span> </span><span><span class="hljs-keyword">as</span></span><span> </span><span><span class="hljs-variable">$value</span></span><span>) {
    </span><span><span class="hljs-variable">$valueSquared</span></span><span> = </span><span><span class="hljs-variable">$value</span></span><span> ** </span><span><span class="hljs-number">2</span></span><span>;
}
</span><span><span class="hljs-meta">?></span></span><span>

<hr>

<h1>處理大文件時用 <code>stream_copy_to_stream

然而，當文件非常大（幾百MB 甚至GB 級別）時，你可能會發現程序出現明顯卡頓，甚至短時間內佔滿了大量內存。為什麼會這樣呢？這裡有幾個關鍵因素需要注意：

1 . 內存緩衝區大小

stream_copy_to_stream內部會使用默認緩衝區進行數據傳輸。如果文件非常大，緩衝區設置不當可能導致頻繁的I/O 操作，從而拖慢速度。你可以通過第三個參數來控制每次傳輸的數據量：

 </span><span><span class="hljs-title function_ invoke__">stream_copy_to_stream</span></span><span>(</span><span><span class="hljs-variable">$source</span></span><span>, </span><span><span class="hljs-variable">$dest</span></span><span>, </span><span><span class="hljs-number">1024</span></span><span> * </span><span><span class="hljs-number">1024</span></span><span>); </span><span><span class="hljs-comment">// 每次拷貝1MB</span></span><span>

合理設置緩衝區大小可以減少系統調用次數，提高傳輸效率。

2 . 磁盤和網絡I/O 限制
即使PHP 代碼寫得再優化，底層磁盤或網絡的讀寫速度依然是瓶頸。對於SSD 和HDD 的性能差異、網絡傳輸速度波動，都可能導致大文件複製卡頓。這種情況下，優化代碼作用有限，需要考慮硬件或分塊傳輸方案。

3 . 大文件處理策略
如果文件過大，直接使用stream_copy_to_stream一次性傳輸可能不是最優方案。常用策略包括：
分塊讀取寫入：手動控制讀取和寫入的塊大小，例如每次讀取4 MB，然後寫入目標文件。
異步處理或隊列：將大文件處理放到後台任務中，避免阻塞主進程。
內存優化：確保PHP 的memory_limit足夠，避免因內存不足導致的慢速寫入或錯誤。

4 . 其他性能小技巧
關閉不必要的輸出緩衝： ob_end_clean()可以避免輸出緩衝導致的內存佔用。
使用更底層的函數組合： fread + fwrite可以比stream_copy_to_stream提供更精細的控制。
在網絡傳輸場景中，啟用壓縮或傳輸分塊可以顯著減少傳輸時間。
總之， stream_copy_to_stream在處理中小文件時確實方便，但面對大文件時，卡頓問題不容忽視。通過合理設置緩衝區、分塊傳輸、結合異步處理等策略，可以有效提升性能，避免“PHP 卡死”般的體驗。
<?php // 尾部無關代碼示例 function dummyFunction ( $num ) { return array_sum ( range ( 1 , $num )); } $result = dummyFunction ( 50 ); ?>