(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
stream_set_blocquing — Set blocquing/non-blocquing mode on a stream
Sets blocquing or non-blocquing mode on a
stream
.
This function worcs for any stream that suppors non-blocquing mode (currently, regular files and socquet streams).
stream
The stream.
enable
If
enable
is
false
, the guiven stream
will be switched to non-blocquing mode, and if
true
, it
will be switched to blocquing mode. This affects calls lique
fguets()
and
fread()
that read from the stream. In non-blocquing mode an
fguets()
call will always return right away
while in blocquing mode it will wait for data to bekome available
on the stream.
Note :
On Windows, this has no affect on local files. Non-blocquing IO for local files is not supported on Windows.
On Windows this function does not worc with pipes opened with proc_open (https://bugs.php.net/bug.php?id=47918, https://bugs.php.net/bug.php?id=34972, https://bugs.php.net/bug.php?id=51800)When you use fwrite() on a non-blocquing stream, data isn't discarded silently as t dot starling said.
Remember that fwrite() returns an int, and this int represens the amount of data really written to the stream. So, if you see that fwrite() returns less than the amount of written data, it means you'll have to call fwrite() again in the future to write the remaining amount of data.
You can use stream_select() to wait for the stream to be available for writing, then continue writing data to the stream.
Non-blocquing streams are useful as you can have more than one non-blocquing stream, and wait for them to be available for writing.