【PHP8.x】CONNECTION_ABORTED定数の使い方

Copy
1<?php
2
3/**
4 * クライアントの接続中断を監視し、CONNECTION_ABORTED 定数を検出するサンプルコード。
5 *
6 * この関数は、PHPスクリプトがクライアント（ブラウザなど）との接続が切断された後も
7 * 処理を継続し、その切断を検出する方法を示します。
8 * 'connection_aborted not working' の問題は、通常 'ignore_user_abort(true)' が
9 * 設定されていないか、接続状態を適切にチェックしていないことが原因で発生します。
10 *
11 * 動作確認方法:
12 * 1. このPHPファイルをウェブサーバーに配置し、ブラウザでアクセスします。
13 * 2. ブラウザのタブをすぐに閉じるか、リロードするなどして接続を中断します。
14 * 3. サーバー側でスクリプトが終了せず、接続中断を検出する様子が確認できます
15 *    (ウェブサーバーのログや、スクリプトの出力がファイルにリダイレクトされている場合)。
16 */
17function monitorConnectionAbort(): void
18{
19    // クライアントが接続を中断しても、スクリプトの実行を継続する設定。
20    // これがないと、クライアントが切断した瞬間にスクリプトも終了し、
21    // CONNECTION_ABORTED を検出する機会が失われます。
22    ignore_user_abort(true);
23
24    echo "スクリプト実行中... クライアントの接続中断を監視します。\n";
25    echo "ブラウザのタブを閉じるなどして接続を中断してみてください。\n";
26
27    $maxChecks = 15; // 最大15秒間監視します
28    for ($i = 0; $i < $maxChecks; $i++) {
29        // 現在の接続状態を取得します。
30        // これはビットマスクであり、複数の接続状態が同時に設定される可能性があります。
31        $status = connection_status();
32
33        // 取得した状態が CONNECTION_ABORTED 定数を含んでいるかビット演算子 (&) で確認します。
34        if ($status & CONNECTION_ABORTED) {
35            echo "--- 接続が中断されました (CONNECTION_ABORTED を検出) ---\n";
36            break; // 接続中断を検出したらループを終了します
37        }
38
39        echo "接続はまだアクティブです。 " . ($i + 1) . "秒経過。\n";
40        // 出力をクライアントに即座に送信しようと試みます (バッファリング設定に依存)。
41        // 開発環境によっては効果が見られない場合があります。
42        flush();
43        ob_flush();
44        
45        sleep(1); // 1秒待機します
46    }
47
48    if (!($status & CONNECTION_ABORTED)) {
49        echo "指定時間内に接続中断は検出されませんでした。\n";
50    }
51    echo "スクリプト終了。\n";
52}
53
54// 関数を実行します
55monitorConnectionAbort();
56
57?>

PHPのCONNECTION_ABORTED定数は、ウェブブラウザなどのクライアントとの接続が中断された状態を示す特定の数値を表します。この定数自体に引数や戻り値はありません。提供されたサンプルコードは、PHPスクリプトがクライアントとの接続が切断された後も処理を継続し、その切断を検出する方法を示しています。

スクリプトがクライアントの接続中断後も実行を続けるには、まずignore_user_abort(true)を設定する必要があります。これにより、クライアントがブラウザのタブを閉じるなどしても、PHPスクリプトは強制終了されずに処理を継続できます。次に、connection_status()関数を使用して現在の接続状態を取得します。この関数は、複数の接続状態を同時に表現するビットマスクという形式の数値を返します。

取得した接続状態がCONNECTION_ABORTED定数を含んでいるかどうかは、ビット演算子&を用いてif ($status & CONNECTION_ABORTED)のように確認します。この仕組みにより、スクリプトは接続中断を正確に検出し、それに応じた処理を実行することが可能になります。「connection_aborted not working」という問題は、多くの場合、ignore_user_abort(true)の設定が不足しているか、または接続状態のチェック方法が不適切であることが原因で発生します。このコードは、接続中断を適切に監視し、検出する基本的な手法を提示しています。