socket_set_nonblock
(PHP 4 >= 4.1.0, PHP 5)
socket_set_nonblock — Sets nonblocking mode for file descriptor fd
Description
$socket
)
The socket_set_nonblock() function sets the
O_NONBLOCK
flag on the socket specified by
the socket
parameter.
When an operation (e.g. receive, send, connect, accept, ...) is performed on a non-blocking socket, the script will not pause its execution until it receives a signal or it can perform the operation. Rather, if the operation would result in a block, the called function will fail.
Return Values
Returns TRUE
on success or FALSE
on failure.
Examples
Example #1 socket_set_nonblock() example
<?php
$socket = socket_create_listen(1223);
socket_set_nonblock($socket);
socket_accept($socket);
?>
This example creates a listening socket on all interfaces on port 1223 and
sets the socket to O_NONBLOCK
mode.
socket_accept() will immediately fail unless there is a
pending connection exactly at this moment.
See Also
- socket_set_block() - Sets blocking mode on a socket resource
- socket_set_option() - Sets socket options for the socket
- socket_accept
- socket_bind
- socket_clear_error
- socket_close
- socket_cmsg_space
- socket_connect
- socket_create_listen
- socket_create_pair
- socket_create
- socket_get_option
- socket_getopt
- socket_getpeername
- socket_getsockname
- socket_import_stream
- socket_last_error
- socket_listen
- socket_read
- socket_recv
- socket_recvfrom
- socket_recvmsg
- socket_select
- socket_send
- socket_sendmsg
- socket_sendto
- socket_set_block
- socket_set_nonblock
- socket_set_option
- socket_setopt
- socket_shutdown
- socket_strerror
- socket_write
Коментарии
Beware, when using this function within a loop (i.e. a demon with a socket). The socket_accept(), for example, emits a warning each time there is no incoming connection available to be read. My php error log file got huge in a matter of seconds, eventually crashing the server.
Of course, i used the @ before the function to take care of that problem.
[EDITOR: One can (and should) use socket_select to detect a new connection on a socket (it's a "readable" event)]