日本語
日本語
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はエコー、印刷、または同様の出力操作を実行するたびに、すぐにコンテンツをブラウザに送信します。ただし、 OB_START（）で出力バッファーを起動した後、すべての出力は、OB_END_FLUSH（） 、 OB_Flush（）またはスクリプトが終了するまで、バッファーに一時的に保存されます。
出力バッファリングメカニズムの重要な役割は、開発者がコンテンツを変更したり、ヘッダー情報を追加したり、出力前に出力の一部をキャンセルしたり、コンテンツの表示をより柔軟に制御できることです。
FPASSTHRU（）自体は、出力バッファーをバイパスしません - バッファをクライアントに直接「スキップ」するのではなく、データをバッファーに書き込みます。つまり、出力バッファーがオンになっている場合、 fpassthru（）によるコンテンツ出力もバッファーされます。
これは、 fpassthru（）を使用する場合、出力バッファリングが有効になっている場合（たとえば、 ob_start（）がページの前に使用される場合）、適切な時間にバッファーを更新またはクリアする必要があります。
例えば：
<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（）を使用してファイルを出力する場合は、呼び出す前にコンテンツタイプやコンテンツディスポジションなどのヘッダー情報を必ず設定してください。コンテンツが出力されると、ヘッダーの設定が失敗するためです。
fpassthru（）を呼び出してコンテンツを出力する前に、他のHTML、スペース、BOM、またはエラーメッセージが出力されないことを確認してください。これらのコンテンツは、出力ストリームを汚染し、ファイルのダウンロードなどのシナリオの正確性を破壊します。
FPASSTHRU（）は本質的に単純な出力関数にすぎませんが、大規模なファイル転送を処理する効率と出力バッファーメカニズムでの使用は、PHPファイル操作の価値のあるツールになります。特にクライアントの応答コンテンツを制御する必要があるシナリオで、出力バッファリングを理解して正しく使用すると、開発者がより制御可能で高性能の出力ロジックを構築することができます。
実際のニーズを組み合わせて、バッファメカニズムと出力関数の使用順序を合理的に配置することにより、PHP開発者はアプリケーションの出力動作をより柔軟に制御できるため、より専門的なコンテンツプレゼンテーション方法を実現できます。
