International PHP Conference Berlin 2025

    connection_status

    (PHP 4, PHP 5, PHP 7, PHP 8)

    connection_status — 接続ステータスのビットフィールドを返す

    説明

    connection_status(): int

    接続ステータスのビットフィールドを取得します。

    パラメータ

    この関数にはパラメータはありません。

    戻り値

    接続ステータスのビットフィールドを返します。これを定数 CONNECTION_* と比較することで、接続の状態を判断できます。

    参考

    • connection_aborted() - クライアントとの接続が切断されているかどうかを調べる
    • ignore_user_abort() - クライアントの接続が切断された際にスクリプトの実行を終了するかどうかを設定する
    • PHP における接続処理についての説明は 接続処理

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 2 notes

    up
    37
    toppi at kacke dot de
    20 years ago
    Notice !

    if you running a loop (while, foeach etc..) you have to send something to the browser to check the status.

    Example:

    while(1){
    if (connection_status()!=0){
    die;
    }
    }
    doesnt work, if the user break/close the browser.

    But a:

    while(1){
    Echo "\n"; //<-- send this to the client
    if (connection_status()!=0){
    die;
    }
    }
    will work :)

    i hope it will help some of you to safe some time :)

    Toppi
    up
    11
    Anonymous
    5 years ago
    As mentioned, this function returns a status bitfield to which there's a set of constants available. I don't know why those constants aren't actually listed. Although they're easy to guess, I think it's still worth listing them, it is documentation after all. This function has the ability to return integers 0 through 3 so there are 4 possible states.

    The constants are as follows:

    CONNECTION_NORMAL = 0
    CONNECTION_ABORTED = 1
    CONNECTION_TIMEOUT = 2

    As a 4th state is possible and being a bitfield, this gives rise to CONNECTION_ABORTED|CONNECTION_TIMEOUT (or integer 3) can be used to check for aborted+timeout states.
    ＋add a note
    To Top