connection_status

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

connection_status — 返回连接的状态位

说明

connection_status(): int

获得当前连接的状态位。

参数

此函数没有参数。

返回值

获得当前连接的状态位, 可以用于与 CONNECTION_* 常量来确定连接状态。

参见

connection_aborted() - 检查客户端是否已经断开
ignore_user_abort() - 设置客户端断开连接时是否中断脚本的执行
查看连接处理了解PHP处理连接的详情。

改进此页面

了解如何改进此页面 • 提交拉取请求 • 报告一个错误

＋添加备注

用户贡献的备注 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.