PHPのconnection_status()関数とは？使い方と戻り値をわかりやすく解説

PHPのconnection_status()関数は、スクリプト実行中のクライアントとの接続状態（コネクションステータス）を取得するための関数です。ユーザーがブラウザを閉じた場合や通信がタイムアウトした場合など、接続の状態をビットフィールドとして返します。

構文

connection_status()

パラメータ

この関数は引数を受け取りません。

戻り値

connection_status()関数は、以下のいずれかの値をステータスビットフィールドとして返します。

• 0 – CONNECTION_NORMAL：接続は正常に動作しています

• 1 – CONNECTION_ABORTED：ユーザーの操作またはネットワークエラーによって接続が中断されました

• 2 – CONNECTION_TIMEOUT：接続がタイムアウトしました

• 3 – CONNECTION_ABORTED & CONNECTION_TIMEOUT：接続の中断とタイムアウトが同時に発生しています

使用例

以下は、connection_status()関数を使って接続状態を判定し、その結果に応じてメッセージを出力するサンプルコードです。

<?php
    switch (connection_status()) {
        case CONNECTION_NORMAL:
            $msg = '接続は正常な状態です！';
            break;
        case CONNECTION_ABORTED:
            $msg = '接続が中断されました！';
            break;
        case CONNECTION_TIMEOUT:
            $msg = '接続がタイムアウトしました！';
            break;
        case (CONNECTION_ABORTED & CONNECTION_TIMEOUT):
            $msg = '接続が中断され、かつタイムアウトしました！';
            break;
        default:
            $msg = 'ステータスは不明です！';
            break;
    }
    echo $msg;
?>

補足ポイント

connection_status()関数は、長時間実行されるバッチ処理やダウンロード配信などで、クライアントがまだ接続しているかどうかを確認したい場面で特に役立ちます。また、ignore_user_abort(true)を設定していない場合、ユーザーが接続を切断するとスクリプト自体が終了するため、実際の運用では両者を組み合わせて使うことが一般的です。