中文(繁體)
中文(繁體)
在PHP 的文件操作函數中， fpassthru()是一個不太起眼但非常實用的函數。它的主要作用是讀取一個打開的文件指針直到文件末尾，並將讀取的內容直接輸出。結合PHP 的輸出緩衝區機制， fpassthru()的行為可能會受到影響，進而影響到輸出的效率與邏輯控制。本文將介紹fpassthru()的基本用法，並深入探討它與輸出緩衝區之間的關係，以及如何合理利用這一特性來優化PHP 的輸出策略。
fpassthru()的函數原型如下：
<span><span><span class="hljs-keyword">int</span></span><span> </span><span><span class="hljs-title function_ invoke__">fpassthru</span></span><span> ( resource </span><span><span class="hljs-variable">$handle</span></span><span> )
</span></span>它接受一個有效的文件資源指針（通常由fopen()返回），從當前位置開始讀取文件直到結尾，並將內容直接發送到輸出緩衝區或客戶端。通常用於將文件內容原樣發送給瀏覽器，比如用於下載文件或輸出日誌。
示例：
<span><span><span class="hljs-variable">$fp</span></span><span> = </span><span><span class="hljs-title function_ invoke__">fopen</span></span><span>(</span><span><span class="hljs-string">"example.txt"</span></span><span>, </span><span><span class="hljs-string">"r"</span></span><span>);
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$fp</span></span><span>) {
</span><span><span class="hljs-comment">// 可選：設置正確的 header</span></span><span>
</span><span><span class="hljs-title function_ invoke__">header</span></span><span>(</span><span><span class="hljs-string">"Content-Type: text/plain"</span></span><span>);
</span><span><span class="hljs-title function_ invoke__">fpassthru</span></span><span>(</span><span><span class="hljs-variable">$fp</span></span><span>);
</span><span><span class="hljs-title function_ invoke__">fclose</span></span><span>(</span><span><span class="hljs-variable">$fp</span></span><span>);
}
</span></span>PHP 的輸出緩衝區機制允許開發者控制何時將輸出發送給客戶端。在未啟用緩衝區時，PHP 每次執行echo 、 print或類似的輸出操作時，都會立刻將內容髮送到瀏覽器。但在使用如ob_start()啟動輸出緩衝後，所有輸出會被暫時儲存在緩衝區中，直到調用ob_end_flush() 、 ob_flush()或腳本結束為止。
輸出緩衝機制的一個重要作用，是可以讓開發者在輸出前修改內容、添加頭信息，甚至取消部分輸出，從而更靈活地控制內容的展示。
fpassthru()本身並不繞過輸出緩衝區——它仍然會將數據寫入緩衝區中，而不是直接“跳過”緩衝區送達客戶端。也就是說，如果開啟了輸出緩衝區， fpassthru()輸出的內容也會被緩冲起來。
這意味著在使用fpassthru()時，若開啟了輸出緩衝（比如頁面前使用了ob_start() ），你必須確保在適當時候刷新或清空緩衝區，否則用戶可能無法立即看到輸出內容，甚至在輸出前就觸發“headers already sent”的錯誤。
舉個例子：
<span><span><span class="hljs-title function_ invoke__">ob_start</span></span><span>();
</span><span><span class="hljs-variable">$fp</span></span><span> = </span><span><span class="hljs-title function_ invoke__">fopen</span></span><span>(</span><span><span class="hljs-string">"largefile.zip"</span></span><span>, </span><span><span class="hljs-string">"rb"</span></span><span>);
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$fp</span></span><span>) {
</span><span><span class="hljs-title function_ invoke__">header</span></span><span>(</span><span><span class="hljs-string">"Content-Type: application/zip"</span></span><span>);
</span><span><span class="hljs-title function_ invoke__">header</span></span><span>(</span><span><span class="hljs-string">"Content-Disposition: attachment; filename=\"download.zip\""</span></span><span>);
</span><span><span class="hljs-title function_ invoke__">fpassthru</span></span><span>(</span><span><span class="hljs-variable">$fp</span></span><span>);
</span><span><span class="hljs-title function_ invoke__">fclose</span></span><span>(</span><span><span class="hljs-variable">$fp</span></span><span>);
}
</span><span><span class="hljs-title function_ invoke__">ob_end_flush</span></span><span>(); </span><span><span class="hljs-comment">// 只有執行到這里內容才發送到客戶端</span></span><span>
</span></span>如果未調用ob_end_flush() ，那麼內容可能會長時間滯留在緩衝區，尤其在輸出大型文件時，這種滯後會影響用戶體驗。
在高效、安全地使用fpassthru()時，應考慮以下幾點：
如果你需要即時輸出內容（比如下載大文件），建議關閉輸出緩衝或手動刷新。
可使用ob_end_clean()清除緩衝區以避免衝突。
<span><span><span class="hljs-comment">// 避免額外輸出乾擾文件下載</span></span><span>
</span><span><span class="hljs-keyword">while</span></span><span> (</span><span><span class="hljs-title function_ invoke__">ob_get_level</span></span><span>()) {
</span><span><span class="hljs-title function_ invoke__">ob_end_clean</span></span><span>();
}
</span></span>使用fpassthru()輸出文件時，請務必在調用之前設置好Content-Type 、 Content-Disposition等頭信息。因為一旦開始輸出內容，再設置header 會失敗。
在調用fpassthru()輸出內容前，確保沒有其他HTML、空格、BOM 或錯誤信息被輸出。這些內容都會污染輸出流，破壞如文件下載這類場景的正確性。
雖然fpassthru()本質上只是一個簡單的輸出函數，但它在處理大文件傳輸時的高效性，以及與輸出緩衝區機制的配合使用，使其成為PHP 文件操作中一個值得掌握的工具。理解並正確運用輸出緩衝，可以幫助開發者構建更可控、更高性能的輸出邏輯，特別是在需要控制客戶端響應內容的場景中。
通過結合實際需求，合理安排緩衝機制與輸出函數的使用順序，PHP 開發者可以更靈活地控制應用的輸出行為，從而實現更加專業的內容呈現方式。
