(PHP 4 >= 4.1.0)
socket_accept -- Accepts a connection on a socket
Description
int socket_accept (resource socket)
| Warning |
|
This function is EXPERIMENTAL. The behaviour of this function, the name of this
function, and anything else documented about this function may change in a future release of PHP
without notice. Be warned and use this function at your own risk.
|
After the socket socket has been created using socket_create(), bound to a name with socket_bind(), and told to listen for connections with socket_listen(), this function will accept incoming
connections on that socket. Once a successful connection is made, a new socket descriptor is
returned, which may be used for communication. If there are multiple connections queued on the
socket, the first will be used. If there are no pending connections, socket_accept() will
block until a connection becomes present. If socket has been made non-blocking
using socket_set_blocking() or socket_set_nonblock(), an error code will be
returned.
The socket descriptor returned by socket_accept() may not be used to accept new
connections. The original listening socket socket, however, remains open and may be
reused.
Returns a new socket descriptor on success, or a negative error code on failure. This code
may be passed to socket_strerror() to get a
textual explanation of the error.
See also socket_bind(), socket_connect(),
socket_listen(), socket_create(), socket_get_status(), and socket_strerror().
|
