connection_status

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

connection_status — Returns connection status bitfield

Descrizione

connection_status(): int

Gets the connection status bitfield.

Elenco dei parametri

Questa funzione non contiene parametri.

Valori restituiti

Returns the connection status bitfield, which can be used against the CONNECTION_* constants to determine the connection status.

Vedere anche:

connection_aborted() - Check whether client disconnected
ignore_user_abort() - Set whether a client disconnect should abort script execution
Connection Handling for a complete description of connection handling in PHP.

Improve This Page

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

＋add a note

User Contributed Notes 2 notes

down

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

down

Anonymous ¶

4 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