【PHP8.x】flush()関数の使い方
flush関数の使い方について、初心者にもわかりやすく解説します。
基本的な使い方
flush関数は、PHPの出力バッファに蓄えられた内容を強制的にクライアント（ウェブブラウザなど）へ送出する命令を実行する関数です。PHPスクリプトは、生成された出力（HTMLやテキストデータなど）をウェブサーバへ送る前に、内部的な出力バッファに一時的に蓄えます。これは、データの送受信をまとめて行うことで処理の効率を高めるためです。しかし、長時間かかる処理中にユーザーに進捗状況を伝えたい場合など、スクリプトの実行が完了する前に一部のデータを送りたい状況があります。flush関数を呼び出すことで、この内部バッファに溜まっているデータが直ちにウェブサーバへ送られ、さらにそこからクライアントへ送信されるように促されます。
この機能は、処理に時間がかかる場合にプログレスバーを表示するなど、リアルタイムに近いユーザーフィードバックを提供したい場合に特に役立ちます。ただし、flush関数を呼び出しても、ウェブサーバやブラウザのバッファリング機構により、データが即座にユーザーのブラウザに表示されない場合があります。特に、ウェブサーバで出力圧縮（gzipなど）が有効になっている場合は、圧縮処理のためにデータがさらにバッファリングされる可能性がある点に注意が必要です。PHPの出力バッファリングをより細かく制御するには、ob_start()やob_end_flush()といった関連する出力制御関数と組み合わせて使用することが一般的です。
構文(syntax)
1<?php 2 3flush(); 4 5?>
引数(parameters)
引数なし
引数はありません
戻り値(return)
void
flush関数は、PHPスクリプトの実行中にバッファリングされている出力を即座にブラウザなどのクライアントに送信します。戻り値はありません。
サンプルコード
PHPのob_flushとflushの違いを理解する
1<?php 2 3/** 4 * このスクリプトは、PHPの出力バッファリング (`ob_flush`) と 5 * ウェブサーバーへの出力 (`flush`) の違いをデモンストレーションします。 6 * 7 * 【重要】 8 * Webブラウザでリアルタイムな段階的出力を確認するには、以下の点に注意してください。 9 * 1. Webサーバー (例: Apache, Nginx) のバッファリング設定を無効にするか、 10 * `Transfer-Encoding: chunked` をサポートするよう設定されている必要があります。 11 * 多くのWebサーバーはデフォルトでバッファリングを行います。 12 * 2. ブラウザ自体も受信したコンテンツをバッファリングすることがあります。 13 * これはブラウザの種類や設定に依存します。 14 * 3. CLI (コマンドラインインターフェース) で実行すると、通常はバッファリングの影響を受けにくく、 15 * より直接的に出力の変化を確認できます。 16 */ 17 18// 出力バッファリングを開始します。 19// これ以降の echo は、直接クライアントに送られず、PHPの内部バッファに蓄積されます。 20ob_start(); 21 22echo "Step 1: この行はまだブラウザに送信されません。<br>\n"; 23 24// ob_flush(): 現在の出力バッファ (ob_start() で開始したもの) の内容を、 25// 次の上位のバッファ (またはPHPのメイン出力ストリーム) へフラッシュします。 26// この時点では、まだWebサーバーのバッファに留まっている可能性があり、 27// 通常、ブラウザには届きません。バッファ自体はクリアされますが、停止はしません。 28ob_flush(); 29 30echo "Step 2: ob_flush() の後、この行が現在のバッファに追加されました。<br>\n"; 31 32// flush(): PHPのすべての出力バッファ (ob_flush() によって上位に送られた内容も含む) 33// の内容を、Webサーバーのバッファからクライアントへ強制的に送信しようと試みます。 34// ここで初めて、Step 1 と Step 2 の内容がブラウザに表示され始める可能性があります。 35flush(); 36 37// ブラウザでの表示を確認しやすくするために一時停止します。 38sleep(2); 39 40echo "Step 3: flush() の後、さらにこの行を追加しました。<br>\n"; 41 42// 再度 flush() を呼び出し、Step 3 の内容もブラウザへ送信を試みます。 43flush(); 44 45// ob_end_flush(): 現在の出力バッファを終了し、残っている内容をフラッシュします。 46// これがないと、スクリプトの最後まで出力はバッファに残り、 47// スクリプト終了時にまとめて出力される可能性があります。 48ob_end_flush(); 49 50// --- キーワード 'fflush' についての補足説明 --- 51// flush() と ob_flush() はHTTPレスポンスの出力バッファリングに関連するPHP関数です。 52// 一方、fflush() は、C標準ライブラリに由来する関数で、PHPではファイルストリーム (例: fopen() で開いたファイル) 53// の内部バッファをディスクやネットワークなどの物理メディアへ書き出すために使用されます。 54// 例えば、fwrite() でファイルに書き込んだ後、fflush($file_pointer) を呼び出すことで、 55// バッファリングされたデータが確実にファイルに書き込まれます。 56// これはWeb出力バッファとは用途が異なるため、直接的な比較対象ではありません。 57 58?>
PHP 8のflush関数は、引数を取らず、戻り値もありません（void）。この関数は、PHPがこれまでに生成したすべての出力（echoなどで出力された内容）を、Webサーバーのバッファからクライアント（通常はWebブラウザ）へ強制的に送信しようと試みます。
サンプルコードでは、まずob_start()でPHPの出力バッファリングを開始します。これにより、echoされた内容は直接クライアントに送られず、PHP内部のバッファに一時的に蓄積されます。
次にob_flush()を呼び出すと、現在のアクティブな出力バッファの内容がPHPの次の上位バッファ、またはPHPのメイン出力ストリームへ移動します。しかし、この時点ではまだWebサーバーのバッファに留まることが多く、ブラウザには表示されません。
その後、flush()を呼び出すと、PHPのすべての出力バッファの内容がWebサーバーのバッファからクライアントへ送られ、ブラウザに表示され始める可能性があります。スクリプトの最後にob_end_flush()は、出力バッファリングを終了し、残りの内容をフラッシュします。
なお、Webサーバーやブラウザがコンテンツをバッファリングする場合があるため、flush()を呼び出してもリアルタイムに表示されないことがあります。コマンドラインインターフェース（CLI）で実行すると、より直接的な出力を確認できます。
また、キーワードにあったfflush()は、C標準ライブラリ由来の関数で、PHPではfopen()で開いたファイルストリームの内部バッファをディスクなどの物理メディアへ書き出すために使用され、Web出力バッファとは用途が異なります。
PHPのflush()はウェブサーバーへの出力バッファを、ob_flush()はPHPの内部バッファを上位にフラッシュする機能です。一方、fflush()はファイルストリームのバッファを物理メディアに書き出す関数であり、用途が異なりますので混同しないよう注意が必要です。flush()を呼び出しても、Webサーバーやブラウザがさらにバッファリングを行う場合があるため、すぐにブラウザに表示されないことがあります。リアルタイムな段階的出力を確認するには、Webサーバーの設定調整が必要な場合があります。コマンドラインインターフェース（CLI）で実行すると、これらのバッファリングの影響を受けにくく、より直接的に動作を確認できます。出力バッファリングを適切に利用するには、ob_start()とob_end_flush()を組み合わせて使用することが基本となります。
PHP flush()と出力バッファリングを試す
1<?php 2 3/** 4 * このスクリプトは、PHPのflush()関数と出力バッファリングの動作を示すサンプルです。 5 * 「php fflush 効かない」というキーワードは、Webサーバーやブラウザのバッファリングにより、 6 * flush()関数が期待通りに動作しない場合に発生することがあります。 7 * 8 * このコードは、PHPの出力バッファリング（ob_start()など）とシステムレベルのflush()を 9 * 組み合わせて使用することで、コンテンツを段階的にブラウザに表示するよう試みます。 10 * 11 * ただし、Webサーバー（Apache, Nginxなど）、プロキシ、PHP-FPMの設定、 12 * およびブラウザの挙動によっては、完全にリアルタイムな表示が保証されないことを理解してください。 13 */ 14 15// 1. キャッシュを無効にし、ブラウザのバッファリングを抑制するためのHTTPヘッダを設定します。 16// これにより、ブラウザができるだけ早くコンテンツをレンダリングするよう促します。 17header('Cache-Control: no-cache, no-store, must-revalidate'); // HTTP 1.1 18header('Pragma: no-cache'); // HTTP 1.0 19header('Expires: 0'); // プロキシのキャッシュを無効にする 20header('Content-Type: text/html; charset=UTF-8'); 21 22// 2. PHPの出力バッファリングを開始します。 23// これにより、ob_flush() や ob_end_flush() を使ってPHP内部のバッファを制御できます。 24ob_start(); 25 26echo "<html><body>\n"; 27echo "<h1>PHP flush() 関数の動作確認</h1>\n"; 28echo "<p>このページは、段階的にコンテンツをロードします。各ステップの間に遅延があります。</p>\n"; 29 30// 最初のコンテンツを出力した後、PHPのバッファをフラッシュし、システムレベルでのフラッシュを試みます。 31ob_flush(); // PHPの出力バッファをフラッシュします。 32flush(); // Webサーバーなど、PHPより上位の出力バッファをフラッシュするよう試みます。 33 34// 3. ループを使って、複数のステップでコンテンツを生成し、段階的に出力します。 35for ($i = 1; $i <= 5; $i++) { 36 echo "<p>ステップ {$i}: 処理を実行中... "; 37 38 // ここで時間のかかる処理をシミュレートします。 39 sleep(1); // 1秒間待機 40 41 echo "完了！</p>\n"; 42 43 // 各ステップの後に、PHPとシステムの両方のバッファをフラッシュします。 44 // これにより、次のステップが始まる前に、ここまでのコンテンツがブラウザに送信される可能性が高まります。 45 ob_flush(); // PHPの出力バッファをクリアし、内容を次のレイヤー（Webサーバーなど）に送ります。 46 flush(); // システムのバッファ（Webサーバーのバッファなど）をクリアし、クライアントへデータを送信するよう試みます。 47} 48 49echo "<p>すべての処理が完了しました。</p>\n"; 50echo "</body></html>\n"; 51 52// 4. 最終的にPHPの出力バッファリングを終了し、残りのすべての内容を出力します。 53ob_end_flush(); 54 55?>
PHPのflush()関数は、PHPが出力した内容を、WebサーバーなどのPHPより上位の出力バッファからクライアント（ブラウザなど）へ可能な限り早く送信するよう試みるために使用されます。この関数は引数を取らず、戻り値もありません（void）。通常、PHPの出力は内部バッファに一度蓄えられますが、flush()を呼び出すことで、その内容が次の出力層に渡されます。
しかし、「php fflush 効かない」という状況が起こり得るのは、Webサーバー（Apache、Nginxなど）、プロキシサーバー、さらにはブラウザ自体がそれぞれ独自のバッファリングを行うためです。PHPがflush()でバッファをクリアしても、Webサーバーやプロキシがコンテンツを保持したり、ブラウザが一定量のデータを受け取るまでレンダリングを開始しなかったりすることがあります。
このサンプルコードでは、ob_start()でPHPの出力バッファリングを開始し、ob_flush()でPHPのバッファをクリアした後にflush()を呼び出すことで、コンテンツを段階的にブラウザに表示しようと試みています。sleep()関数で一時停止を挟むことで、処理の進行を視覚的に確認しやすくしています。ただし、これはあくまで「試み」であり、上記のような様々なバッファリングの仕組みにより、完全にリアルタイムな表示が保証されるわけではない点にご留意ください。最終的な表示挙動は、実行環境に大きく依存します。
flush()関数は、PHP内部の出力バッファ（ob_start()で開始）をクリアし、内容をWebサーバーなどの次のレイヤーへ送ります。しかし、Webサーバー、プロキシ、そしてブラウザ自体もバッファリングを行うため、flush()を呼び出してもコンテンツがすぐにブラウザに表示されるとは限りません。このため、サンプルコードのように段階的に出力されることを期待しても、実際にはまとめて表示されるケースが多くあります。HTTPヘッダによるキャッシュ制御も、あくまでブラウザに早期レンダリングを促すものであり、完全にリアルタイムな表示を保証するものではありません。本番環境では、これらの環境要因によって動作が変わるため、必ずテストが必要です。また、「php fflush 効かない」というキーワードにあるfflushはファイル出力のバッファをフラッシュする関数であり、画面出力のflushとは異なる点にご注意ください。
PHP flush()で段階的出力する
1<?php 2 3/** 4 * PHPのflush()関数のデモンストレーション。 5 * echoで出力した内容を、バッファリングせずにクライアントにすぐに送信する効果を示します。 6 * このコードをWebサーバーで実行し、ブラウザでアクセスすると、 7 * コンテンツが数秒ごとに段階的に表示されるのが確認できます。 8 */ 9 10// HTTPヘッダを設定し、ブラウザがすぐにレンダリングを開始できるようにします。 11header('Content-Type: text/html; charset=UTF-8'); 12 13echo '<h1>PHP flush() 関数デモ</h1>'; 14echo '<p>このページは、段階的にコンテンツを表示します。ブラウザで確認すると、数秒ごとにテキストが現れるのが分かります。</p>'; 15echo '<hr>'; 16 17// 最初のメッセージを出力し、すぐにクライアントに送信します。 18echo '<p>1秒目: 処理を開始しました。</p>'; 19// flush() は、PHPの出力バッファの内容をWebサーバのバッファ、またはクライアントへ送信します。 20flush(); 21 22// 2秒間待機し、処理が進行していることをシミュレートします。 23sleep(2); 24 25// 次のメッセージを出力し、再度クライアントに送信します。 26echo '<p>3秒目: 中間処理を実行中...</p>'; 27flush(); 28 29// さらに2秒間待機します。 30sleep(2); 31 32// 最後のメッセージを出力し、処理の完了を知らせます。 33echo '<p>5秒目: 処理が完了しました。</p>'; 34flush(); 35 36// 注意: Webサーバー（Apache, Nginxなど）やプロキシサーバーも独自のバッファリングを行う場合があるため、 37// flush()を呼び出しても、常に即座にブラウザに表示されるとは限りません。 38// しかし、PHPの出力バッファをクリアする点では機能します。 39 40?>
PHPのflush()関数は、PHPの出力バッファに溜まっている内容を、Webサーバーのバッファ、あるいは直接クライアントへ送信するための機能です。通常、PHPはechoなどで出力された内容を一度内部のバッファに保持し、スクリプトの実行終了時やバッファがいっぱいになったときにまとめて送信します。しかし、flush()関数を使用すると、スクリプト実行中でも任意のタイミングでバッファの内容を強制的に送出できます。
この関数は引数を取らず、戻り値もありません（void）。echo文とflush()関数を組み合わせることで、Webブラウザにコンテンツを段階的に表示させることが可能になります。
サンプルコードでは、echoでメッセージを出力した後、flush()を呼び出すことで、その時点までの内容をすぐにブラウザに送っています。sleep(2)で処理を一時停止させることで、メッセージが数秒ごとに段階的に表示される様子を確認できます。これにより、時間のかかる処理の進捗状況をリアルタイムでユーザーに伝える際などに役立ちます。
ただし、Webサーバー（Apache、Nginxなど）やプロキシサーバーも独自のバッファリングを行う場合があるため、flush()を呼び出しても必ずしも即座にブラウザに表示されるとは限りません。PHPの出力バッファをクリアする点では常に機能します。
flush()関数は、echoなどで出力したPHPの出力バッファの内容を、通常よりも早くクライアントへ送信しようとします。これにより、処理の進捗状況を段階的に表示するようなデモンストレーションが可能になります。
しかし、Webサーバーやプロキシサーバー、そしてブラウザ自体も独自のバッファリングを行うため、必ずしも即座に画面に表示されるわけではないことに注意してください。これは実行環境によって挙動が異なります。
また、HTTPヘッダの送信が完了するまで、ブラウザはコンテンツのレンダリングを開始しません。サンプルコードのようにContent-Typeヘッダを明示的に設定すると、表示がスムーズになります。長時間接続を維持するため、サーバーのタイムアウト設定にも留意が必要です。
PHP flush()で段階表示する
1<?php 2 3/** 4 * PHPのflush()関数の動作と、出力がすぐに表示されない一般的な問題 5 * （通称「php flush not working」）に対処する方法を示します。 6 * 7 * flush()関数は、現在の出力バッファの内容をWebサーバーに送信しますが、 8 * ブラウザに即座に表示されるためには、PHPのバッファリング（ob_start()など）と 9 * Webサーバー（Apache, Nginxなど）のバッファリングの両方を適切に制御する必要があります。 10 * この例では、これらのバッファリングを制御し、段階的に内容が表示されるようにします。 11 */ 12function demonstrateFlushBehavior(): void 13{ 14 // Webブラウザがコンテンツをすぐにレンダリングできるように、 15 // 適切なContent-Typeヘッダーとキャッシュ無効化ヘッダーを設定します。 16 header('Content-Type: text/html; charset=utf-8'); 17 // キャッシュを無効にし、ブラウザやプロキシによるバッファリングを防ぎます。 18 header('Cache-Control: no-cache, no-store, must-revalidate'); 19 header('Pragma: no-cache'); 20 header('Expires: 0'); 21 22 echo '<!DOCTYPE html>'; 23 echo '<html>'; 24 echo '<head>'; 25 echo '<title>PHP flush() Example</title>'; 26 echo '</head>'; 27 echo '<body>'; 28 echo '<h1>PHP flush() 関数デモンストレーション</h1>'; 29 30 // PHPの出力バッファリングを開始します。 31 // これにより、echoなどで出力された内容はすぐに送信されず、 32 // PHP内部のバッファに蓄えられます。 33 ob_start(); 34 35 echo '<p>ステップ1: この行はすぐに表示されるはずです。</p>' . PHP_EOL; 36 // PHPの出力バッファの内容をWebサーバーのバッファへ送信します。 37 ob_flush(); 38 // Webサーバーのバッファをクライアント（ブラウザ）へ送信します。 39 // ブラウザはこの時点で受け取った内容を表示しようとします。 40 flush(); 41 42 // 処理を一時停止し、ブラウザが前の内容をレンダリングする時間を与えます。 43 sleep(2); 44 45 echo '<p>ステップ2: 2秒後にこの行が表示されるはずです。</p>' . PHP_EOL; 46 ob_flush(); 47 flush(); 48 49 sleep(2); 50 51 echo '<p>ステップ3: さらに2秒後にこの行が表示されるはずです。</p>' . PHP_EOL; 52 ob_flush(); 53 flush(); 54 55 sleep(2); 56 57 echo '<p>完了しました。</p>' . PHP_EOL; 58 ob_flush(); 59 flush(); 60 61 echo '</body>'; 62 echo '</html>'; 63 64 // スクリプトの最後に残っているPHP出力バッファの内容をすべてフラッシュし、 65 // バッファリングを終了します。 66 ob_end_flush(); 67} 68 69// デモンストレーション関数の実行 70demonstrateFlushBehavior(); 71
PHPのflush()関数は、Webサーバーの出力バッファに蓄えられた内容を、直ちにクライアント（Webブラウザなど）へ送信する役割を持つ関数です。この関数は引数を取らず、戻り値もありません。通常、PHPスクリプトからの出力はすべての処理が完了してからまとめて送信されますが、flush()を使用することで、処理の途中で段階的に内容を送信できます。
しかし、「php flush not working」と呼ばれる現象のように、flush()を呼び出してもすぐにWebブラウザに内容が表示されないことがあります。これは、flush()関数単体では、PHP自身の出力バッファ、Webサーバー（Apache, Nginxなど）のバッファ、さらにはブラウザ側のバッファリングが介在するためです。この問題を解決し、flush()を効果的に機能させるには、PHPの出力バッファリングを適切に制御する必要があります。具体的には、ob_start()でバッファリングを開始し、echoなどで出力された内容をPHP内部のバッファに蓄えます。そして、ob_flush()でPHPバッファの内容をWebサーバーに送り、その後にflush()を呼び出すことでWebサーバーからクライアントへ強制的に送信します。さらに、header()関数でキャッシュを無効にする設定も重要です。
サンプルコードでは、これらのテクニックを組み合わせて使用しています。header()でキャッシュを無効化し、ob_start()とob_flush()、そしてflush()を組み合わせて、sleep()関数で一時停止を入れながら、コンテンツが時間差で段階的にWebブラウザに表示される様子をデモンストレーションしています。これにより、処理の進行状況をリアルタイムでユーザーに伝えることが可能となります。
flush()関数は、PHPの出力バッファの内容をWebサーバーへ送信する機能ですが、ブラウザに即座に表示されないことがあります。これは、PHPの出力バッファリングに加え、Webサーバー、プロキシ、ブラウザ側でもバッファリングが行われるためです。
サンプルコードのように、ob_start()でPHPのバッファリングを開始し、ob_flush()でPHPバッファをWebサーバーに送り、その後にflush()でWebサーバーのバッファをクライアントへ送るという連携が重要です。また、header()関数でキャッシュ制御を適切に行い、ブラウザやプロキシによるバッファリングを防ぐことも、即時表示のための重要なポイントです。
sleep()関数は、デモンストレーションのために処理を一時停止させていますが、実運用ではユーザー体験を損ねるため、特別な要件がない限り使用は推奨されません。多層的なバッファリングの仕組みを理解し、適切に制御することが、flush()を効果的に利用する鍵となります。