socket_set_nonblock
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_set_nonblock — Sets nonblocking mode for file descriptor fd
Description
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.
Changelog
Version | Description |
---|---|
8.0.0 |
socket is a Socket instance now;
previously, it was a resource.
|
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
- socket_set_option() - Sets socket options for the socket
- stream_set_blocking() - Set blocking/non-blocking mode on a stream