在线文档教程
PHP
联网 | Networking

socket_set_nonblock

socket_set_nonblock

(PHP 4 >= 4.1.0, PHP 5, PHP 7)

socket_set_nonblock — Sets nonblocking mode for file descriptor fd

Description

bool socket_set_nonblock ( resource $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.

Parameters

socket

A valid socket resource created with socket_create() or socket_accept().

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

  • stream_set_blocking() - Set blocking/non-blocking mode on a stream

← socket_set_block

socket_set_option →

© 1997–2017 The PHP Documentation Group

Licensed under the Creative Commons Attribution License v3.0 or later.

https://secure.php.net/manual/en/function.socket-set-nonblock.php