PHP 手册
上一页 |  | 下一页

# socket_listen

(PHP 4 >= 4.1.0, PHP 5)

socket_listen -- Listens for a connection on a socket

## Description

bool socket_listen ( resource socket [, int backlog] )

After the socket `socket` has been created using socket_create() and bound to a name with socket_bind(), it may be told to listen for incoming connections on `socket`.

A maximum of `backlog` incoming connections will be queued for processing. If a connection request arrives with the queue full the client may receive an error with an indication of `ECONNREFUSED`, or, if the underlying protocol supports retransmission, the request may be ignored so that retries may succeed.

> 注意: The maximum number passed to the `backlog` parameter highly depends on the underlying platform. On Linux, it is silently truncated to `SOMAXCONN`. On win32, if passed `SOMAXCONN`, the underlying service provider responsible for the socket will set the backlog to a maximum reasonable value. There is no standard provision to find out the actual backlog value on this platform.

socket_listen() is applicable only to sockets of type `SOCK_STREAM` or `SOCK_SEQPACKET`.

如果成功则返回 `TRUE`，失败则返回 `FALSE`。 The error code can be retrieved with socket_last_error(). This code may be passed to socket_strerror() to get a textual explanation of the error.

See also socket_accept(), socket_bind(), socket_connect(), socket_create() and socket_strerror().

上一页 | 起始页 | 下一页
socket_last_error | 上一级 | socket_read