|  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Request #39598 error verification after fwrite()
Submitted: 2006-11-22 22:53 UTC Modified: 2019-07-25 09:10 UTC
Avg. Score:4.6 ± 0.7
Reproduced:13 of 13 (100.0%)
Same Version:2 (15.4%)
Same OS:7 (53.8%)
From: max at nucleus dot it Assigned: nikic (profile)
Status: Closed Package: *General Issues
PHP Version: 5.2.0 OS: Linux
Private report: No CVE-ID: None
 [2006-11-22 22:53 UTC] max at nucleus dot it
The documentation states tha fwrite() returns false in 
case of error, but it doesn't do so if the actual write 
For example if I asynchronously write to a pipe (such as 
those obtained by proc_open()) I and the pipe is not ready 
or is broken, fwrite() returns 0.
This could be a correct behaviour it I had a way to 
determine the error.
The problem is that EAGAIN or EPIPE are completely 
impossible to determine and I can't know if I need to wait 
or I have to close the stream.
A possible solution would be to implement ferror() or 

Reproduce code:
$Proc = proc_open($Cmd, $Streams, $Pipes, $CWD, $Env);

stream_set_blocking($Pipes[0], 0);

$Result = fwrite($Pipes[0], "test");

// If $Pipes[0] is not ready to receive data
// $Result is 0, but I can't know why.
// The real code I'm writing involves
// stream_select() and repeated reads and writes
// on multiple pipes.

Expected result:
fwrite() should return 0 when the stream is asynchrounous, 
the C write() returns 0 and errno is EAGAIN.
fwrite() should return false in all other cases where the 
C write() returns 0.

Alternatively a way to access ferror() or errno is needed.


Add a Patch

Pull Requests

Add a Pull Request


AllCommentsChangesGit/SVN commitsRelated reports
 [2013-03-01 00:04 UTC]
Here's a simple reproduce test case:

In this case, and EPIPE occurs. The fwrite call writes 0 bytes. No error code is 
available and no PHP error is raised.
 [2016-01-22 14:04 UTC] salsi at icosaedro dot it
Missing error detection in streams and filters is a general flaw in the internal i/o handling affecting all the related functions (fopen, fread, fwrite, fflush, fclose) which is really severe, because it affects the safety of any file and data transfer, and would deserve maximum attention and urgency for being fix asap. I may list several other reports that demonstrates missing detection of corrupted file system missing detection of invalid encoded data and so on:

fread() does not detect file access error
(Also includes disk image containing a damaged file for testing.)

require* and include* do not detect input/output error
(Probably related to the bug above.)

fread() does not detect decoding errors from filter zlib.inflate
(Probably missing propagation of errors through streams.)

fread() does not detects decoding errors from filter bzip2.decompress
(Probably the same as above.)

All these share the same common denominator: missing error propagation from libc to PHP user's space.
 [2018-06-30 20:24 UTC] novelesco at centrum dot cz
Please, at least fix the documentation.
 [2019-07-25 09:10 UTC]
-Status: Open +Status: Closed -Package: Feature/Change Request +Package: *General Issues -Assigned To: +Assigned To: nikic
 [2019-07-25 09:10 UTC]
In PHP 7.4 fwrite() will return 0 for EAGAIN/EWOULDBLOCK and false for other errors, in line with the requested behavior.
PHP Copyright © 2001-2021 The PHP Group
All rights reserved.
Last updated: Tue Apr 20 10:01:23 2021 UTC